如何在Sphinx/reStructured Text中增加固定宽度的字体大小？

Question

我正在使用Sphinx生成使用reStructured Text作为标记的文档.但是,当我使用一些内联格式来使文本以固定宽度字体显示时,--no-cache呈现的HTML会以较小的字体显示文本.

如何在Sphinx/reStructured Text中增加固定宽度的字体大小,使其与普通文本字体大小匹配？

回答

在Chris的帮助下,我能够覆盖CSS中的默认字体样式以增加固定宽度的字体大小:

1)编辑conf.py以指定html主题和css文件:

html_theme = 'default'
html_sytle = 'overrides.css'

2)接下来,我创建了一个static/overrides.css包含以下内容的新css文件:

@import url("default.css");

tt {
    font-size: 130%;
}

我选择使用130%因为default.css定义了这个:

div.body p, div.body dd, div.body li {
    text-align: justify;
    line-height: 130%;
}

现在我在生成的html中获得固定宽度文本匹配常规文本.

Answer 1

无论您使用哪种主题,都可以编辑CSS样式表.例如,对于默认主题,您可以编辑default.css_t文件.具体来说,您可以在第274行的规则中指定增加font-size(例如,使用font-size: 1.1em或类似).pre