python-sphinx - Sphinx：将 xlsx 数据包含到 rst

Question

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

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

Answer 1

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

很棒的是，您只需要在 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，因为该库已为它完成了它。

这是一个示例页面，它用于直接在 readthedocs.org 中呈现 excel 数据。