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

Đang mở
  • Có gì không ổn?
#98 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
45/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
github-actions
Lĩnh vực
build-system, ci-cd

Hướng nghiên cứu

Bắt đầu với build-lectures/action.yml và các bước workflow native tại .github/workflows/publish.yml:90-91. Tái tạo các bản build intro markov_chains_I và inequality thông qua chuỗi pdflatex → jupyter → html mà không xóa doctrees, sau đó so sánh đầu ra với native site đã được publish. Hoàn tất nghĩa là ghi nhận kết quả âm để đóng issue hoặc ghi lại sự khác biệt và cập nhật các đường dẫn migration và action đã nêu.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
Shell
Star
0
Fork
1
Merge trung bình
18 giờ 51 phút
Pull request đã merge (30 ngày)
58

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của QuantEcon/actions

Tất cả issue của QuantEcon/actions

Issue tương tự

Thêm issue về Shell/Bash

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.