如何添加自定义CSS文件?以下conf.py
不起作用:
html_static_path = ['_static']
html_theme = 'default'
html_theme_options = {
'cssfiles': ['_static/style.css']
}
字符串
测试结果:
$ make html
Running Sphinx v1.2.2
loading pickled environment... not yet created
building [html]: targets for 2 source files that are out of date
updating environment: 2 added, 0 changed, 0 removed
reading sources... [ 50%] help
reading sources... [100%] index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents...
Theme error:
unsupported theme option 'cssfiles' given
型
4条答案
按热度按时间ct3nt3jp1#
一个简单的方法是将其添加到
conf.py
:字符串
然后将文件放入
_static/css/
文件夹。p4tfgftt2#
你应该能够通过扩展默认的sphinx主题来包含自定义css。在你的conf.py中,你可以指定你对主题的扩展在哪里,比如。
字符串
然后,在_templates中,您将创建一个名为'layout.html'的默认主题的扩展,其中将包含您的cssfiles,例如。
型
请参阅sphinx在templating上的文档以获取更多信息。
fhg3lkii3#
您可以通过
html_theme_options
配置的选项取决于主题。查看主题theme.conf
的[options]
部分以了解可用的选项。但是,在全局基础上,您可以在
conf.py
中定义html_context
以覆盖css_files
的设置(以及script_files
):字符串
(For参考,看看Sphinx的
builders.html.StandaloneHTMLBuilder.prepare_writing()
,看看self.globalcontext
是如何填充的。vvppvyoh4#
我用的是Sphinx 3.2。
我可以通过以下方式添加一些简单的自定义CSS:
html_static_path = ['_static']
下面的conf.py
中添加这一行:字符串
docs/_static/
并添加css/custom.css
$ make html
Source