Files
HowToLiveBetter/tools/pdf/build.mjs
T
albert4719 ce378ca0f7 生成时间精确到分钟并统一按北京时间显示
一天里正文常改好几轮,Release 说明和三样产物都只写日期,分不出手里是哪一版。
四处人能看见的时间统一成「2026-09-19 13:05(北京时间)」:Release 说明、
PDF 扉页与版本说明、EPUB 版本说明、离线 HTML 页脚。commit 短号原样保留。
CI 跑在 UTC 上,工作流用 date -u -d '+8 hours' 换算,不依赖 runner 的时区库;
node 那三套共用 tools/lib/book.mjs 新增的 buildStamp(),按 Asia/Shanghai 格式化。
EPUB 的 dc:date 仍是纯日期(规范要求),完整时间本来就在 dcterms:modified 里。
顺带:tools/offline/build.mjs 自己又实现了一遍 ROOT/REPO/SITE/read/gitCommit,
改成从公共模块 import,删掉重复实现。
2026-09-19 13:08:52 +08:00

98 lines
5.1 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 把 README + book/*.md + docs/*.md 排成一本 PDF:pandoc 把 Markdown 转成 typst,typst 排版。
// 用法:node tools/pdf/build.mjs [输出路径] 默认输出 dist/HowToLiveBetter.pdf
// 需要 pandoc(≥3.1,要有 typst 输出)和 typst(≥0.13)在 PATH 上,或用环境变量 PANDOC、TYPST 指路径。
// 版面在 tools/pdf/template.typ 里;正文一个字都不改,只做三件事:
// 去掉「← 回总目录」、给每节的标题挂上锚点、把仓库内的链接改成书内跳转或 GitHub 网址。
import { writeFileSync, mkdirSync, statSync } from 'node:fs';
import { resolve, dirname, posix, basename } from 'node:path';
import { execFileSync } from 'node:child_process';
import { ROOT, REPO, SITE, TITLE, read, readBook, gitCommit, buildStamp, stripBackLink } from '../lib/book.mjs';
const OUT = resolve(ROOT, process.argv[2] ?? 'dist/HowToLiveBetter.pdf');
const WORK = resolve(ROOT, 'dist/pdf-build.md');
const PANDOC = process.env.PANDOC ?? 'pandoc';
const TYPST = process.env.TYPST ?? 'typst';
const STAMP = buildStamp(); // 「(北京时间)」写在模板和版本说明里,传给 pandoc 的值保持纯 ASCII
const COMMIT = gitCommit();
const { description, frontMd, contentsMd, bookFiles, docFiles } = readBook();
// ---------- 页(每页一个一级标题,一级标题在 typst 里另起一页) ----------
const anchorOf = new Map();
bookFiles.forEach(f => anchorOf.set(f, 'sec-' + (basename(f).match(/^\d+/)?.[0] ?? anchorOf.size + 1)));
docFiles.forEach((f, i) => anchorOf.set(f, `doc-${i + 1}`));
const pages = [
{ src: 'README.md', md: `# 前言\n\n${description}\n\n${frontMd}`, anchor: 'front' },
{ src: 'README.md', md: contentsMd.replace(/^## 目录/, '# 各节简介'), anchor: 'contents' },
...[...bookFiles, ...docFiles].map(src => ({ src, md: stripBackLink(read(src)), anchor: anchorOf.get(src) })),
{ src: 'README.md', md: aboutMd(), anchor: 'about' },
];
function aboutMd() {
const commitLine = COMMIT ? `- 对应提交:${COMMIT.slice(0, 7)}\n` : '';
return `# 版本说明
这本 PDF 由仓库里的 Markdown 正文自动排版,正文一改就重新排一本。手里这本的版本:
- 生成时间:${STAMP}(北京时间)
${commitLine}- 最新版下载、在线检索、提意见:${REPO}
- 在线检索页(按关键词、章节、证据等级和成本筛选,也能存成单文件离线看):${SITE}
正文里指向书内其他节的链接已改成书内跳转;指向核实记录、许可证这类没排进书的文件的链接改成了 GitHub 网址。
全书以 Unlicense 发布,属于公有领域,可以随意复制、修改、分发。`;
}
// ---------- 链接:书内的改成锚点,书外的改成绝对网址 ----------
function rewriteLinks(md, src) {
return md.replace(/\]\(([^)\s]+)(\s+"[^"]*")?\)/g, (all, href, title) => {
if (/^(https?:|mailto:)/.test(href)) return all;
// README 里指向自身小节的锚点(#目录 这种)在书里不一定有,指回 GitHub 上的 README
if (href.startsWith('#')) return `](${REPO}/blob/main/README.md${href}${title ?? ''})`;
const [path] = href.split('#');
const target = posix.normalize(posix.join(posix.dirname(src), path));
const anchor = anchorOf.get(target);
if (anchor) return `](#${anchor}${title ?? ''})`;
const kind = target.endsWith('/') ? 'tree' : 'blob';
return `](${REPO}/${kind}/main/${target}${title ?? ''})`;
});
}
const body = pages.map(p => {
const md = rewriteLinks(p.md, p.src)
.replace(/<!--[\s\S]*?-->/g, '') // 成本标签这类 HTML 注释不进 PDF
.replace(/^(# .+?)\s*$/m, `$1 {#${p.anchor}}`); // 给这一页的一级标题挂锚点
if (!md.includes(`{#${p.anchor}}`)) throw new Error(`${p.src} 里没找到一级标题,挂不上锚点`);
return md.trim();
}).join('\n\n');
mkdirSync(dirname(OUT), { recursive: true });
writeFileSync(WORK, body);
// ---------- pandoc → typst → pdf ----------
const run = (cmd, args) => {
try {
return execFileSync(cmd, args, { cwd: ROOT, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
} catch (err) {
if (err.code === 'ENOENT') throw new Error(`找不到 ${cmd},装上它或用环境变量 ${cmd === PANDOC ? 'PANDOC' : 'TYPST'} 指到可执行文件`);
throw new Error(`${cmd} 失败:\n${err.stderr || err.stdout || err.message}`);
}
};
const typFile = resolve(ROOT, 'dist/pdf-build.typ');
run(PANDOC, [
'--from=gfm+attributes', '--to=typst', '--wrap=none',
`--template=${resolve(ROOT, 'tools/pdf/template.typ')}`,
'-V', `booktitle=${TITLE}`, '-V', `subtitle=${description}`,
'-V', `builddate=${STAMP}`, '-V', `commit=${COMMIT.slice(0, 7) || '未知'}`,
'-V', `site=${SITE}`, '-V', `repo=${REPO}`,
'-o', typFile, WORK,
]);
const log = run(TYPST, ['compile', typFile, OUT, '--root', ROOT]);
if (log.trim()) console.log(log.trim());
const entries = pages.filter(p => bookFiles.includes(p.src))
.reduce((n, p) => n + p.md.split('\n').filter(l => l.startsWith('### ')).length, 0);
console.log(`已生成 ${OUT}:${bookFiles.length} 节 ${entries} 条,附录 ${docFiles.length} 篇,${(statSync(OUT).size / 1048576).toFixed(1)} MB`);