たとえば、markdown/org-mode 形式で書かれたコンピュータ プログラムのマニュアルがあるとします。マニュアルは、章、セクション、サブセクションを含む本として書かれています。
Pandoc がこの Markdown ファイルを HTML に変換できることは知っています。しかし、各章を (たとえば) 独自の HTML ページに変換し、次の章や前の章、セクションにリンクしたい場合はどうすればよいでしょうか。
たとえば、SWIG を文書化した Web サイトを考えてみましょう。http://swig.org/Doc3.0/セクション.htmlこれはまさに、Pandoc の出力をマークダウン ファイル上に表示したい構造です。
私は、latex2html が Latex ファイルに対してこれを行うことができ、Pandoc が markdown を latex に変換できることは知っていますが、結果の出力が気に入りません。外部プログラムを一切使用しない純粋な pandoc ソリューションを希望します。
答え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 …
シェルまたは他のスクリプト言語で記述されたラッパー スクリプトがおそらく役立つでしょう。
ご覧のとおり、これはかなりの作業になります。幸いなことに、誰かがすでにこれをすべて実行し、R パッケージにまとめています。ブックダウン見た目も素晴らしい出力が得られるので、強くお勧めします。