能否在sphinx_toolbox.collapse折叠块中添加文本格式?
Sphinx Toolbox Collapse扩展标题格式化解决方案
问题核心:collapse扩展的标题默认遵循reStructuredText语法规则,Markdown风格的
*/**标记无法直接解析,自定义角色需确保CSS生效且语法正确。可行解决办法:
使用reStructuredText原生内联角色
直接借助Sphinx内置的:strong:(加粗)和:emphasis:(斜体)角色,无需额外配置:.. collapse:: :strong:`id`: :emphasis:`String` 这里是折叠的内容自定义角色配合CSS
先在文档中声明自定义角色,同时在Sphinx主题的CSS文件中添加对应样式:.. role:: bold :class: bold .. role:: italic :class: italic .. collapse:: :bold:`id` :italic:`String` 这里是折叠的内容CSS样式示例(添加到主题的自定义CSS中):
.bold { font-weight: 700; } .italic { font-style: italic; }Markdown文档兼容(需m2r2等插件)
若使用Markdown格式编写文档,可尝试用引号包裹标题,确保插件解析内联标记:.. collapse:: "**id**: *String*" 这里是折叠的内容
内容的提问来源于stack exchange,提问作者Yerushalmi
相关产品推荐
相关产品推荐

