如何使用pandoc将目录添加到R Markdown HTML文件中？

Question

如何使用pandoc在R Markdown HTML文件中添加目录，但保留所有HTML格式和标题信息？

例如，如果我有一个名为test.html的文件，我尝试：

pandoc -s -S --toc test.html -o test-toc.html

这会添加目录，但会删除已有的页头信息，使所有格式都不太美观。

因此，它会使此HTML文件看起来像这个。我想保留格式。

- Jeromy Anglim

Answer 1

我不确定如何告诉Pandoc保留所有样式和标题信息。然而，假设这个样式并没有改变很多，那么为什么不将其复制到一个.css样式表文件中，并在生成输出HTML时指向该文件（使用-c或--css命令行选项）？您可以使用--self-contained命令行选项告诉Pandoc将此样式表信息嵌入到最终输出中（有关选项的完整列表，请参见此处）。

对于输入HTML文件中的MathJax脚本，您可以使用

--mathjax=https://c328740.ssl.cf1.rackcdn.com/mathjax/2.0-latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML

最后，你可以使用R语法高亮

--include-in-header=r_syntax.html

其中r_syntax.html包含适当的JavaScript，并用<script>标签包装。

更新：尽管如此，您可以将所有样式和脚本信息包含在单个文件中（例如r_styling.html），并在输出HTML的头部末尾包含它。

pandoc -s -S --toc -h r_styling.html --self-contained test.html -o test-toc.html

-h选项是--include-in-header的简写。

- Chris