將 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

這並不完全是微不足道的。一個好的方法是寫一個 pandoc 使用的自訂 HTML 範本。

% 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 包中：預訂。它產生的輸出非常漂亮，我強烈推薦它。