baldir-fr / template-asciidoctor-dockerized

Template de présentation Asciidoctor dockerisée

template-asciidoctor-dockerized

Github
Gitlab

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

Ou asciidoctor installé localement. Aperçu de commandes pour installer certains des outils.

# Requiert ruby 2.7 ou supérieur
gem install asciidoctor
gem install asciidoctor-pdf
gem install asciidoctor-diagram
brew install cmake
gem install asciidoctor-epub3
gem install asciidoctor-mathematical
gem install asciidoctor-revealjs
gem install asciimath
gem install asciidoctor-bibtex
gem install asciidoctor-kroki
gem install asciidoctor-reducer

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