Étiquette : Asciidoc

Convertir un document Asciidoc en OpenDocument (ODF, LibreOffice) avec Pandoc

Nativement, Asciidoc ne permet pas de convertir son format en un document OpenDocument (fichier ODF, LibreOffice). Cependant il est possible de lui adjoindre un outil tiers pour l’aider : Pandoc.

Pandoc se veux être un convertisseur universel. Il permet de convertir les formats de fichiers suivants :

markdown, reStructuredText, textile, HTML, DocBook, LaTeX, MediaWiki markup, TWiki markup, OPML, Emacs OrgMode, Txt2Tags, Microsoft Word docx, LibreOffice ODT, EPUB, Haddock markup

dans les formats suivants :

  • Formats à base de HTML : XHTML, HTML5, and HTML slide shows using Slidy, reveal.js, Slideous, S5, ou DZSlides.
  • Traitement de texte : Microsoft Word docx, OpenOffice/LibreOffice ODT, OpenDocument XML
  • Ebooks : EPUB version 2 or 3, FictionBook2
  • DocBook, TEI Simple, GNU TexInfo, Groff man (les pages man d’Unix), Haddock
  • Format de Mise en page : InDesign ICML
  • Formats « outline »: OPML
  • Format à base de TeX : LaTeX, ConTeXt, LaTeX Beamer slides
  • PDF au travers de LaTeX
  • Formats « markup » : Markdown, reStructuredText, AsciiDoc, MediaWiki, DokuWiki, Emacs Org-Mode, Textile
  • Votre propre format en utilisant le langage « lua« .

Vous trouverez Pandoc sur le site (en anglais) : http://pandoc.org/

Installer et utiliser Pandoc pour convertir de l’Asciidoc en ODF

Si vous êtes sous Windows 10, les directives suivantes sont identiques à un environnement Linux, à condition de le faire depuis le « Bash Window  Unbutu« . Donc depuis un Bash faire :

  • Installer Asciidoctor :
sudo apt-get install ascidoctor
  • Installer Pandoc :
sudo apt-get install pandoc
  • Convertir le document Asciidoc (ici « test.adoc ») en HTML ( « test.html » ) par :
asciidoctor -b html test.adoc  -o test.html

Puis convertir le document HTML (text.html) en ODF (test.odf) par :

pandoc  --base-header-level=3 -V date:"" -V title:"" -f html test.html -o test.odt

Si vous êtes sous Windows 10 et sur une version d’avant l’été 2017 (oui c’est la version standard actuelle Févr. 2017, sinon vous seriez sur une version Insider), la ligne de commande précédente génère une erreur : « pandoc: timer_create: Function not implemented« .
Pour l’éviter ajouter les options suivantes : « +RTS -V0 -RTS » :

pandoc +RTS -V0 -RTS --base-header-level=3 -V date:"" -V title:"" -f html test.html -o test.odt

ou avant de lancer Pandoc, exécuter la ligne suivante:

export GHCRTS=-V0

 

Convertir un document Asciidoc en PDF : Asciidoc-pdf

Sous Linux et Windows 10, il existe plusieurs outils de conversions d'un document Asciidoc en PDF.

Le plus simple est d'utiliser l'éditeur AsciidocFX qui à un icône pour sauver en PDF. Mais vous ne pouvez pas automatiser la tâche au travers de ligne de commande.
Et la configuration du format du fichier de sortie n'est pas du tout aisée (fichier XML, manque de documentation).

Une autre solution est d'installer "Asciidoctor PDF" ...

Lire la suite

Éditeurs Asciidoc

Asciidoc est un langage de formatage de texte (comme markdown), permettant de générer des formats de fichier html, pdf, MS word,epub, docbook, tex.Un de ces objectifs est d’être lisible, même sans visionneuse. Un simple éditeur texte suffit pour l’utiliser. Mais un éditeur ayant des fonctions avancé (syntaxe colorée en autre) est un plus.

Pour ma part je l’utilise, pour écrire des notes, et de la documentation applicatives. À ce titre j’utilise plusieurs éditeurs.

Les éditeurs :

AsciidoFX (Linux, Windows, OsX, Java)

Il peut être considéré comme l’éditeur AsciiDoc.
asciidocFX
Il est écrit en Java et peut donc fonctionner sur tout système d’exploitation (Windows, Mac, Linux, …) supportant Java 8 .

Ses particularités sont

  • affiche une prévisualisation HTML en temps réel.
  • Coloration syntaxique.
  • Icônes de raccourcie tel que gras, tableau…
  • Affiche la « table des matières » (« outline ») de votre document sur la gauche. Très utile pour se repérer.
  • ergonome
  • agréable
  • possibilité de modifier les thèmes de génération des documents
  • Supporte d’office les formats de sortie HTML,PDF,DocBook, odt (Libre office), Ebook, Un clique sur un bouton et hop, vous pouvez donner vos notes, doc à vos clients ou collaborateurs.
  • supporte d’autres formats dont markdown
  • Libre d’usage. Un don est apprécié.

Deux petites remarques :

  • il est en Anglais
  • Et a mon gout il est un peut lent a ce lancer (même sur un config puissant, peut être à cause de l’antivirus), il met 6 secondes.
    Mais c’est l’éditeur que j’utilise le plus.

Site web (Anglais) : http://asciidocfx.com/

Sources : https://github.com/asciidocfx

NotePad++ (Windows)

C’est un éditeur de texte pur.
Notepad++
Il n’est pas dédié à Asciidoc et ne possède pas de mode de prévisualisation .
Localisé en Français et autre langue.
Fonctionne que sous Windows. Sources accessible, libre d’usage, Licence GNU.
Son avantage est sa légèreté et sa rapidité (c’est le meilleur de tous les éditeurs à ce niveau).
Il est possible de lui adjoindre la syntaxe colorée en important (menu « Langage/Définissez votre langage », puis bouton « importer » ) le fichier de définition suivant :

Si vous ne le trouvez pas, allez voir sur :

Sites web (français,anglais,chinois): https://notepad-plus-plus.org/

Emacs (Linux, Windows, OsX)

Éditeur Unix apprécier de ces détracteurs. En général ceux qui aime Emacs, n’aiment pas VI/VIM.
C’est l’éditeur ultime. Il possède le mode d’enregistrement de macro ultime (c’est mon avis).
En Anglais et fonctionne sous Windows, Mac, Linux. Sources accessible, libre d’usage, Licence GNU.
Il possède un mode AsciiDoc que vous trouverez sur le site :

https://www.emacswiki.org/emacs/AsciiDoc

VIM (Linux, Windows, OsX)

Éditeur Unix lège apprécier de ces détracteurs. Un peu dure à utiliser les premières fois.
En Anglais et fonctionne sous Windows, Mac, Linux. Sources accessible, libre d’usage, Licence GNU.
Il possède un mode AsciiDoc que vous trouverez sur le site :

gedit (Linux)

Éditeur texte sous Linux.
En anglais et fonctionne sous Linux. Sources accessible, libre d’usage, Licence GNU.
Il est possible de lui adjoindre la syntaxe colorée et un mode de prévisualisation :

AsciidocLive

C’est un site web (Anglais) qui propose un éditeur en ligne temps réel, avec prévisualisation.

asciidocLive

Site web : https://asciidoclive.com/edit/scratch/1

Ressources

Vous trouverez le convertisseur AsciiDoc ainsi que sa documentation anglaise sur le site :

Site web : http://www.methods.co.nz/asciidoc/