python-sphinx - 狮身人面像 : include xlsx data into rst

Question

我想要的是在 Sphinx 文档中包含一个 xlsx 表(或者更确切地说是所述文件的数据)。
有什么方法可以将 xlsx 工作表转换为 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 最容易。