gt-forgejo/Pilotage

Simplifier la publication Pages : mini-action wrapper gt-forgejo/pages-deploy #22

New issue

Open

opened 2026-05-21 15:33:02 +02:00 by thomas-sanson · 0 comments

thomas-sanson commented

2026-05-21 15:33:02 +02:00

Member

Salut,

petite idée d'ergonomie qui m'est venue en bossant sur le demo MkDocs Pages.

Aujourd'hui, pour qu'un prof publie son site, son workflow doit faire :

- uses: actions/git-pages@v2
  with:
    site: https://${{ github.repository_owner }}.pages.incubateur.education-nationale.eu/${{ github.event.repository.name }}/
    source: ./site/
    token: ${{ secrets.GITEA_TOKEN }}

Ça marche, et c'est portable si on fork. Mais l'URL est longue, la syntaxe ${{ }} fait peur quand on découvre, et le token: à passer explicitement c'est un détail technique qui n'aide personne.

Proposition : on crée une mini-action wrapper côté gt-forgejo, genre gt-forgejo/pages-deploy@v1, qui calcule l'URL automatiquement et appelle actions/git-pages@v2 derrière. Le workflow utilisateur devient :

- uses: gt-forgejo/pages-deploy@v1
  with:
    source: ./site/

C'est tout. Plus d'URL à comprendre, plus de secrets.GITEA_TOKEN à passer, plus rien.

Bonus

Si un jour on change le format d'URL Pages (ex. on passe en <repo>.pages.… style apps.education.fr), TOUS les workflows continuent de marcher sans modif. On change juste l'action wrapper.

C'est aussi ce que fait GitHub avec actions/deploy-pages@v4 (qui n'a pas besoin de site: non plus).

Coût

~30 lignes de YAML dans un nouveau repo gt-forgejo/pages-deploy. 30 min de boulot, à faire une fois. Petite maintenance ensuite si on veut suivre les updates upstream de actions/git-pages@v2.

Pour qui ?

Surtout les profs qui découvrent Git/CI et qui veulent juste publier leur cours / leur doc. Le workflow le plus simple possible.

Salut, petite idée d'ergonomie qui m'est venue en bossant sur le demo MkDocs Pages. Aujourd'hui, pour qu'un prof publie son site, son workflow doit faire : ```yaml - uses: actions/git-pages@v2 with: site: https://${{ github.repository_owner }}.pages.incubateur.education-nationale.eu/${{ github.event.repository.name }}/ source: ./site/ token: ${{ secrets.GITEA_TOKEN }} ``` Ça marche, et c'est portable si on fork. Mais l'URL est longue, la syntaxe `${{ }}` fait peur quand on découvre, et le `token:` à passer explicitement c'est un détail technique qui n'aide personne. Proposition : on crée une mini-action wrapper côté `gt-forgejo`, genre `gt-forgejo/pages-deploy@v1`, qui calcule l'URL automatiquement et appelle `actions/git-pages@v2` derrière. Le workflow utilisateur devient : ```yaml - uses: gt-forgejo/pages-deploy@v1 with: source: ./site/ ``` C'est tout. Plus d'URL à comprendre, plus de `secrets.GITEA_TOKEN` à passer, plus rien. ## Bonus Si un jour on change le format d'URL Pages (ex. on passe en `<repo>.pages.…` style apps.education.fr), TOUS les workflows continuent de marcher sans modif. On change juste l'action wrapper. C'est aussi ce que fait GitHub avec `actions/deploy-pages@v4` (qui n'a pas besoin de `site:` non plus). ## Coût ~30 lignes de YAML dans un nouveau repo `gt-forgejo/pages-deploy`. 30 min de boulot, à faire une fois. Petite maintenance ensuite si on veut suivre les updates upstream de `actions/git-pages@v2`. ## Pour qui ? Surtout les profs qui découvrent Git/CI et qui veulent juste publier leur cours / leur doc. Le workflow le plus simple possible.

👍 2

thomas-sanson referenced this issue

2026-05-21 15:46:00 +02:00

Configurer Forgejo Pages (équivalent GitLab Pages) #2

thomas-sanson added a new dependency

2026-05-21 15:46:10 +02:00

#2 Configurer Forgejo Pages (équivalent GitLab Pages)

thomas-sanson removed a dependency

2026-05-21 15:46:18 +02:00

#2 Configurer Forgejo Pages (équivalent GitLab Pages)