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

问题描述

所以github声称支持README.md文件的重组文本,这很棒,因为我在.csv文件中有一个物料清单,我想通过以下内容添加到README.rst:

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

但是,当我查看my repository上的页面时,所看到的只是标题(如预期的那样)和一些文本,而不是表格。此外,我不知道在哪里可以从github的内部解析引擎中找到任何输出文件来帮助我找出问题所在。当在我的本地计算机上使用狮身人面像进行构建时(表已按预期嵌入),这工作得很好。这里潜在的问题是什么?如何查看github的内部输出,这将为我提供出问题的线索?

解决方法

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