template-asciidoctor-dockerized

Github

Génération de slides, pdf, ebook, docx à l’aide de Asciidoctor, RevealJs et Docker Compose.

Ce dépôt a été généré à partir du template : github.com/baldir-fr/template-asciidoctor-dockerized

Documents générés

• Slides générées au format HTML

• Pdf

• Ebook

• Docbook

• Docx

Écrire du contenu

Modifier les fichiers présents dans _content/.

Voir la section Ressources Asciidoctor complémentaires pour démarrer avec Asciidoctor et RevealJs.

Ressources Asciidoctor complémentaires

readme/ressources-asciidoctor-complementaires.adoc

Génération du contenu

Pré-requis pour construire les exemples

• Docker Engine 19.03.0+

• Docker compose

Optionnel

• GNU Make

Génération des slides

docker compose run --rm build-slides
# Ou avec GNU Make
make dc-slides

Génération du Pdf

docker compose run --rm build-slides; rm -rf docs/assets;cp -r _content/assets docs/
# Ou avec GNU Make
make dc-pdf

Génération de l’E-book

docker compose run --rm build-epub
# Ou avec GNU Make
make dc-epub

Génération du docbook

docker compose run --rm build-docbook
# Ou avec GNU Make
make dc-docbook

Génération docx

Prérequis

Warning

Sur  macOS (M1), l’image Docker n’étant pas optimisée pour linux/arm64/v8, Docker requiert au moins 6.5 Go de RAM allouée (et 7.25 Go de RAM pour des performances convenables). Sans cette configuration, la commande échoue avec le message Killed. Il reste préférable de lancer la commande pandoc native qui donne des performances en dessous de la seconde (installation : brew install pandoc) readme/docx-docker-macos-m1-benchmark.adoc

Après avoir généré le docbook

# Avec docker installé
docker compose run --rm build-docx
# Ou avec GNU Make
make dc-docx

# Avec pandoc installé localement (à privilégier sur macOS M1)
./generate-docx.sh
# Ou avec GNU Make
make docx

Déploiement

readme/deploiement.adoc