mirror of
https://github.com/eternity4719/HowToLiveBetter.git
synced 2026-11-20 08:40:44 +08:00
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,删掉重复实现。
98 lines
5.1 KiB
JavaScript
98 lines
5.1 KiB
JavaScript
// 把 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`);
|