readme : trying to figure out asciidoctor relative links

README.adoc

@@ -2,6 +2,8 @@
 = template-asciidoctor-dockerized
 
 :hide-uri-scheme:
+:lang: FR
+:imagesdir: readme/assets
 
 :back_to_top_target: top-target
 :back_to_top_label: ⬆ Retour au début
@@ -23,11 +25,19 @@ Ce dépôt a été généré à partir du template : https://github.com/baldir-f
 
 == Écrire du contenu
 
-Modifier les fichiers présents dans `01-slides`.
+Modifier les fichiers présents dans link:01-slides/[`01-slides`].
+
 Voir la section <<_ressources-asciidoctor-complementaires,Ressources Asciidoctor complémentaires>> pour démarrer avec Asciidoctor et RevealJs.
 
 {back_to_top}
 
+[#_ressources-asciidoctor-complementaires]
+== Ressources Asciidoctor complémentaires
+
+include::readme/ressources-asciidoctor-complementaires.adoc[➡️ Ressources Asciidoctor complémentaires]
+
+{back_to_top}
+
 == Génération du contenu
 
 === Pré-requis pour construire les exemples
@@ -100,10 +110,3 @@ pandoc --from docbook \
 include::readme/deploiement.adoc[➡️ Méthodes de déploiement]
 
 {back_to_top}
-
-[#_ressources-asciidoctor-complementaires]
-== Ressources Asciidoctor complémentaires
-
-include::readme/ressources-asciidoctor-complementaires.adoc[➡️ Ressources Asciidoctor complémentaires]
-
-{back_to_top}
\ No newline at end of file

readme/deploiement-github-pages-actions.adoc

-=== GitHub Pages via GitHub Actions
+= GitHub Pages via GitHub Actions
 
 Dans ce mode de déploiement, une Github Action est définie dans link:.github/workflows/generate-docs-and-publish-with-gitlab-pages.yml[`.github/workflows/generate-docs-and-publish-with-gitlab-pages.yml`].
 
@@ -12,11 +12,11 @@ Elle est préconfigurée pour
 * Générer le docx (à partir du schéma docbook)
 * Publier l'ensemble du contenu sur la gitlab page correspondant au projet
 
-==== Configuration de Github Pages depuis une Action
+== Configuration de Github Pages depuis une Action
 
 * Dans le menu "Settings" de Github.
 ** Section "Pages"
 *** Build and deployment
 **** Source : GitHub Actions
 
-image::assets/github-pages-action-setup.png[Capture d'écran du menu "Settings" de Github. Section "Pages" est sélectionnée. Build and deployment : Source : Github Actions.]
+image::github-pages-action-setup.png[Capture d'écran du menu "Settings" de Github. Section "Pages" est sélectionnée. Build and deployment : Source : Github Actions.]
\ No newline at end of file

readme/deploiement-github-pages-classic.adoc

-=== Github Pages "classique"
+= Github Pages "classique"
 
 Dans ce mode de déploiement, le contenu devra être généré au préalable.
 
@@ -12,4 +12,4 @@ Cette configuration génère un site jekyll à partir d'une github action préco
 **** Source : Deploy from branch
 **** Branch : `main`, `/docs`
 
-image::assets/github-pages-setup.png[Capture d'écran du menu "Settings" de Github. Section "Pages" est sélectionnée. Build and deployment : Source : Deploy from branch. Branch : `main`, `/docs`]
+image::github-pages-setup.png[Capture d'écran du menu "Settings" de Github. Section "Pages" est sélectionnée. Build and deployment : Source : Deploy from branch. Branch : `main`, `/docs`]
\ No newline at end of file

readme/deploiement-gitlab-ci-for-external-repos.adoc

-=== Gitlab CI + Gitlab Pages depuis un dépôt Git externe
+= Gitlab CI + Gitlab Pages depuis un dépôt Git externe
 
 Il est possible de créer un projet Gitlab uniquement pour exécuter la CI et le déploiement sur des Gitlab pages.
 
@@ -8,6 +8,6 @@ Pour que le déclenchement automatique lors de changements
 
 - Run https://docs.gitlab.com/ee/ci/ci_cd_for_external_repos/index.html[CI/CD for external repository]
 
-image:assets/gitlab-ci-pages-from-github.png[]
+image:gitlab-ci-pages-from-github.png[]
 
 Exemple de contenu déployé sur une Gitlab Page : https://gitlab.com/marc-bouvier/template-asciidoctor-dockerized-gitlab-pages/-/pipelines[window=_blank]
\ No newline at end of file

readme/deploiement-gitlab-ci.adoc

-=== Gitlab
+= Gitlab
 
 Si ce dépôt est sur Gitlab.
 

readme/deploiement.adoc

 
+:leveloffset: +2
+
 include::deploiement-gitlab-ci.adoc[]
 
 include::deploiement-gitlab-ci-for-external-repos.adoc[]
 
 include::deploiement-github-pages-classic.adoc[]
 
-include::deploiement-github-pages-actions.adoc[]
+include::deploiement-github-pages-actions.adoc[]
\ No newline at end of file
+
+:leveloffset: -2
\ No newline at end of file

readme/ressources-asciidoctor-complementaires.adoc

 
-* https://github.com/asciidoctor/docker-asciidoctor/blob/main/README.adoc[docker-asciidoctor]
-* https://docs.asciidoctor.org/asciidoctor/latest/cli/:[Asciidoc CLI]
 * https://docs.asciidoctor.org/reveal.js-converter/latest/converter/features/[Asciidoctor RevealJs — écrire une présentation]
 * https://docs.asciidoctor.org/reveal.js-converter/latest/converter/revealjs-options/[Asciidoctor RevealJs — configurer RevealJs]
 * https://docs.asciidoctor.org/asciidoc/latest/directives/include-tagged-regions/#tagging-regions[Asciidoctor — inclure des snippets à l'aide de régions]
+* https://github.com/asciidoctor/docker-asciidoctor/blob/main/README.adoc[Image Docker `docker-asciidoctor`]
+* https://docs.asciidoctor.org/asciidoctor/latest/cli/:[Asciidoc CLI]
 * https://docs.asciidoctor.org/asciidoc/latest/directives/ifdef-ifndef/[Asciidoc — Conditionals / ifdef and ifndef Directives]
 * https://mrduguo.github.io/asciidoctor.org/docs/asciidoctor-revealjs/#content-meant-for-multiple-back-ends[Asciidoctor-RevealJs — Content meant for multiple back-ends]
\ No newline at end of file