Skip to content

Paithon Book 1.5.8 #176

Paithon Book 1.5.8

Paithon Book 1.5.8 #176

name: call-deploy-book
on:
push:
branches:
- '**'
# If your git repository has the Jupyter Book within some-subfolder next to
# unrelated files, you can make this run only if a file within that specific
# folder (or the workflow file itself) has been modified.
#
paths:
- book/**
- .github/workflows/call-deploy-book.yml
workflow_dispatch:
jobs:
call-workflow:
# Solo dal repository pubblico. Il libro si scrive in un repo privato che ha
# gli stessi workflow: senza questa guardia proverebbe a pubblicare Pages da
# la', e il deploy ha una sola destinazione.
if: github.repository == 'paithon-it/paithonbook'
# Ancorato a un tag, non a `@main`. Il reusable e' di terzi e `main` si
# muove: cinque commit fra marzo e maggio 2026, l'ultimo per cambiare la
# versione di un'azione di deploy. Finche' sono manutenzioni va bene, ma
# dentro quel workflow c'e' il comando che costruisce il libro
# (`teachbooks build book/`), e il giorno che TeachBooks passa a Jupyter
# Book 2 — che non e' un aggiornamento, e' un altro programma — la build
# cambierebbe senza che qui nessuno abbia toccato niente, e lo si
# scoprirebbe da un sito che si comporta diversamente.
# La v1.1.12 e' del 19 maggio 2026 ed e' esattamente quella che girava
# prima di questo pin: il deploy non cambia, cambia solo che da ora in poi
# aggiornarlo e' una decisione che si prende, non una che capita.
uses: TeachBooks/deploy-book-workflow/.github/workflows/deploy-book.yml@v1.1.12
# NIENTE `secrets: inherit`: il submodule `book/_static/brand` è PUBBLICO,
# quindi il checkout lo clona col GITHUB_TOKEN di default — nessun GH_PAT
# serve. Non ereditando i secret, il reusable non raccoglie un eventuale
# GH_PAT residuo (che, privo del permesso Pages, faceva fallire lo step
# "Include overview summary"). Il GITHUB_TOKEN di default ha `pages: write`.
permissions:
contents: read
pages: write
id-token: write