Как убрать выделение внутренней гиперссылки в документации sphinx

Перекрестные ссылки в sphinx выполняются с использованием ref , например:

.. _my-reference-label:

Section to cross-reference
--------------------------

This is the text of the section.

It refers to the section itself, see :ref:`my-reference-label`.

При компиляции в HTML приведенный выше код вводит гиперссылку после слова «see», но также вставляет ее в тег <em>, из-за чего внутренние ссылки выглядят иначе, чем внешние гиперссылки.

Есть ли способ указать sphinx не выделять внутренние ссылки, то есть не вставлять их в тег <em>?


css python-sphinx cross-reference restructuredtext
person Blaz Zupan    schedule 14.12.2013    source источник

Ответы (2)


arrow_upward
2
arrow_downward

Вы можете добавить строку в свой файл CSS:

a.internal {font-style: normal}

Чтобы Sphinx мог использовать пользовательский файл CSS, вам нужно отредактировать conf.py:

html_style = 'my_style.css'

Затем поместите файл в каталог _static или любой другой каталог, который вы объявили с помощью html_static_path.

Тогда my_style.css может выглядеть так:

@import url("default.css");  /* This should be the file used by your theme */

/* Internal links */
a.internal {font-style: normal}

Это не избавит вас от окружающего тега <em>, но поможет правильно оформить ваши документы.

person Steven Almeroth    schedule 18.01.2014
comment
Последняя строка кода должна читаться как a.internal em {.... Эм отсутствует. Как сейчас, это не работает. - person Torsten Bronger; 04.11.2014

arrow_upward
1
arrow_downward

Вы можете написать свою собственную тему и template, чтобы сделать это.

person Steve Barnes    schedule 14.12.2013