GGitHubfix(book): wrap inline code and fail incomplete PDF builds (#460)

d18b8fe5创建于 25 天前历史提交

文件	最后提交记录	最后更新时间
README.md	feat: book edition pipeline, fundamentals-first headlines, animated figures, verified bug fixes (#348) Book pipeline: six-volume EPUB/PDF compilation built by CI from lesson sources (book/, scripts/build_book.py, themed title pages with edition stamps, site-matching print theme), attached to every GitHub release. Homepage Books section and README section link the latest release. Fundamentals-first headline policy across the course: 16 lesson titles and 30+ taglines/section headings now lead with the concept (agent state machines, actor model, role-based teams, memory paging, serving engine internals, permission modes); framework and product names are demoted to attributed in-body examples. README, ROADMAP, quizzes, and prerequisite references synced. New agent-memory taxonomy section maps memory types to representative implementations. Vendor-neutral model policy: runnable defaults read the LLM_MODEL env var with undated aliases; dated snapshot ids removed; multi-provider phrasing in the setup lesson. Lessons deepened with original material: prediction-game origins of perplexity (05/16), scripted-era chatbot lineage 1950-2001 (05/17), causal-triangle derivation from prefix averaging plus GPT-5 date fix (07/07). Three new animated site figures back them (figures-history.js). llms.txt now carries per-lesson raw markdown links so agents can fetch full lesson text directly. Bug fixes verified with executed repros: capstone solved flag keyed to test results, 405B cost estimator overflow, f-string crash on Python <3.12, no-torch demo path, negative stable BCE, all-zero stationary distribution, inverted Cohens d, per-lesson quiz panel, lesson-fetch retry with honest errors, decision-trees doc completed, editor shortcuts, rustc run command, Docker python3.12 build with doc sync, git lesson fork flow, FIPA receiver field, fnm under Rosetta, 15 curl-verified link fixes, remaining imdb dataset id spot.	2 个月前
epub.css	feat: book edition pipeline, fundamentals-first headlines, animated figures, verified bug fixes (#348) Book pipeline: six-volume EPUB/PDF compilation built by CI from lesson sources (book/, scripts/build_book.py, themed title pages with edition stamps, site-matching print theme), attached to every GitHub release. Homepage Books section and README section link the latest release. Fundamentals-first headline policy across the course: 16 lesson titles and 30+ taglines/section headings now lead with the concept (agent state machines, actor model, role-based teams, memory paging, serving engine internals, permission modes); framework and product names are demoted to attributed in-body examples. README, ROADMAP, quizzes, and prerequisite references synced. New agent-memory taxonomy section maps memory types to representative implementations. Vendor-neutral model policy: runnable defaults read the LLM_MODEL env var with undated aliases; dated snapshot ids removed; multi-provider phrasing in the setup lesson. Lessons deepened with original material: prediction-game origins of perplexity (05/16), scripted-era chatbot lineage 1950-2001 (05/17), causal-triangle derivation from prefix averaging plus GPT-5 date fix (07/07). Three new animated site figures back them (figures-history.js). llms.txt now carries per-lesson raw markdown links so agents can fetch full lesson text directly. Bug fixes verified with executed repros: capstone solved flag keyed to test results, 405B cost estimator overflow, f-string crash on Python <3.12, no-torch demo path, negative stable BCE, all-zero stationary distribution, inverted Cohens d, per-lesson quiz panel, lesson-fetch retry with honest errors, decision-trees doc completed, editor shortcuts, rustc run command, Docker python3.12 build with doc sync, git lesson fork flow, FIPA receiver field, fnm under Rosetta, 15 curl-verified link fixes, remaining imdb dataset id spot.	2 个月前
literal-tokens.lua	fix(book): preserve literal tokens in EPUB and PDF (#458)	25 天前
pdf-layout.lua	fix(book): wrap inline code and fail incomplete PDF builds (#460) * fix(book): keep inline table code inside PDF margins * fix(book): preserve Unicode and fail incomplete PDF builds * fix(book): wrap inline code in PDF prose without extra symbols * fix(book): wrap long plain-text identifiers in PDF tables * fix(book): preserve Unicode sequences in table wrapping	25 天前
theme.tex	fix(book): wrap inline code and fail incomplete PDF builds (#460) * fix(book): keep inline table code inside PDF margins * fix(book): preserve Unicode and fail incomplete PDF builds * fix(book): wrap inline code in PDF prose without extra symbols * fix(book): wrap long plain-text identifiers in PDF tables * fix(book): preserve Unicode sequences in table wrapping	25 天前
titlepage.tex	feat: book edition pipeline, fundamentals-first headlines, animated figures, verified bug fixes (#348) Book pipeline: six-volume EPUB/PDF compilation built by CI from lesson sources (book/, scripts/build_book.py, themed title pages with edition stamps, site-matching print theme), attached to every GitHub release. Homepage Books section and README section link the latest release. Fundamentals-first headline policy across the course: 16 lesson titles and 30+ taglines/section headings now lead with the concept (agent state machines, actor model, role-based teams, memory paging, serving engine internals, permission modes); framework and product names are demoted to attributed in-body examples. README, ROADMAP, quizzes, and prerequisite references synced. New agent-memory taxonomy section maps memory types to representative implementations. Vendor-neutral model policy: runnable defaults read the LLM_MODEL env var with undated aliases; dated snapshot ids removed; multi-provider phrasing in the setup lesson. Lessons deepened with original material: prediction-game origins of perplexity (05/16), scripted-era chatbot lineage 1950-2001 (05/17), causal-triangle derivation from prefix averaging plus GPT-5 date fix (07/07). Three new animated site figures back them (figures-history.js). llms.txt now carries per-lesson raw markdown links so agents can fetch full lesson text directly. Bug fixes verified with executed repros: capstone solved flag keyed to test results, 405B cost estimator overflow, f-string crash on Python <3.12, no-torch demo path, negative stable BCE, all-zero stationary distribution, inverted Cohens d, per-lesson quiz panel, lesson-fetch retry with honest errors, decision-trees doc completed, editor shortcuts, rustc run command, Docker python3.12 build with doc sync, git lesson fork flow, FIPA receiver field, fnm under Rosetta, 15 curl-verified link fixes, remaining imdb dataset id spot.	2 个月前
volumes.json	feat: book edition pipeline, fundamentals-first headlines, animated figures, verified bug fixes (#348) Book pipeline: six-volume EPUB/PDF compilation built by CI from lesson sources (book/, scripts/build_book.py, themed title pages with edition stamps, site-matching print theme), attached to every GitHub release. Homepage Books section and README section link the latest release. Fundamentals-first headline policy across the course: 16 lesson titles and 30+ taglines/section headings now lead with the concept (agent state machines, actor model, role-based teams, memory paging, serving engine internals, permission modes); framework and product names are demoted to attributed in-body examples. README, ROADMAP, quizzes, and prerequisite references synced. New agent-memory taxonomy section maps memory types to representative implementations. Vendor-neutral model policy: runnable defaults read the LLM_MODEL env var with undated aliases; dated snapshot ids removed; multi-provider phrasing in the setup lesson. Lessons deepened with original material: prediction-game origins of perplexity (05/16), scripted-era chatbot lineage 1950-2001 (05/17), causal-triangle derivation from prefix averaging plus GPT-5 date fix (07/07). Three new animated site figures back them (figures-history.js). llms.txt now carries per-lesson raw markdown links so agents can fetch full lesson text directly. Bug fixes verified with executed repros: capstone solved flag keyed to test results, 405B cost estimator overflow, f-string crash on Python <3.12, no-torch demo path, negative stable BCE, all-zero stationary distribution, inverted Cohens d, per-lesson quiz panel, lesson-fetch retry with honest errors, decision-trees doc completed, editor shortcuts, rustc run command, Docker python3.12 build with doc sync, git lesson fork flow, FIPA receiver field, fnm under Rosetta, 15 curl-verified link fixes, remaining imdb dataset id spot.	2 个月前

Book Pipeline

The course compiles into a six-volume book series. The book is a companion, not a replacement: interactive figures, graded quizzes, and runnable code stay on the website and in this repository, and every chapter ends with the links that take the reader there.

Volumes

Defined in volumes.json. Each volume maps to a band of phases:

Vol	Title	Phases
1	Foundations	00-02
2	Deep Learning	03, 04, 06
3	Language	05, 07
4	Large Language Models	08-11
5	Agents	12-16
6	Production	17-19

Build

python3 scripts/build_book.py                  # all volumes, EPUB
python3 scripts/build_book.py --volume language
python3 scripts/build_book.py --pdf            # adds PDF (needs xelatex + DejaVu fonts)

Requires pandoc. Optional: @mermaid-js/mermaid-cli (mmdc) to render mermaid diagrams as images; without it they become web-edition pointers. Output lands in dist/book/.

CI (.github/workflows/build-book.yml) builds EPUBs on every push that touches phases/, and EPUB + PDF on releases, attaching both to the release.

What the assembler does per lesson

Lesson # title becomes a chapter; phases become unnumbered part pages.
figure blocks (interactive JS widgets) become boxed pointers to the lesson's web edition.
Mermaid blocks render to SVG when mmdc is available, otherwise become web pointers.
## Ship It sections are replaced with a pointer to the repo artifact.
## Exercises gains a starter-code link into the lesson's code/ directory.
Every chapter closes with a Continue Online box: web edition, code, quiz.
Asset image paths are rewritten so pandoc embeds the lesson SVGs.

The machine-readable index agents use to navigate the course (site/llms.txt, generated by site/build.js on deploy) links each lesson's raw markdown, and the book's "Learning with an AI" front page tells readers how to point their assistant at it.