mirror of
https://github.com/eternity4719/HowToLiveBetter.git
synced 2026-11-20 08:40:44 +08:00
CLAUDE.md:长文链接第①处改指 README 导航表格的「长文」格
This commit is contained in:
@@ -68,7 +68,7 @@
|
||||
|
||||
README 开头「这本书想回答的问题」表**一节只占一行**(2026-09-19 用户定):同一个链接贴两遍,读者要在同一个目的地上停两次,两行之间又没有逻辑差别。一节覆盖面宽就在一行里用逗号串几个问题、一个问号收尾(第 19 节「加班费、年休假该怎么算,被裁该拿多少补偿,上班受了伤怎么认定和拿钱?」是范式),不要拆成两行。当天把第 6、8、24 节原有的两行都并掉了,现在是 32 行对 32 节。
|
||||
|
||||
电子版三样,全由 `.github/workflows/book.yml` 在 main 上正文改动后自动生成,挂到固定 Release `epub-latest`(下载链接不变,README 引用的就是它),PR 只生成校验不发布;产物都进 `dist/`(已 gitignore)。**产物本身不入库**,正文几乎天天改,提交二进制只会过时和撑大历史(2026-09-18 issue #12 定的方案)。README 的结构解析和文件清单收在 `tools/lib/book.mjs`,三套构建共用,新增节或长文不用改脚本。**但新增 docs 长文必须手工挂四处链接**(2026-09-21 连漏两次,两次都是用户发现的):① README 顶部导航区以 `**长文**:` 开头的那一行(写成「[x](docs/x.md)」,2026-09-28 导航区重排后不再带「(长文)」后缀);② README 末尾「长文另见」那句;③ README 对应节的目录行(写成「长文见 [docs/x.md](docs/x.md)。」);④ index.html 里 `class="doc-links"` 那一行,URL 要百分号编码。核对办法:`grep -c "docs/<名>.md" README.md` 应为 3,`grep -c "<名>" index.html` 应为 1。第 ① 处是硬性的——`book.mjs` 第 54 行靠正则 `\]\((docs/[^)#/]+\.md)\)` 从 README 里扒长文清单,只在 book/ 条目里链接,EPUB、PDF、离线单文件三套构建都收不到它。sync-stats.ps1 不检查这三处。
|
||||
电子版三样,全由 `.github/workflows/book.yml` 在 main 上正文改动后自动生成,挂到固定 Release `epub-latest`(下载链接不变,README 引用的就是它),PR 只生成校验不发布;产物都进 `dist/`(已 gitignore)。**产物本身不入库**,正文几乎天天改,提交二进制只会过时和撑大历史(2026-09-18 issue #12 定的方案)。README 的结构解析和文件清单收在 `tools/lib/book.mjs`,三套构建共用,新增节或长文不用改脚本。**但新增 docs 长文必须手工挂四处链接**(2026-09-21 连漏两次,两次都是用户发现的):① README 顶部导航表格里「长文」那一格(HTML 表格,单元格里必须留空行、用 markdown 写成「[x](docs/x.md)」,写成 `<a href>` 就不被下面那个正则认;2026-09-28 导航区改成表格后不再带「(长文)」后缀);② README 末尾「长文另见」那句;③ README 对应节的目录行(写成「长文见 [docs/x.md](docs/x.md)。」);④ index.html 里 `class="doc-links"` 那一行,URL 要百分号编码。核对办法:`grep -c "docs/<名>.md" README.md` 应为 3,`grep -c "<名>" index.html` 应为 1。第 ① 处是硬性的——`book.mjs` 第 54 行靠正则 `\]\((docs/[^)#/]+\.md)\)` 从 README 里扒长文清单,只在 book/ 条目里链接,EPUB、PDF、离线单文件三套构建都收不到它。sync-stats.ps1 不检查这三处。
|
||||
- EPUB:`tools/epub/build.mjs`(只依赖 marked,zip 自己打),CI 里跑 epubcheck。本地 `cd tools/epub && npm ci && npm run build`。
|
||||
- 离线单文件 HTML:`tools/offline/build.mjs`(零依赖)把正文**和 docs 长文**内联进 index.html 的 `window.__CORPUS__`(`parts` 放 book/、`docs` 放长文),双击就能看、离线可用;index.html 的 `init()` 认这个变量就不发请求,改 init 的取数逻辑要同时顾到这条路。**检索页的长文是就地弹窗打开的,不跳 GitHub**:点击处统一拦「指向 `docs/*.md` 的 GitHub 链接」(页头那行长文、条目备注里 `hrefOf()` 转出来的相对链接,形状都是这一个),弹窗自带一份可点的章节目录和 scrollspy,markdown 由 index.html 里那个只认标题/段落/列表/表格的小渲染器处理,不引库。长文里如果开始用引用块、代码块这类新语法,要同步加进那个渲染器。
|
||||
- PDF:`tools/pdf/build.mjs` + `tools/pdf/template.typ`,pandoc 转 typst、typst 排版(A4、每节另起一页、页眉带节名、目录带页码、书签到条目级)。本地要 pandoc ≥ 3.1 和 typst ≥ 0.13,用环境变量 `PANDOC`、`TYPST` 指到可执行文件;CI 里按 workflow 顶部 env 里钉的版本下载。版面只改 template.typ。
|
||||
|
||||
Reference in New Issue
Block a user