Предотвращение полужирного текста в ссылках для скачивания в Sphinx Read the Docs

Во время документирования библиотеки Python с использованием Sphinx и темы RTD я связывал некоторые PDF-файлы для загрузки, используя роль :download: Download Text <_download/the_file.pdf>, но по какой-то причине это приводит к ссылкам, которые выглядят так:

Скачать текст

Первое слово обычное, но все последующие слова выделены жирным шрифтом. Это просто довольно раздражает. Есть ли способ остановить выделение полужирным шрифтом 2-го, 3-го и т. д. слов в тексте ссылки для скачивания?


python python-sphinx read-the-docs
person boymeetscode    schedule 21.03.2017    source источник

Ответы (1)


arrow_upward
0
arrow_downward

Отвечая на свой вопрос здесь...

Раньше я переопределял стили темы, поэтому я сделал то же самое здесь.

Я добавил файл CSS с именем theme_overrides.css в папку _static в корневом каталоге Sphinx с содержимым:

/* 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. Но пока я не нашел ни одного.

Затем добавьте в файл conf.py для установки Sphinx следующее:

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

Ссылка на руководства по документации Rackspace на http://rackerlabs.github.io/docs-rackspace/tools/rtd-tables.html для этого решения.

person boymeetscode    schedule 22.03.2017