Je recherche un outil ou un script pour convertir les fichiers Markdown au format Dokuwiki , qui s'exécutera sur un PC.
C'est pour que je puisse utiliser MarkdownPad sur un PC pour créer des ébauches initiales de documents, puis les convertir au format Dokuwiki, pour les télécharger vers une installation Dokuwiki sur laquelle je n'ai aucun contrôle. (Cela signifie que le plugin Markdown ne me sert à rien.)
Je pourrais passer du temps à écrire un script Python pour faire la conversion moi-même, mais j'aimerais éviter d'y passer du temps, si une telle chose existe déjà.
Les balises Markdown que j'aimerais avoir prises en charge / converties sont:
- Niveaux de titre 1 - 5
- Gras, italique, souligné, police à largeur fixe
- Listes numérotées et non numérotées
- Hyperliens
- Règles horizontales
Existe-t-il un tel outil ou existe-t-il un bon point de départ?
Choses que j'ai trouvées et considérées
Au début, je pensais que txt2tags serait utile, mais bien qu'il puisse écrire à la fois markdown et Dokuwiki, il est très lié à son propre format d'entrée spécifique
J'ai également vu Markdown2Dokuwiki , et bien que je serais certainement prêt à utiliser un script sed, même sur un PC, cela ne prend en charge qu'une toute petite partie de la syntaxe de Markdown.
python-markdown2 semblait également prometteur, mais il n'écrit que du HTML.
MultiMarkdown - ne semble pas prendre en charge la sortie Dokuwiki
la source
Réponses:
Stop-Press - Août 2014
Depuis Pandoc 1.13 , Pandoc contient maintenant mon implémentation de l'écriture DokuWiki - et beaucoup plus de fonctionnalités y sont implémentées que dans ce script. Donc, ce script est maintenant à peu près redondant.
Après avoir dit à l'origine que je ne voulais pas écrire de script Python pour effectuer la conversion, j'ai fini par faire exactement cela.
La véritable économie de temps a été d'utiliser Pandoc pour analyser le texte Markdown et écrire une représentation JSON du document. Ce fichier JSON était alors assez facile à analyser et à écrire au format DokuWiki.
Ci-dessous se trouve le script, qui implémente les morceaux de Markdown et DokuWiki qui m'intéressaient - et quelques autres. (Je n'ai pas téléchargé la suite de tests correspondante que j'ai écrite)
Conditions requises pour l'utiliser:
J'espère que cela fera gagner du temps à quelqu'un d'autre ...
Edit 2 : 2013-06-26: J'ai maintenant mis ce code dans GitHub, à https://github.com/claremacrae/markdown_to_dokuwiki.py . Notez que le code ajoute la prise en charge de plus de formats et contient également une suite de tests.
Édition 1 : ajustée pour ajouter du code pour analyser des exemples de code dans le style de backtick de Markdown:
la source
Il s'agit d'une approche alternative que j'ai utilisée récemment.
Ses avantages sont:
La recette:
Ouvrez le fichier Markdown dans MarkdownPad 2
Sélectionnez Edition -> "Copier le document au format HTML"
Exécutez Html2DokuWiki
Collez le code HTML dans le volet supérieur "Entrée HTML"
la source
Pas une solution idéale, mais fonctionnelle
Markdown -> HTML -> Dokuwiki
Première conversion effectuée par pandoc
Deuxième module HTML-WikiConverter-DokuWiki Perl
Astuce: Inverser les actions du code existant
silverstripe-doc-restructuration git-repo contient du code (PHP) pour la conversion de Dokuwiki en Markdown
la source