在Sphinx中预防下载链接中的粗体文本阅读文档

Question

在使用Sphinx和RTD主题记录python库的过程中，我使用:download: Download Text <_download/the_file.pdf>角色链接了一些PDF文件以供下载，但由于某种原因，这会产生如下链接：

下载文字

第一个单词是正常的，但所有后面的单词都是粗体。这很烦人。有没有办法在下载链接文本中停止第2，第3等单词的粗体字？

Answer 1

在这里回答我自己的问题......

之前我已经覆盖了主题样式，所以我在这里做了同样的事情。

我将一个名为theme_overrides.css的CSS文件添加到Sphinx根目录中的_static文件夹中，其中包含以下内容：

/* override the bold words in download links */
@media screen and (min-width:767px) {

    .rst-content code.xref {
    /* !important prevents the common CSS stylesheets from overriding
         this as on RTD they are loaded after this stylesheet */
        font-weight: inherit !important;
    }
}

唯一令我担心的是，这可能会删除使用.rst-content code.xref样式的其他地方的粗体字体。但到目前为止，我还没有找到任何。

然后将以下内容添加到用于Sphinx设置的conf.py文件中：

html_context = {
    'css_files': [
        '_static/theme_overrides.css',  # override bold download text in RTD theme
        ],
     }

感谢http://rackerlabs.github.io/docs-rackspace/tools/rtd-tables.html针对此解决方案的Rackspace文档指南。