Sphinx：将xlxs数据包含在rst中

Question

我想要的是将xlxs表（或者说所述文件的数据）包含在Sphinx文档中。

有没有办法将xlxs表转换为restructuredText？

Answer 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。

Answer 2

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

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