BROADCASTS.com

Published: April 5, 2016, 7:55 a.m.

b'

Dans cet \\xe9pisode, Maxime et Guillaume discutent des langages de markup - en particulier Asciidoctor - pour l\\u2019\\xe9criture de documentation. Quels sont leurs b\\xe9n\\xe9fices, quels outils et flux de travail adopter ? On y aborde ces questions.

\\n

Enregistr\\xe9 le 31 mars 2016

\\n

T\\xe9l\\xe9chargement de l\\u2019\\xe9pisode\\xa0LesCastCodeurs-Episode\\u2013144.mp3

\\n

Interview

\\n

Ta vie, ton oeuvre

\\n

Maxime Gr\\xe9au
@mgreau
eXo Platform

\\n

Guillaume Scheibel
@g_scheibel
Expedia

\\n

Markup et documentation

\\n

Qu\\u2019est-ce qu\\u2019un langage de markup ?
Pourquoi est-ce mieux, quels sont les avantages ?

\\n

HTML
XML

\\n

AsciiDoc / Asciidoctor

\\n

LaTeX
Docbook

\\n

Qu\\u2019est-ce qu\\u2019AsciiDoc ?
Quelles sont ses caract\\xe9ristiques uniques
Qu\\u2019est-ce qu\\u2019Asciidoctor ?

\\n

AsciiDoc
Asciidoctor

\\n

Comparaison avec Markdown
Comparaison avec Docbook

\\n

Markdown
WYSIWYG

\\n

Une id\\xe9e par ligne
Une id\\xe9e par ligne - le retour d\\u2019exp\\xe9rience

\\n

En pratique

\\n

Qu\\u2019est-ce que j\\u2019installe ?

\\n

Un blog en Fran\\xe7ais d\\xe9crivant tous les outils pour d\\xe9buter

\\n

Google Chrome plugin: Asciidoctor.js Live Preview
Firefox plugin: Asciidoctor.ja Live Preview
Asciidoctor Gist

\\n

Conteneur Docker pour Asciidoctor
Maven Plugin
Gradle Plugin
Ant Task

\\n

Comment j\\u2019apprends ?

\\n

Documentation Asciidoctor
L\\u2019antis\\xe8che
La bible
Comparaison AsciiDoc vs Markdown par l\\u2019\\xe9quipe Asciidoctor

\\n

Comment est-ce que j\\u2019\\xe9dite ?
Les \\xe9diteurs disponibles
La boucle de retour \\xe9criture / visualisation (locale ou en ligne)

\\n

Atom
Bracket
IntelliJ Eclipse
Vim folding

\\n

Convertir sa documentation existante

\\n

DocbookRx (docbook vers AsciiDoc)
docbook2asciidoc (Docbook vers AsciiDoc) via XSLT
Kramdown pour AsciiDoc
Markdown to AsciiDoc
Pandoc
Google Docs vers AsciiDoc

\\n

Comment g\\xe9rer les modifications concurrentes et les commentaires (\\xe0 la Microsoft Word et LibreOffice)

\\n

\\xc9crire de la documentation

\\n

Quels sont les avantages
Comment convaincre les non d\\xe9veloppeurs d\\u2019utiliser Asciidoctor ?
La composition et la r\\xe9utilisation de morceaux de documentation

\\n

Les autres cas d\\u2019utilisation

\\n

\\xc9crire un livre

\\n

Ecrire un livre en AsciiDoc avec InfoQ
Enterprise Web Development: From Desktop to Mobile \\xe9crit en AsciiDoc avec O\\u2019Reilly - source du livre en AsciiDoc
Pro Git v2 (FR) - source du livre en AsciiDoc

\\n

Un blog

\\n

HubPress.io
Jeckyll AsciiDoc plugin et son quickstart
Le code du site web hibernate.org
Le code du blog de l\\u2019\\xe9quipe Hibernate

\\n

Les pr\\xe9sentations

\\n

reveal.js avec Asciidoctor
dzslides avec Asciidoctor
deckjs avec Asciidoctor
Bespoke avec Asciidoctor

\\n

Exemple de pr\\xe9sentation de Maxime en dzslides + Asciidoctor - source

\\n

Quelques points pr\\xe9cis

\\n

Les additions (formules math\\xe9matiques, sch\\xe9mas, etc)
Les diagrammes

\\n

Comment contribuer

\\n

Communaut\\xe9 fran\\xe7aise importante
Compte Github

\\n

\\n
• Ruby -> core
\\n
• Java -> asciidoctorJ wrapper via JRuby
\\n
• Javascript -> asciidoctor.js
\\n
• CoffeeScript -> plugin Atom
\\n

\\n

Nous contacter

\\n

Contactez-nous via twitter https://twitter.com/lescastcodeurs
sur le groupe Google https://groups.google.com/group/lescastcodeurs
ou sur le site web https://lescastcodeurs.com/
Flattr-ez nous (dons) sur https://lescastcodeurs.com/
En savoir plus sur le sponsoring? sponsors@lescastcodeurs.com

'