首页 > 解决方案 > 如何在阅读文档中添加电子表格?

问题描述

使用 Read the Docs 将电子表格添加到我的文档的最佳方式是什么?

我正在开发一个生产开源硬件和软件的开源项目。开源硬件项目文档中无处不在的部分是物料清单部分,它通常以电子表格的形式出现,列出构建硬件产品需要购买哪些零件或原材料。BOM 电子表格的每一行都至少包含项目的名称/ID、数量、可以购买的超链接以及项目的价格。

在 BOM 的末尾通常是总价格,它是前几行 (price*qty) 的总和。

阅读文档支持制作表格。有没有办法在表的末尾添加一行,以便该行中的一个字段包含一个公式,该公式用于在编译文档时得出该单元格的值?理想情况下,不需要客户端javascript?

或者,更一般地说,Read the Docs 是否支持将电子表格添加到他们的文档中?

标签: pythonmarkdownspreadsheetrestructuredtextread-the-docs

解决方案


开箱即用的 Sphinx 没有任何功能可以做你想做的事。它可以通过语法从 CSV 文件呈现静态表。csv-table

raw但是,您可以通过指令嵌入托管在第三方服务上的电子表格。

.. raw:: html

    <iframe src="https://remote.sheet/filepath"></iframe>

推荐阅读