Question

我用自定义字体制作了一个Sphinx（Readthedocs）项目。

已导出 - http://1ra-manual-dentrenament-basic-de-combat.readthedocs.io/ca/latest/

Github - https://github.com/CavallersDelCel/1RA_EBC/blob/master/docs/index.rst

_static/fonts/LinBiolinum_Kah.ttf

中的自定义字体

我有一个_static / css / custom.css：

@font-face {
    font-family: "Linux Biolinum Keyboard";
    src: url(../fonts/LinBiolinum_Kah.ttf);
}

.keys {
  font-family: "Linux Biolinum Keyboard", sans-serif;
}

在conf.py中我有：

def setup(app):
    app.add_stylesheet('css/custom.css')

在一页中我写道：

<span class="keys">FM</span>

但结果是带有标签的纯文本，而不是带有自定义字体的文本：

html result

Answer 1

你有两个问题。

Docutils（Sphinx用于将reStructuredText转换为HTML的库）将引号转换为其本地化的印刷版本。在这种情况下，"会转换为»。
您希望文本不会被HTML编码，但Sphinx会将HTML实体（<和>）从纯文本转换为HTML编码实体<和{{ 1}}。

要纠正这种情况下的问题，您可能希望使用.. raw:: directive，如下所示：

&gt;

...然后Sphinx应该允许HTML代码正确呈现。

此外，如果您想要内联显示源HTML代码：

.. raw:: html

    <span class="keys">FM</span>

使用css的自定义字体在Sphinx项目中不起作用

1 个答案: