Différences

Ci-dessous, les différences entre deux révisions de la page.

--- prog:asciidoc [2020/06/03 15:54] – Ajout de l'attribut "last-update-label" root
+++ prog:asciidoc [2021/05/02 00:20] (Version actuelle) – Ajout de "highlight.js" root
@@ Ligne 15: / Ligne 15: @@
   docker pull asciidoctor/docker-asciidoctor
+Pour exécuter une convertion, on lance docker puis asciidoctor.
+  docker run -v <your directory>:/documents/ --name asciidoc-to-html asciidoctor/docker-asciidoctor
+  asciidoctor -D /documents/output --out-file=specifications.fr.html doc/specifications/readme.fr.asciidoc
 ====Editeur====
-Utiliser une interface graphique avec Brackets :
+Utiliser une interface graphique avec [[prog:vsc|Visual Studio Code]] :
-  * Installer [[http://brackets.io/|Brackets]]
+  * Installer [[https://code.visualstudio.com/download/|Visual Studio Code]]
-  * Installer l'extension (l'icône est en haut à gauche) [[https://github.com/asciidoctor/brackets-asciidoc-preview|AsciiDoc Live Preview]]
+  * Installer l'extension depuis [[https://marketplace.visualstudio.com/items?itemName=asciidoctor.asciidoctor-vscode|Visual Studio Code]] [[https://github.com/asciidoctor/asciidoctor-vscode|Source github]]
   * Installer et exécuter [[https://github.com/plantuml/plantuml-server|PlantUML Server]] via Docker : ''docker run -d -p 8080:8080 plantuml/plantuml-server:tomcat''
-  * Dans Brackets, cliquer sur la roue dentée qui apparaît quand la souris passe sur la Preview. Et régler l'URL à ''http://localhost:8080''
+  * Configurer le module pour utiliser plantuml : éditer les préférences utilisateurs et ajouter :
+<code javascript>
+    "asciidoc.preview.attributes": {
+        "plantuml-server-url": "http://localhost:8080"
+    }
+</code>
+  * Activer l'aperçu via ''ctrl+shift+v''.
+====Traduction====
+Cela se fait avec le paquet [[prog:po4a|po4a]].
+  * Création du fichier de traduction
+Utiliser le code de langage conformément à la norme ISO 639.
+  po4a-gettextize -f asciidoc -m documentation.asciidoc -p documentation_fr-FR.po
+  * Traduire la documentation
+On peut utiliser [[prog:poedit|poedit]]
+  * Création du fichier
+  po4a-translate -f asciidoc -m documentation.asciidoc -p documentation_fr-FR.po -l documentation_fr-FR.asciidoc -k 0
+  * Mettre à jour le fichier de traduction suite à la mise à jour de la documentation
+  po4a-updatepo -f asciidoc -m documentation.asciidoc -p documentation_fr-FR.asciidoc
 ====Travis====
@@ Ligne 33: / Ligne 65: @@
 ====Attributs====
+===HTML===
   :last-update-label!:
 Désactive la génération de la date lors du rendu HTML. Intéressant pour faire un diff sans se préoccuper de ce paramètre.
+===Coloration syntaxique===
+Utilise [[https://highlightjs.org/|highlight.js]].
+  * Exemple
+<code>
+:source-highlighter: highlight.js
+:highlightjsdir: highlight
+[source,sh]
+----
+mkdir build
+----
+</code>
+  * Compilation
+Ici, on ne compile que le langage ''bash'' et ''cpp''.
+<code bash>
+git clone --depth=1 https://github.com/highlightjs/highlight.js.git
+cd highlightjs
+node tools/build.js -t browser cpp bash
+</code>
+''highlight.min.js'' est dans le dossier ''build''.
+Ensuite, il faut garder l'architecture suivante à coté du fichier HTML généré :
+<code>
++highlight
+   |highlight.min.js
+   +styles
+      |github.min.css
+</code>
+Pour le style, il faut prendre l'un des fichiers dans ''highlight.js\build\demo\styles'' et impérativement lui dossier le nom de fichier ''github.min.css''.