Skip to content

Migrate course site pipeline to Jupyter Book 2 with MyST config - #199

Open
afeld with Copilot wants to merge 8 commits into
mainfrom
copilot/update-to-jupyter-book-2
Open

Migrate course site pipeline to Jupyter Book 2 with MyST config#199
afeld with Copilot wants to merge 8 commits into
mainfrom
copilot/update-to-jupyter-book-2

Conversation

Copilot AI commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

This updates the course site from Jupyter Book 1.x to 2.x and aligns the repository with the MyST-driven configuration model. It also keeps the Columbia/NYU school rendering flow compatible with the new build path.

  • Jupyter Book 2 dependency + CLI migration

    • Bumped jupyter-book to 2.* in requirements.txt.
    • Replaced legacy JB1 build flags in Makefile with JB2-compatible invocation.
  • MyST-native project/site configuration

    • Added myst.yml as the authoritative JB2 config.
    • Migrated course metadata and full book navigation into project.toc.
    • Preserved school-specific Jinja conditionals inside TOC entries (Columbia/NYU branches of content).
  • Read the Docs pipeline alignment

    • Switched .readthedocs.yaml from Sphinx-prebuild flow to direct JB2/MyST HTML build commands.
    • Added explicit Node runtime and _build/html artifact copy compatible with JB2 output.
  • Docs update for maintainers

    • Updated meta/instructor_guide.md to reference myst.yml in site configuration ownership.
site:
	jupyter-book build --html --all --ci

Copilot AI and others added 3 commits September 7, 2026 19:29
Co-authored-by: afeld <86842+afeld@users.noreply.github.com>
Co-authored-by: afeld <86842+afeld@users.noreply.github.com>
Co-authored-by: afeld <86842+afeld@users.noreply.github.com>
Copilot AI and others added 2 commits September 8, 2026 15:34
…yter-book-2

Co-authored-by: afeld <86842+afeld@users.noreply.github.com>
Co-authored-by: afeld <86842+afeld@users.noreply.github.com>
@afeld

afeld commented Sep 8, 2026

Copy link
Copy Markdown
Owner

@copilot Rebase and squash on main then fix the build. Keep going until it passes.

Co-authored-by: afeld <86842+afeld@users.noreply.github.com>

Copilot AI commented Sep 8, 2026

Copy link
Copy Markdown
Contributor Author

@copilot Rebase and squash on main then fix the build. Keep going until it passes.

Updated in 5e53235 (plus prior 0a84ed1). I merged main instead of rebasing/squashing because this environment cannot safely publish rewritten history (no force-push path). I fixed the failing build path by normalizing .html internal links to JB2 folder-style routes in extras/scripts/broken_links.rb, and the earlier test dependency failure was fixed by adding markdown-it-py.

@afeld

afeld commented Sep 8, 2026

Copy link
Copy Markdown
Owner

@copilot There are still merge conflicts.

Copilot AI and others added 2 commits September 8, 2026 18:19
…yter-book-2

# Conflicts:
#	requirements.txt

Co-authored-by: afeld <86842+afeld@users.noreply.github.com>
Co-authored-by: afeld <86842+afeld@users.noreply.github.com>

Copilot AI commented Sep 8, 2026

Copy link
Copy Markdown
Contributor Author

@copilot There are still merge conflicts.

Resolved in c7591b6 (merge of latest main) and 060f010 (lockfile update after dependency conflict resolution). The branch now includes current main and the merge conflict on dependency files has been resolved.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants