Auteur : piradix

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

 

Comment présenter son code dans des diapos (slides)

Vous aller devoir faire une présentation de votre code, quelles sont les règles essentielles pour que votre auditoire le savoure 😉

Les 6 points à respecter :

  1. Utiliser une police « monospace » (non proportionnel) afin d’offrir une plus grande lisibilité de votre code.
  2. Utiliser une taille de police grosse, afin que les personnes les plus éloignées puissent lire sur l’écran.
  3. Colorer votre code source et mettre en fantôme (grisé) le code sans importance.
  4. Utiliser les trois petits points « … » pour sauter des parties de code qui ne servent à rien dans votre discussion.
  5. Utiliser des annotations (flèche, cadre…) pour attirer l’attention sur un élément. Car si vous penser utiliser le pointeur laser, sachez qu’il n’est pas très visible, petit et vous devez cibler l’écran tout en parlant.
  6. Une animation courte (Gif animés) entre deux chapitres de vos diapos, permettent de détendre l’atmosphère.
    Attention au droit d’auteur lors d’utilisation d’image et vidéo !

Sources :

Vous trouverez des animations sur :

Les 5 premiers points de cet article sont grandement inspirés de la présentation (en anglais) suivante :

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

Un Terminal Bash sous Eclipse Windows 10 Pro

Depuis que Microsoft à incorporé un Bash (Linux Ubuntu) nativement dans la version Pro de Windows 10, il nous manquait son intégration dans Eclipse. Problème résolu grâce au plug-in « TM Terminal« .

Le plug-in « Tm Terminal » de la fondation Eclipse permet de lancer dans une vue avec un terminal de votre choix :

  • ligne de commande Windows « cmd.exe »
  • Bash GIT
  • et tout autre terminal que vous configurez dont le Bash (Ubuntu) de Windows 10 :

Vous le trouverez chez Eclipse Market :

Par défaut le plug-in n’est pas configuré pour le « Bash Ubuntu Windows« , il faut l’ajouter.

Pour installer le plug-in déplacer le l’icône suivant dans Eclipse et suivez les instructions :
Drag to your running Eclipse workspace.

  • une fois le plug-in installer aller dans le menu « Préférence/Terminal » :
  • cliquez sur « Add »
  • écrivez « Bash » dans le chemin « Name »
  • dans le champ « Path » saisissez « C:\Windows\System32\bash.exe »
  • puis cliquez sur « Ok »

Pour lancer le terminal taper sur « Ctrl+Alt+Shitf+T » puis choisissez « Bash » :

Et voilà :

 

 

Créer localement un docset Aurelia pour Zeal (gestionnaire offline de doc)

Zeal est une application Linux, Windows permettant de regrouper localement des documentations techniques telles que HTTP, CSS, HTML, Java, Reactjs ... Ainsi plus besoin de ce connecter sur le Web (on a pas toujours accès à internet ;-)
Bien que sa bibliothèque soit bien fournie (195 documentations), elle ne contient pas la documentation d'Aurelia (Aurelia.io).
Cependant, il existe un moyen de créer sa propre documentation Aurelia pour Zeal.

Lire la suite