修改sphinx_bootstrap_theme方法呈现

时间:2019-05-27 15:25:01

标签: python jinja2 python-sphinx

我有一些API Documentation,我最满意。

我正在使用sphinx_bootstrap_theme来呈现我的文档样式。但是,我想修改每个API方法的呈现方式。

今天的文档看起来像这样: ccp_jumbled

我想对bootstrap主题做些小的改动,这样我就可以在每个方法之间获得一个HR,如下所示: ccp_segmented

问题:
我在哪里修改sphinx_bootstrap_theme以便可以自定义这些方法的呈现?

我浏览了sphinx_bootstrap_theme templates,但似乎找不到合适的模板来使这项工作正常进行。

如果要查看如何配置文档,可以找到源树here

1 个答案:

答案 0 :(得分:1)

通常,调整原始代码有点棘手。我个人迄今为止很满意的事情是用adding a custom css覆盖了现有样式,以实现一些小的更改。我的操作方式:

  • css下创建一个名为source/_static的文件夹
  • 添加包含所需更改的新CSS(例如:custom.css)文件。
  • 将以下代码添加到您的conf.py
def setup(app):
    app.add_stylesheet('css/custom.css')
  • 保存并构建

有关更多信息,请检查this