publish-2026-07-17

Set up GitHub Pages publishing (#11)

* Set up GitHub Pages publishing (cache + publish workflows, environment)

Mirrors the fa edition's publishing machinery, adapted for fr:

- environment.yml copied from the English source (anaconda 2026.06,
  quantecon-book-theme 0.21.0) so the build matches the seeded content
- cache.yml builds the execution cache on every push to main
- publish.yml builds HTML on publish* tags, uploads a release archive,
  and deploys to gh-pages (custom-domain CNAME left commented pending
  the DNS decision); -W disabled for the first publishes, as in cache.yml
- _config.yml now points at this repo and its actual serving URL
  (quantecon.github.io/lecture-python-programming.fr) instead of the
  English site, avoiding the baseurl/CNAME mismatch found on fa and
  zh-cn; also sets Sphinx language: fr

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Deploy Pages via the native artifact flow instead of a gh-pages branch

Replaces peaceiris/actions-gh-pages with actions/upload-pages-artifact
+ actions/deploy-pages (both v5), matching the Pages source already
enabled on this repo (build_type: workflow). No gh-pages branch and no
post-publish settings flip needed; the custom domain, when decided, is
set in Settings -> Pages together with the _config.yml baseurl.

The github-pages environment's deployment policy has been extended with
a publish* tag rule so tag-triggered deploys pass protection checks.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Simplify publish.yml: HTML only, via quantecon/actions/publish-gh-pages

Follows the English source repo's publish workflow (the current fleet
convention) rather than fa's older hand-rolled pattern:

- deploy + release assets (archive, checksum, manifest) collapse into
  one quantecon/actions/publish-gh-pages@v0.8.0 step, which uses the
  native Pages artifact flow
- commented PDF/notebook blocks and the LaTeX toolchain install removed
  (HTML only for now); GPU runner and JAX steps from the source repo
  are not needed here, as on fa
- no cname: the site serves at the default Pages URL,
  https://quantecon.github.io/lecture-python-programming.fr/, and the
  custom-domain TODO comment is dropped from _config.yml

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Add Netlify PR previews (ci.yml) for reviewer-facing rendered builds

Uses quantecon/actions/preview-netlify@v0.8.0 (the lecture-python.myst
pattern), HTML only, on ubuntu-latest. The action posts a PR comment
with the preview URL and the changed lectures, so translation review
can happen on rendered French pages rather than MyST diffs.

Requires two secrets not yet available to this repo: the org-level
NETLIFY_AUTH_TOKEN extended to include this repo, and a repo-level
NETLIFY_SITE_ID for a new Netlify site. Until they exist the preview
step self-skips for untrusted actors but will fail for in-repo PRs, so
grant them before merging or expect red previews.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Address Copilot review: drop dangling nb_repository_url, clear doctrees

- nb_repository_url pointed at lecture-python-programming.fr.notebooks,
  which does not exist; the theme (launch.py) skips notebook-launch
  links entirely when the key is unset, so removing it is clean for an
  HTML-only edition
- publish.yml now clears _build/.doctrees after downloading the cache
  (as ci.yml already did, following lecture-python.myst), removing the
  one staleness vector in the latest-from-main cache convention

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>