使用 README.rst 将 csv 表添加到 github答案

【问题标题】：Adding csv tables to github using README.rst使用 README.rst 将 csv 表添加到 github
【发布时间】：2020-10-10 15:44:17
【问题描述】：

所以 github 声称支持 README.md 文件的重组文本，这很好，因为我在 .csv 文件中有一份材料清单，我想通过以下方式将其添加到我的 README.rst：

.. csv-table::
    :widths: 25 25 25 25
    :file: bom.csv

但是，当我查看my repository 上的页面时，我看到的只是标题（如预期的那样）和一些文本，而不是表格。此外，我不知道在哪里可以从 github 的内部解析引擎中找到任何输出文件来帮助我找出问题所在。在我的本地机器上使用 sphinx 构建时，这工作得很好（表按预期嵌入）。这里的潜在问题是什么，我如何查看 github 的内部输出，这会给我一个关于哪里出了问题的线索？

【问题讨论】：

GitHub 对渲染 reStructuredText 的支持有限。如果您的唯一目的是在 GitHub 上呈现文件，则应该使用 markdown。

标签： github restructuredtext

【解决方案1】：

CSV 表是 Sphinx 风格的 rST 的一个功能，而不是普通的 Docutils rST。 GitHub 使用的是普通的。您必须在 GH 上使用简单表或网格表，请参阅 https://docutils.sourceforge.io/docs/user/rst/quickref.html#tables

【讨论】：

谢谢！太糟糕了，他们不支持 reST，但我明白了。增加了开销和复杂性。