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

Question

Перекрестные ссылки на сфинкса делается с помощью 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, выше будет ввести гиперссылку после «см», но также будет вставлять его в тег <em>, делая внутренние ссылки отличными от внешних гиперссылок.

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

Answer 1

Вы можете написать свой собственный theme и template для этого.

Answer 2

Вы можете добавить строку в файл 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> тега, но должно работать правильно стилизовать ваши документы.