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
Commit 3840217c authored by Marc's avatar Marc
Browse files

readme : links & images are properly followed both from main page and child

parent d05474bc
No related branches found
No related tags found
No related merge requests found
[#main_title]
= template-asciidoctor-dockerized
:is-root: true
:hide-uri-scheme:
:lang: FR
:imagesdir: {docdir}/readme/assets
......@@ -9,6 +10,8 @@
:back_to_top_label: ⬆ Retour au début
:back_to_top: <<main_title,{back_to_top_label}>>
:link-gitlab-ci-yml: .gitlab-ci.yml
Génération de slides, pdf, ebook, docx à l'aide de https://docs.asciidoctor.org/asciidoctor/latest/[Asciidoctor,window=_blank], https://docs.asciidoctor.org/reveal.js-converter/latest/[RevealJs,window=_blank] et https://docs.docker.com/compose/[Docker Compose,window=_blank].
Ce dépôt a été généré à partir du template : https://github.com/baldir-fr/template-asciidoctor-dockerized[window=_blank]
......@@ -107,6 +110,9 @@ pandoc --from docbook \
== Déploiement
{docdir}
include::readme/deploiement.adoc[➡️ Méthodes de déploiement]
{back_to_top}
= GitHub Pages via GitHub Actions
:imagesdir: readme/assets
ifdef::env-github[]
:imagesdir: ../readme/assets
:docdir: /
:link-github-action-generate-docs-and-publish-with-github-pages: .github/workflows/generate-docs-and-publish-with-github-pages.yml
ifndef::is-root[]
:link-github-action-generate-docs-and-publish-with-github-pages: ../.github/workflows/generate-docs-and-publish-with-github-pages.yml
:imagesdir: assets
endif::[]
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`].
Dans ce mode de déploiement, une Github Action est définie dans link:{link-github-action-generate-docs-and-publish-with-github-pages}[`.github/workflows/generate-docs-and-publish-with-gitlab-pages.yml`].
Elle est préconfigurée pour
......
= Github Pages "classique"
:imagesdir: readme/assets
ifdef::env-github[]
:imagesdir: ../readme/assets
:docdir: /
:link-docs: docs
ifndef::is-root[]
:link-docs: ../docs
:imagesdir: assets
endif::[]
Dans ce mode de déploiement, le contenu devra être généré au préalable.
C'est-à-dire que le contenu du dossier link:docs[`docs`] est généré sur le dépôt local du développeur, puis commit et push.
C'est-à-dire que le contenu du dossier link:{link-docs}[`docs`] est généré sur le dépôt local du développeur, puis commit et push.
Cette configuration génère un site jekyll à partir d'une github action préconfigurée.
......
= Gitlab CI + Gitlab Pages depuis un dépôt Git externe
:imagesdir: readme/assets
ifdef::env-github[]
:imagesdir: ../readme/assets
:docdir: /
endif::[]
:link-gitlab-ci-yml: .gitlab-ci.yml
ifndef::is-root[]
:link-gitlab-ci-yml: ../.gitlab-ci.yml
:imagesdir: assets
endif::[]
Il est possible de créer un projet Gitlab uniquement pour exécuter la CI et le déploiement sur des Gitlab pages.
Dans ce mode, Gitlab (premium) va créer un projet uniquement pour exécuter le pipeline déclaré dans link:.gitlab-ci.yml[`.gitlab-ci.yml`].
Dans ce mode, Gitlab (premium) va créer un projet uniquement pour exécuter le pipeline déclaré dans link:{link-gitlab-ci-yml}[`.gitlab-ci.yml`].
Pour que le déclenchement automatique lors de changements
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]
......
= Gitlab
ifdef::env-github[]
:imagesdir: ../readme/assets
:docdir: /
:link-gitlab-ci-yml: .gitlab-ci.yml
ifndef::is-root[]
:link-gitlab-ci-yml: ../.gitlab-ci.yml
:imagesdir: assets
endif::[]
Si ce dépôt est sur Gitlab.
Le pipeline link:.gitlab-ci.yml[`.gitlab-ci.yml`] est préconfigurée pour
Le pipeline link:{link-gitlab-ci-yml}[`.gitlab-ci.yml`] est préconfigurée pour
* Copier les assets
* Générer les slides au format HTML
......
{docdir}
:leveloffset: +2
include::deploiement-gitlab-ci.adoc[]
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment