python-sphinx - 在表格内创建目录

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

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