Voici une liste de 6 plug-ins Atom à posséder : Atom-beautify : formateur et coloration syntaxique de code HTML, CSS, JavaScript, PHP, Python, Ruby, Java, C, C++, C#, Objective-C, CoffeeScript, TypeScript, Coldfusion, SQL et plus…
Minimap : affiche une vue condensée de votre fichier (sur la gauche de l’image si dessous). Cella permet d’avoir une vue d’ensemble, d’améliorer la navigation.
Highlight Selected : comme sous Notepad++, lorsque vous sélectionnez un mot, ce plug-in sélectionne tous les mots identiques. Si vous utilisez Minimap, installer aussi minimap-highlight-selected pour l’avoir dans sa vue.
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, EmacsOrg–Mode, Txt2Tags, Microsoft Word docx, LibreOffice ODT, EPUB, Haddockmarkup
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 : InDesignICML
Formats « outline »: OPML
Format à base de TeX : LaTeX, ConTeXt, LaTeXBeamer slides
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 :
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 » :
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 :
Utiliser une police « monospace » (non proportionnel) afin d’offrir une plus grande lisibilité de votre code.
Utiliser une taille de police grosse, afin que les personnes les plus éloignées puissent lire sur l’écran.
Colorer votre code source et mettre en fantôme (grisé) le code sans importance.
Utiliser les trois petits points « … » pour sauter des parties de code qui ne servent à rien dans votre discussion.
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.
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 !