When one teach, two learn
— Robert Heinlein

1. Redaction documentaire

1.1. Constat

  • Penible

  • Indispensable

1.2. Outils

  • WYSIWYG ou presque (Word, OpenOffice, etc…​)

  • Markdown

  • Latex

2. Installation

2.1. Prerequis

  • Python 2.7

  • Sourceforge

2.2. Utilisation

  • faire un alias

    alias ascdoc="/cygdrive/c/Python27/python.exe C:/Tools/asciidoc-8.6.9/asciidoc.py"

  • exemple

    ascdoc -d article -b slidy test.adoc

3. Un exemple

Asciidoc(tor)
=============
Collonville Thomas
Version 0.1.0-SNAPSHOT, 13/11/2018

:sectnums:
:toc:
:toclevels: 4
:toc-title: Plan
:description: Document de presentation de Asciidoc
:keywords: AsciiDoc
:imagesdir: ./img

[quote, Robert Heinlein]
When one teach, two learn

Redaction documentaire
----------------------
Constat
~~~~~~~
* Penible
* Indispensable

Outils
~~~~~~
* WYSIWYG ou presque (Word, OpenOffice, etc...)
* Markdown
* Latex

4. Un autre

= Asciidoc(tor)
Collonville Thomas
Version 0.1.0-SNAPSHOT, 13/11/2018

:sectnums:
:toc:
:toclevels: 4
:toc-title: Plan
:description: Document de presentation de Asciidoc
:keywords: AsciiDoc
:imagesdir: ./img

[quote, Robert Heinlein]
When one teach, two learn

== Redaction documentaire
===Constat

* Penible
* Indispensable

===Outils
* WYSIWYG ou presque (Word, OpenOffice, etc...)
* Markdown
* Latex

5. Un peu de syntaxe

  • Asciidoc est souple et accepte differents type de syntaxe

  • Chapitre et section → voir exemple precedent

  • mise en forme liste telle que:

* *en gras*
* _emphasis_
* `mono`

  • en gras

  • emphasis

  • mono

6. Encore peu de syntaxe

6.1. Importation de code sources

  • (sans le #)

#include::src/source.java[]

  • Resultat

package listener

7. Encore peu de syntaxe

7.1. Importation d'images

image::MagrittePipe.jpg[La Trahison des images, René Magritte]
La Trahison des images - René Magritte