sphinx 修改默认css样式

首先在我的sphinx quickstart期间,我为我的源和我的构建选择了单独的文件夹选项。

这是一个三步过程:

1.为样式创建文档:
去哪?

在我的conf.py所在的同一目录中(在我的示例中是源代码),我为我的自定义静态文件(样式表,JavaScript)创建了一个文件夹。 我称之为定制。
在它里面,我为样式表创建了一个子文件夹:source/custom/css。
在这个子文件夹中,我将创建我的自定义样式:source/custom/css/my_theme.css。
2.告诉sphinx
现在我们必须告诉sphinx将此文档输出到build/_static/css中,这个目录是Read the Documents主题中包含的样式表所在的同一目录。 我们在conf.py中添加了以下行:

html_static_path=[‘custom’]#Directory for static files。
搞定了。 现在,如果我们进行构建,我们将在同一个目录build/_static/css中拥有RTD样式(theme.css)和自定义的my_theme.css。

3.选择我们的自定义主题
现在我们要告诉sphinx使用我们自定义的my_theme.css,而不是RTD的。 我们在conf.py中添加了这一行:

html_style=‘css/my_theme.css’#Choosing my custom theme.。
在我们的自定义样式表中,第一行应该用@import url(“theme.css”);导入theme.css的样式。

我们已经准备好开始覆盖样式。

更新:还有一个更简单的方法。
1.将您的自定义放在source/_static/css/my_theme.css中。
在您的自定义样式表中,第一行应该使用@import url(“theme.css”);导入theme.css的样式。

这样,您就不用担心搞乱默认样式,如果您的自定义样式表不工作,删除并重新开始。

2.在conf.py中添加以下行:
html_style='css/my_theme.css

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值