how-to-live-better README

The project's README from github.com/cdyforever/how-to-live-better. As one markdown file: README.md.

高性价比人生指南 · 在线阅读页

一个单文件 HTML 阅读页,把开源书《高性价比人生指南》的全部 32 节、528 条建议 渲染成可搜索的页面。手机上打开就能看,不用装任何东西。

在线阅读: https://cdyforever.github.io/how-to-live-better/

这是什么

原书由 eternity4719/HowToLiveBetter 维护(Unlicense,公有领域),按「性价比」排序,每条写清花掉什么、换回什么、证据多硬, 只引期刊论文和官方文件。

本仓库不是原书的 fork,也不改动原书内容。它只做一件事:把原书正文渲染成一个 自包含的单文件网页,方便在手机和别人的电脑上直接打开。

页面特性

本地使用

不用构建,双击 index.html 即可。

重新生成

# 需要先有一份上游仓库的本地克隆
git clone --depth 1 https://github.com/eternity4719/HowToLiveBetter.git /tmp/upstream

# 全部 32 节
python build.py all -o index.html --repo /tmp/upstream

# 只做某几节
python build.py 1 2 16 --repo /tmp/upstream

源目录也可以用环境变量 HLTB_REPO 指定。

统计口径(条目数、A/B/C 分级、性价比三档)与上游的 tools/sync-stats.ps1 和 index.html 保持一致,生成结果可与上游徽章逐项对照。

自动更新

.github/workflows/rebuild.yml 每天 06:00(北京时间)拉取上游重新生成, 内容有变化才提交。也可以去 Actions 页面手动触发。

授权

原书内容为 Unlicense(公有领域)。本仓库的构建脚本同样不作任何权利保留。

how-to-live-better (cdyforever/how-to-live-better)

Searching Database…

这是什么?一个单一的自包含 HTML 页面,把开源图书《高性价比人生指南》(How to Live Better)——全部 32 个章节、528 条人生建议——渲染成一个可搜索、适合手机阅读的页面。
这是原书的 fork,还是只是它的阅读器?它不是 fork——完全没有改动原书内容,纯粹是一个渲染器,把上游仓库的文本变成一个自包含的网页。
怎么打开阅读?打开在线阅读页面,或者下载仓库后在本地双击 index.html——不需要任何构建步骤。
用它需要联网或装什么工具吗?不需要。页面不依赖任何外部资源——没有 CDN、没有外部字体、没有 fetch 请求——加载后就能完全离线使用。
内容是怎么和原书保持同步的?一个 GitHub Actions 工作流每天北京时间 06:00 拉取上游仓库并重新构建页面,只有内容真正变化时才提交。
每条建议上的 A/B/C 评级是什么意思?每条建议都带有证据强度评级(A/B/C)和性价比分级,反映它引用的研究依据有多扎实。
“说人话”高亮块是什么?它是一个大白话标注,把每条建议里的统计数字翻译成日常说法,并被做成每张卡片上视觉上最醒目的部分。
可以搜索或筛选这些建议吗?可以——有全站关键词搜索且匹配处高亮,还有开关可以只显示 A 级建议或只看大白话摘要。
我能自己从源数据重新生成页面吗?可以,源文件夹可以通过 HLTBREPO 环境变量设置,统计格式与上游仓库的同步脚本一致,输出可以对照它的徽章来校验。
Creator
cdyforever
Size
2 MB
Stars
12.4K
Updated
CommitOct 15
Age
29d
Commits · 90 Days