Pour tout problème contactez-nous par mail : support@froggit.fr | La FAQ :grey_question: | Rejoignez-nous sur le Chat :speech_balloon:

Skip to content
Snippets Groups Projects
Marc BOUVIER's avatar
Marc authored
b9e215f3
History

template-asciidoctor-dockerized

Génération de slides, pdf, ebook, docx à l’aide de Asciidoctor et docker compose.

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

Documents générés

Comment écrire du contenu

Modifier les fichiers présents dans 01-slides

Pré-requis pour construire les exemples

  • Docker Engine 19.03.0+

  • Docker compose

Optionnel

  • GNU Make

Génération des slides

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

Génération du Pdf

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

Génération du E-book

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

Génération du docbook

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

Génération docx

Prérequis : avoir pandoc installé (je n’ai pas encore réussi à le faire fonctionner avec docker)

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

pandoc --from docbook \
  --to docx \
  --toc \
  --highlight-style tango \
  -o docs/output.docx \
  --resource-path=docs \
  docs/output.docbook.xml

Utilisation avec Gitlab CI + Gitlab Pages

Il est possible de créer un projet Gitlab uniquement pour exécuter la CI et le déploiement sur des Gitlab pages.

  • Run CI/CD for external repository

gitlab ci pages from github

Paramétrage de Github Pages

  • Dans le menu "Settings" de Github.

    • Section "Pages"

      • Build and deployment

        • Source : Deploy from branch

        • Branch : main, /docs

Capture d’écran du menu "Settings" de Github. Section "Pages" est sélectionnée. Build and deployment : Source : Deploy from branch. Branch : `main`