Sphinx：将 xlsx 数据包含到 rst答案

【问题标题】：Sphinx: include xlsx data into rstSphinx：将 xlsx 数据包含到 rst
【发布时间】：2013-09-17 08:50:40
【问题描述】：

我想要的是在 Sphinx 文档中包含一个 xlsx 表（或者更确切地说是所述文件的数据）。

有没有办法将 xlsx 表格转换为 restructuredText？

【问题讨论】：

【解决方案1】：

您不需要将其转换为 rst。如果您将 xlsx 工作表导出为逗号分隔文件 (csv)，则可以使用 csv-table directive。

最棒的是，您只需在 csv 中设置表格一次，并且每当您更新 xlsx 工作表时，只需再次导出到 csv 到与之前表格相同的位置。

.. csv-table:: The contents of my xlsx sheet exported to mytable.csv
   :widths: 15 40 20
   :header: "Header 1", "Header 2", "Header 3"
   :file: mytable.csv

就是这样。添加与文件中的列一样多的宽度和标题。

请注意，在文档中使用 :file: 选项时会给出安全警告。您可以选择将逗号分隔的文本复制粘贴到文档中。但是，如果您定期更新表格，我发现再次导出到 csv 是最简单的。

【讨论】：

漂亮的解决方案！非常感谢。
如果表格很大，在网页上看起来不太好。

【解决方案2】：

我刚刚发布了sphinxcontrib-excel，它将 xlsx、xls 和 ods 数据（没有样式、字体、图表）嵌入到您的 sphinx 文档中。而且您不需要从 xlsx 转换为 csv，因为库会为它完成。

这里是an example page，它用于直接在 readthedocs.org 中呈现 excel 数据。

【讨论】：