python – 自定义sphinxdoc主题

有没有一种简单的方法来定制现有的sphinxdoc主题?对于默认主题,有许多主题属性,但在sphinxdoc中,我甚至无法设置徽标或更改某些颜色?

或者你能推荐一个我可以学习如何修改主题的网站吗?

最佳答案
我只想在我的sphinx doc中添加ReST strikethrough.我是这样做的:

$cd my-sphinx-dir
$mkdir -p theme/static
$touch theme/theme.conf
$touch theme/static/style.css

在theme / theme.conf中:

[theme]
inherit = default
stylesheet = style.css
pygments_style = pygments.css

(这使它看起来像默认主题(l.2))

在theme / static / style.css中:

@import url("default.css"); /* make sure to sync this with the base theme's css filename */

.strike {
    text-decoration: line-through;
}

然后,在你的conf.py中:

html_theme = 'theme' # use the theme in subdir 'theme'
html_theme_path = ['.'] # make sphinx search for themes in current dir

更多这里:https://sphinx.readthedocs.io/en/master/theming.html.

(可选)在global.rst中:

.. role:: strike
   :class: strike

在一个例子中:

.. include:: global.rst

:strike:`This looks like it is outdated.`

转载注明原文:python – 自定义sphinxdoc主题 - 代码日志