ReadTheDocs 在没有我的 HTML 表格的情况下生成 PDF答案

【问题标题】：ReadTheDocs generates PDFs without my HTML tablesReadTheDocs 在没有我的 HTML 表格的情况下生成 PDF
【发布时间】：2016-04-27 23:17:29
【问题描述】：

我们正在转换一个相当大的文档以在 ReadTheDocs 上托管。我们对 Markdown 表格语法所支持的简单表示不满意，因此我们将表格编码为 HTML。在 HTML 查看器中非常好（例如，http://manual.cytoscape.org/en/latest/Command_Line_Arguments.html 的结尾）。

在 ReadTheDocs 生成的 PDF 版本中，我们的每个表格都完全缺失（参见第 9 页 https://media.readthedocs.org/pdf/cytoscape-working-copy/latest/cytoscape-working-copy.pdf）。

我们将表格编码为 HTML 是否犯了一个错误？我们是否可以采取不同的方式并在 HTML 和 PDF 中获得漂亮的表格？

任何建议都会有所帮助...

谢谢！

【问题讨论】：

那个
非常适合 cloudfornatter.com/css2pdf 的设计目的。我是作者，这样的页面就是我们创建应用程序的原因。
Kevin ...感谢您指出这一点。我想我看到 css2pdf 会将体内网络内容转换为 PDF。这不是这里的用例。据我所知，ReadTheDocs 将 .MD 文件转换为 HTML 或 PDF。 HTML 路线很好，因为我的表格是 HTML 格式的，所以一切都很好。在进行 PDF 格式化路线时，它似乎正在删除 HTML 格式的表格。因此，为了在此处应用 css2pdf，它必须在 MD 到 PDF 的转换过程中由 ReadTheDocs 以某种方式激活。我没有看到如何将 css2pdf 连接到其中。你能进一步解释一下吗？谢谢！
如果您的概念是将一些带有（可能）CSS 的独特标记发送到某个应用程序以创建它，那么您可能是正确的。如果你在那个页面上放一个按钮，上面写着“PDF”我......那么你就是对的。

【解决方案1】：

我自己没有使用过 ReadTheDocs，但是通过阅读他们的 Getting Started 指南，我假设您使用的是 Sphinx？虽然 Markdown 支持嵌入原始 HTML，但 Sphinx 不支持将其转换为其他格式。

您应该考虑改用 reStructuredText（Sphinx 的原生标记格式），因为它比 Markdown 先进得多。如果您需要，它甚至可以使用自定义指令和角色进行扩展。但请务必先检查 reStructuredText tables 是否提供您所需的灵活性。 Pandoc 可以将你的 Markdown 文件转换为 reStructuredText。

我看到您正在使用表格来记录命令行选项。 reStructuredText 支持使用option lists 记录命令行选项。理论上，您可以更改选项列表在输出文档中的表示方式，但这可能并不容易实现，尤其是对于使用 LaTeX 的 PDF 输出（无耻插件：使用rinohtype 进行 PDF 输出应该会让这在未来变得更容易)。

【讨论】：

谢谢，Brecht ... 一个中肯的建议，我很感激这个建议。我会研究 reStructuredText 看看它能让我们走多远。