在表格中创建内容表

Question

我希望能够在表格中生成目录。例如。这应该 有边框，看起来像这样：

.. tabularcolumns:: |p{10.5cm}|p{1.1cm}|p{1.4cm}|p{1.1cm}|
+----------------------------------------------------+-------+---------+-----+
|                                                    | hw1   |  hw2    | hw3 |
+====================================================+=======+=========+=====+
| heading 1                                          |       |         |     |
+----------------------------------------------------+-------+---------+-----+
| heading 2                                          |       |         |     |
+----------------------------------------------------+-------+---------+-----+
| heading 3                                          |       |         |     |
+----------------------------------------------------+-------+---------+-----+

我想从以下内容自动生成表：

.. toctree::
   :maxdepth: 2

file 1
file 2

输出是html和pdf。

可以这样做吗？或者我是否必须使用docutils解析器或类似的？

Answer 1

您可以修改basic.css，为您的toc设置边框：

第1步：从您的Sphinx构建目录cp _build/html/_static/basic.css _static/

步骤2：将以下行添加到basic.css

div.toctree-wrapper {
    border-collapse: collapse;
}

div.toctree-wrapper li {
    padding: 1px 8px 1px 5px;
    border:1px solid black; 
}

第3步：编辑您的第一个文件，以便在您执行make html

时开始构建

..你应该在你的目录周围看到边框......就像这样