build-lectures: no `_build/.doctrees` clear (ipywidget mimetype rendering)

Aperta
  • Qualcosa non va?
#98 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
45/100
Tipo di issue
Bug
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
github-actions
Ambito
build-system, ci-cd

Direzione di ricerca

Inizia da build-lectures/action.yml e dai passaggi nativi del workflow in .github/workflows/publish.yml:90-91. Riproduci le build intro markov_chains_I e inequality attraverso la sequenza pdflatex → jupyter → html senza cancellare i doctrees, quindi confronta l’output con il sito nativo pubblicato. Il lavoro è concluso quando registri un risultato negativo per la chiusura oppure documenti la divergenza e aggiorni i percorsi di migrazione e action indicati.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

bug low-priority

v0.8.0 validation study: two native pipelines clear the Sphinx doctree cache before the final HTML build to fix ipywidget mimetype rendering — lecture-python-intro (.github/workflows/publish.yml:90), lecture-python-advanced.myst (.github/workflows/publish.yml:91). Composite build-lectures has none: nothing here touches .doctrees; its pre-build HTML steps are only Stage PDF (build-lectures/action.yml:51) and Stage notebooks (build-lectures/action.yml:70).

Intra-job trigger, not a stale cache: jb writes one shared _build/.doctrees, so HTML in a three-format job reads doctrees from the earlier pdflatex and jupyter builds; reproduces cold. That pdflatex → jupyter → html sequence is the migration target (docs/MIGRATION-GUIDE.md:313-332); single-builder consumers like lecture-dp (builder: 'html') are out of scope. Unreproduced — inferred from the native BUG: comment.

No zero-build A/B — no clear-free repo emits widget output:

  • lecture-python-advanced.myst/lectures/matsuyama.md: sole ipywidgets import among migrated repos, cells skip-execution (no mimetype emitted), and that repo clears.

  • lecture-python-intro (also clears): executed rich output in markov_chains_I.md (HTML(anim.to_jshtml())) and inequality.md (plotly).

  • lecture-python-programming.myst: clear-free in production, but no executed widget/animation/plotly output.

  • QuantEcon/test-actions-lecture-intro: composite, no clear, no cache restore, but its canary TOC builds five rich-free lectures (geom_series, short_path, lln_clt, solow, linear_equations) under only_build_toc_files: true, unpublished since 2026-02-10; widening cuts against _toc.yml's no-content-drift criteria — separate decision.

  • Repro: build intro's markov_chains_I and inequality through the composite pdflatex → jupyter → html with no clear; compare to the published native site.

  • Matches → the clear is not load-bearing for current content; close wontfix with the negative result recorded.

  • Diverges → add an optional clear-doctrees input (default off) to the build-lectures HTML path, plus a MIGRATION-GUIDE note for repos coming from native pipelines.

  • Lower priority: the cache stores _build wholesale (restore-jupyter-cache/action.yml:109), so .doctrees rides along on restore — re-check once #92 Phase 1 turns on save-cache: 'true'.

Lingua principale
Shell
Stelle
0
Fork
1
Merge medio
20h 3m
PR unite (30g)
48

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di QuantEcon/actions

Tutte le issue di QuantEcon/actions

Issue simili

Altre issue su Shell/Bash

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.