在表内部创建目录表

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时启动构建。>

..您应该在目录周围看到边框...像这样