Блог

Главная - Вопросы по программированию - Отсутствует пустая строка с тегом вручную между абзацами в реструктурированном тексте

Отсутствует пустая строка с тегом вручную между абзацами в реструктурированном тексте

#python-sphinx #restructuredtext

Вопрос:

Моя реструктурированная текстовая разметка выглядит следующим образом:

 `pybliometrics.scopus.exception.Scopus404Error: NOT FOUND`
    The entity you are looking for does not exist.  Check that your identifier is still pointing to the item you are looking for.

`pybliometrics.scopus.exception.Scopus414Error: TOO LARGE`
    The query string you are using is too long.  Break it up in smaller pieces.

.. _Scopus429Error:

`pybliometrics.scopus.exception.Scopus429Error: QUOTA EXCEEDED`
    Your provided API key's weekly quota has been depleted.  If you provided multiple keys in your :doc:`configuration file <../configuration>`, this means all your keys are depleted.  In this case, wait up to week until your API key's quota has been reset.

В выводе я пропускаю пустую строку прямо там, где я поставил _Scopus429Error тег вручную:

Пропущенная строка между абзацами

Для просмотра в реальном времени нажмите здесь.

Что я могу с этим поделать? Я попытался добавить a | , но полученное пространство слишком велико.

Комментарии:

1. Я могу воспроизвести это с алебастровой темой. Но это выглядит нормально с другими темами, например, природа и sphinxdoc.

2. Я не считал тему причиной, хорошо, что ты узнал!

Ответ №1:

Метка ссылки разбивает список определений на два, и в теме отсутствует нижнее заполнение или поля в конце списка определений. Вы можете добавить этот стиль в custom.css файл и включить его в свой conf.py как параметр конфигурации html_css_files .

пользовательский.css

 dl {
  margin-bottom: 1em;
}

conf.py

 html_css_files = ['custom.css']

Комментарии:

1. Не похоже, что это работает ( pybliometrics.readthedocs.io/en/latest/… ). Что я сделал не так в github.com/pybliometrics-dev/pybliometrics/commit/… ?

2. Попробуйте ввести custom.css docs/_static и установить свое html_static_path значение _static . Правильная комбинация путей к файлам скопирует файл CSS в каталог сборки. Также проверьте, что загружается: pybliometrics.readthedocs.io/en/latest/_static/custom.css

Метки: