README 顶部导航重排:检索页和 AI skill 放大放首行,下载、查阅、长文分行,其他语言和衍生工具并排成表、免责说明合成一句;检索页页头加 skill 入口,顺手删掉长文行多出的 </a>

This commit is contained in:
albert4719
2026-09-28 15:04:04 +08:00
parent b488d58f57
commit d4250999ad
3 changed files with 16 additions and 6 deletions
+1 -1
View File
@@ -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)」);② 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 顶部导航区以 `**长文**:` 开头的那一行(写成「[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 不检查这三处。
- 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。
+13 -4
View File
@@ -15,11 +15,20 @@
[![原始文献](https://img.shields.io/badge/%E5%8E%9F%E5%A7%8B%E6%96%87%E7%8C%AE-1300%20%E6%9D%A1%E9%93%BE%E6%8E%A5-565a5f?style=flat-square)](docs/核实记录/)
[![许可](https://img.shields.io/badge/%E8%AE%B8%E5%8F%AF-Unlicense-565a5f?style=flat-square)](LICENSE)
**[打开在线检索页](https://eternity4719.github.io/HowToLiveBetter/)** · [下载 PDF](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.pdf) · [下载 EPUB](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.epub) · [下载离线单文件(HTML)](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.html) · [目录](#目录) · [术语表](#读懂数字术语表) · [核实记录](docs/核实记录/) · [结婚划不划算(长文)](docs/结婚划不划算.md) · [家庭应急装备清单(长文)](docs/家庭应急装备清单.md) · [遇到陌生人出事该不该停(长文)](docs/遇到陌生人出事该不该停.md) · [做平台要办哪些证(长文)](docs/做平台要办哪些证.md) · [生物钟和夜班(长文)](docs/生物钟和夜班.md)
### [打开在线检索页](https://eternity4719.github.io/HowToLiveBetter/) · [让 AI 照书回答(skill)](skills/life-decision-guide/README.md)
其他语言:[English](https://dlgrv.github.io/HowToLiveBetter/en/) · [Русский](https://dlgrv.github.io/HowToLiveBetter/ru/) · [Español](https://dlgrv.github.io/HowToLiveBetter/es/) —— 由 [dlgrv](https://github.com/dlgrv) 维护的非官方翻译([仓库](https://github.com/dlgrv/HowToLiveBetter)),译文按翻译当时的中文正文做,之后新增和改动的条目不一定跟上,一切以本仓库的中文原文为准。
AI 助手 skill 支持 Claude Code 和 Codex。装上后直接问「替朋友担保签不签」,它先查书里的条目再回答,并注明出自第几节第几条。
衍生工具:[howtolivebetter.net](https://howtolivebetter.net/) —— 由 [littleben](https://github.com/littleben) 做的非官方网站,能把条目加进自己的待办清单、标记做到了没有、收藏以后看。网站内容是某一时点导入的,不会自动跟上本书的更新。登录和账号由该网站自己管,和本仓库无关。一切以本仓库原文为准。
**下载**:[PDF](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.pdf) · [EPUB](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.epub) · [离线单文件(HTML)](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.html)<br>
**查阅**:[目录](#目录) · [术语表](#读懂数字术语表) · [核实记录](docs/核实记录/)<br>
**长文**:[结婚划不划算](docs/结婚划不划算.md) · [家庭应急装备清单](docs/家庭应急装备清单.md) · [遇到陌生人出事该不该停](docs/遇到陌生人出事该不该停.md) · [做平台要办哪些证](docs/做平台要办哪些证.md) · [生物钟和夜班](docs/生物钟和夜班.md)
| 其他语言 | 衍生工具 |
| :---: | :---: |
| [English](https://dlgrv.github.io/HowToLiveBetter/en/) · [Русский](https://dlgrv.github.io/HowToLiveBetter/ru/) · [Español](https://dlgrv.github.io/HowToLiveBetter/es/) | [howtolivebetter.net](https://howtolivebetter.net/) |
| [dlgrv](https://github.com/dlgrv) 维护的翻译([仓库](https://github.com/dlgrv/HowToLiveBetter)) | [littleben](https://github.com/littleben) 做的打勾清单:加待办、标记做到没有、收藏 |
<sub>以上两项都不是本仓库维护的,内容按当时的版本导入,不一定跟上后来的改动。网站的登录和账号由对方自己管。一切以本仓库的中文原文为准。</sub>
</div>
@@ -66,10 +75,10 @@
## 怎么读
- **不用全做**:这是一份按性价比排好的备选单,不是任务清单。挑走一两条就算数,剩下的放着,需要时再回来查。「说着容易做着难」这个评价是对的——作者自己也没做到其中大部分,写下来是为了要用的时候找得到。想挑省力的,看下面「只想看最值得做的」那条。
- **想让 AI 帮你查**:仓库里带了一个中文 skill([skills/life-decision-guide](skills/life-decision-guide/)),Claude Code 和 Codex 都能装。装上以后直接问「替朋友担保签不签」「每天通勤两小时值不值」。它会先把相关条目从正文里查出来,再照书里的算账方式排序回答,并注明出自第几节第几条。查不到就说查不到,不自己编数字。装法见 [那个目录的说明](skills/life-decision-guide/README.md)。
- **想按条件挑**:打开[在线检索页](https://eternity4719.github.io/HowToLiveBetter/),可以按关键词、章节、证据等级来筛,也可以按「花不花钱、花多少时间、要不要毅力」这三样筛,几个条件能叠着用。页面上的内容直接取自 book/ 目录里的正文,正文一改,页面跟着改。
- **条目之间会互相指路**(「见第 8 节第 17 条」这种):在检索页里,这种指路带一条虚线。点一下,就地显示被指的那条的标题和「说人话」。想真的翻过去,再按「跳过去」。那一条正好被筛选条件藏起来了,页面会自动把筛选清掉。在 GitHub 上直接读正文点不动,但每处指路后面都写着指向什么(「见第 18 条(借钱写清借条)」)。不翻过去也知道说的是哪条。
- **想按顺序读**:每节内的条目按性价比从高到低排列,从每节前几条开始看就行。
- **想让 AI 帮你查**:仓库里带了一个中文 skill([skills/life-decision-guide](skills/life-decision-guide/)),Claude Code 和 Codex 都能装。装上以后直接问「替朋友担保签不签」「每天通勤两小时值不值」。它会先把相关条目从正文里查出来,再照书里的算账方式排序回答,并注明出自第几节第几条。查不到就说查不到,不自己编数字。装法见 [那个目录的说明](skills/life-decision-guide/README.md)。
- **想离线看、想发给别人**:下载 [离线单文件 HTML](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.html),整本书连同检索和筛选都在这一个文件里,双击就开,不用服务器也不用联网,微信里也能直接传。
- **想打印或在手机上翻**:下载 [PDF](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.pdf),A4 排版、两百多页,带目录页码和书签,每节另起一页。
- **想在 Kindle 或其他阅读器上读**:下载 [EPUB 电子书](https://github.com/eternity4719/HowToLiveBetter/releases/download/epub-latest/HowToLiveBetter.epub),Kindle 用 Send to Kindle 发过去即可。
+2 -1
View File
@@ -451,7 +451,8 @@ abbr.term:hover{border-bottom-color:var(--brand-1);color:var(--brand-1)}
<p>换回的算在谁头上也分档:你自己最高,其次配偶和直系亲属,再次朋友同事,陌生人最低——最低不等于零,只是回报的指望小、要连风险一起看。</p>
<p>不用全做:这是一份按性价比排好的备选单,不是任务清单。挑走一两条就算数,剩下的需要时再回来查——想挑省力的,左边把「花钱」选「不花钱」、「要毅力」选「不用」,剩下的就是。作者自己也没做到其中大部分。正文里带虚线的「第 X 条」可以点开,就地看那条写了什么,不用自己翻过去。</p>
<div class="stat" aria-live="polite">当前显示 <b id="cnt">–</b> 条,共 <span id="tot">–</span> 条</div>
<div class="doc-links">长文:<a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E9%81%87%E5%88%B0%E9%99%8C%E7%94%9F%E4%BA%BA%E5%87%BA%E4%BA%8B%E8%AF%A5%E4%B8%8D%E8%AF%A5%E5%81%9C.md">遇到陌生人出事该不该停</a> · <a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E5%AE%B6%E5%BA%AD%E5%BA%94%E6%80%A5%E8%A3%85%E5%A4%87%E6%B8%85%E5%8D%95.md">家庭应急装备清单</a> · <a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E7%BB%93%E5%A9%9A%E5%88%92%E4%B8%8D%E5%88%92%E7%AE%97.md">结婚划不划算</a> · <a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E5%81%9A%E5%B9%B3%E5%8F%B0%E8%A6%81%E5%8A%9E%E5%93%AA%E4%BA%9B%E8%AF%81.md">做平台要办哪些证</a> · <a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E7%94%9F%E7%89%A9%E9%92%9F%E5%92%8C%E5%A4%9C%E7%8F%AD.md">生物钟和夜班</a></a> · <a href="https://github.com/eternity4719/HowToLiveBetter/tree/main/docs/%E6%A0%B8%E5%AE%9E%E8%AE%B0%E5%BD%95">来源核实记录</a></div>
<div class="doc-links">长文:<a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E9%81%87%E5%88%B0%E9%99%8C%E7%94%9F%E4%BA%BA%E5%87%BA%E4%BA%8B%E8%AF%A5%E4%B8%8D%E8%AF%A5%E5%81%9C.md">遇到陌生人出事该不该停</a> · <a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E5%AE%B6%E5%BA%AD%E5%BA%94%E6%80%A5%E8%A3%85%E5%A4%87%E6%B8%85%E5%8D%95.md">家庭应急装备清单</a> · <a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E7%BB%93%E5%A9%9A%E5%88%92%E4%B8%8D%E5%88%92%E7%AE%97.md">结婚划不划算</a> · <a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E5%81%9A%E5%B9%B3%E5%8F%B0%E8%A6%81%E5%8A%9E%E5%93%AA%E4%BA%9B%E8%AF%81.md">做平台要办哪些证</a> · <a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/docs/%E7%94%9F%E7%89%A9%E9%92%9F%E5%92%8C%E5%A4%9C%E7%8F%AD.md">生物钟和夜班</a> ·<a href="https://github.com/eternity4719/HowToLiveBetter/tree/main/docs/%E6%A0%B8%E5%AE%9E%E8%AE%B0%E5%BD%95">来源核实记录</a></div>
<div class="doc-links">AI 助手:<a href="https://github.com/eternity4719/HowToLiveBetter/blob/main/skills/life-decision-guide/README.md">让 Claude Code 或 Codex 照这本书回答你的问题(skill 装法)</a></div>
<details class="gloss" id="gloss"><summary>看不懂的缩写和名词</summary><p>正文里带虚线的词,点一下或把鼠标放上去就有解释。全表如下。</p><dl></dl></details>
</div>
<div id="list">