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

Abierto
  • ¿Algo no está bien?
#98 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
45/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
github-actions
Área
build-system, ci-cd

Línea de trabajo

Comienza con build-lectures/action.yml y los pasos nativos del workflow en .github/workflows/publish.yml:90-91. Reproduce las compilaciones de intro markov_chains_I e inequality mediante la secuencia pdflatex → jupyter → html sin borrar doctrees y compara la salida con el sitio nativo publicado. Se considera terminado cuando registres un resultado negativo para cerrar el issue o documentes la divergencia y actualices las rutas de migración y de action indicadas.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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'.

Lenguaje dominante
Shell
Estrellas
0
Forks
1
Merge medio
20 h 3 min
PR fusionados (30 d)
48

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de QuantEcon/actions

Todos los issues de QuantEcon/actions

Issues similares

Más issues de Shell/Bash

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.