sphinx customize css template from default theme 自定义default theme的css模板

python 文档工具 sphinx 默认生成的表格在表现复杂内容的时候，
有点乏力。

表格的左右没有线条很不整齐啊。。（个人意见）

其实，文档里面说的很清楚，如下地址：

http://sphinx.pocoo.org/latest/theming.html#static-templates

 

---

做法很简单，在 conf.py 中，指定了

html_static_path = ['_static']

把从

C:\Python27\Lib\site-packages\Sphinx-1.1.3-py2.7.egg\sphinx\themes\default\static

这里找到的

default.css_t 

拷贝到与 conf.py 相对路径里面的 _static 目录里面，最后填上这些内容。

table.docutils {

    border: 3px solid;

    border-collapse: collapse;

}



table.docutils td, table.docutils th {

    border: 1px solid #aaa;

    border-bottom: 1px solid #aaa;

    padding: 1px 8px 1px 5px;

}

 

 注意，貌似sphinx如果发现其它文件都没有更新，貌似不会检测default.css_t文件写入。

最好同时touch 一下其它源文件，重新生成html。

---

english version

---

1.

copy C:\Python27\Lib\site-packages\Sphinx-1.1.3-py2.7.egg\sphinx\themes\default\static\default.css_t workspace\project\doc\source\_static\

2.

append these text to `default.css_t`

table.docutils {

    border: 3px solid;

    border-collapse: collapse;

}



table.docutils td, table.docutils th {

    border: 1px solid #aaa;

    border-bottom: 1px solid #aaa;

    padding: 1px 8px 1px 5px;

}

3. re-generate html document.

make clean; make html