将 Markdown 文件转换为一系列 HTML 文件

Question

假设我有一本以 markdown/org-mode 格式编写的计算机程序手册。该手册以书的形式编写，包含章节、部分和小节。

我知道 Pandoc 可以将这个 Markdown 文件转换为 HTML。但是，如果我想将每个章节（比如说）转换为自己的 HTML 页面并链接到下一章或上一节，该怎么办？

例如，考虑记录 SWIG 的网站。http://swig.org/Doc3.0/Sections.html这正是我希望 Pandoc 输出在我的 markdown 文件上的结构。

我知道 latex2html 可以对 Latex 文件执行此操作，并且 Pandoc 可以将 markdown 转换为 latex，但我不喜欢最终的输出。我更喜欢不涉及任何外部程序的纯 pandoc 解决方案。

Answer 1

这并不完全是小事。一个好的方法是编写一个自定义 HTML 模板供 pandoc 使用。

% pandoc -D html > my-page-template.html
# edit my-page-template.html to your liking

该模板可以包含上一页和下一页的链接（如果有）。

$if(next-page)$<a href="$next-page$">next</a>$endif$

相应的文件名将通过命令行传递，因此 pandoc 可以插入正确的值。

pandoc -M next-page=introduction.html --template=my-page-template.html …

用 shell 或其他脚本语言编写的包装脚本可能会有用。

---

如你所见，这可能需要做很多工作。幸运的是，有人已经完成了所有这些工作并将其打包在 R 包中：预订。它的输出效果非常好，我强烈推荐它。