Comment utiliser Perl Text-MediawikiFormat pour convertir mediawiki en xhtml?

Question

Sur une plate-forme Ubuntu, j'ai installé le petit script perl belle

libtext-mediawikiformat-perl - Convert Mediawiki markup into other text formats 

qui est disponible on cpan. Je ne connais pas perl et je n'ai aucune idée de la façon d'utiliser cette bibliothèque pour écrire un script perl qui convertirait un fichier mediawiki en fichier html. par exemple. Je voudrais avoir juste un script que je peux courir, comme

./my_convert_script input.wiki > output.html 

(spécifiant peut-être aussi l'url de base, etc.), mais ont aucune idée où commencer. Aucune suggestion?

Answer 1

La bibliothèque Perl Text::MediawikiFormat n'est pas vraiment destinée à une utilisation autonome, mais plutôt comme un moteur de formatage dans une application plus grande.

Le documentation at CPAN indique réellement comment utiliser cette bibliothèque, et note que d'autres modules peuvent mieux prendre en charge les conversions uniques.

Vous pouvez essayer (non testé) un revêtement

perl -MText::MediawikiFormat -e'$/=undef; print Text::MediawikiFormat::format(<>)' input.wiki >output.html 

bien qui défie toute la question (et les capacités de personnalisation) de ce module.

Je suis sûr que quelqu'un a déjà trouvé une meilleure façon de convertir des fichiers MediaWiki uniques, alors voici un list of alternative MediaWiki processors sur le site mediawiki. Ce SO question peut aussi être utile.

D'autres langages de balisage, tels que Markdown, offrent une meilleure prise en charge des conversions de fichiers uniques. Markdown est particulièrement bien adapté pour les documents techniques et les miroirs des conventions e-mail. (En outre, il est utilisé sur ce site.)

---

Les libfoo-bar-perl paquets dans les dépôts Ubuntu sont précompilés modules Perl. Habituellement, ceux-ci seraient installés via cpan ou cpanm. Bien que certaines de ces bibliothèques incluent des scripts, la plupart ne le font pas et ne sont pas conçues comme des applications autonomes.

Answer 2

Je crois que @amon est correct que la bibliothèque perl que je référence dans la question n'est pas le bon outil pour la tâche que j'ai proposée.

J'ai fini par utiliser le mediawiki API avec l'action = "parse" pour convertir en HTML en utilisant le moteur mediawiki, qui s'est avéré être beaucoup plus fiable que tous les autres parseurs que j'ai essayés proposed on the list. (J'ai ensuite utilisé pandoc pour convertir mon HTML en markdown.) L'API mediawiki gère aussi l'extraction de catégories et d'autres métadonnées, et j'ai juste dû ajouter l'URL de base à l'image interne et aux liens de pages. Etant donné le titre de la page et l'URL de base, j'ai fini par écrire ceci comme une fonction R.

wiki_parse <- function(page, baseurl, format="json", ...){ 
    require(httr) 
    action = "parse" 
    addr <- paste(baseurl, "/api.php?format=", format, "&action=", action, "&page=", page, sep="") 
    config <- c(add_headers("User-Agent" = "rwiki"), ...) 
    out <- GET(addr, config=config) 
    parsed_content(out) 
}