html - 如何将具有单独样式 tex 文件的多个 tex 文件转换为 rst 格式，以便通过 Sphinx 与它们一起制作 HTML？

Question

我有多个 tex 文件，每个文件对应一些手册的一章，以及主要的 tex 文件，包含样式并将它们收集到一个中。我需要从所有这些中制作 HTML。我知道可以这样完成：tex -> 通过 Pandoc 标记，标记 -> rst 也使用 Pandoc，然后 rst -> HTML 通过 Sphinx。但我找不到有关详细信息的信息。任何帮助都会很棒。

Answer 1

如果您的原始来源包含您希望在 HTML 中显示的所有信息（即您不会使用任何额外的解释、自动提取的文档字符串等），那么请考虑仅使用一种工具而不是通过 sphinx。 Pandoc是一个很棒的工具，但您也可以考虑TeX 文档站点上描述的选项之一，例如latex2html.

另请注意，您通常不需要使用 pandoc 单独完成各个阶段：它可以将 LaTeX 直接转换为 HTML。例如：

pandoc -s source.tex -o web.html

如果您确实发现需要转换为其他格式，pandoc 演示页面提供了一种快速方法，其中包含许多语法示例。