Разрывы строк в обычном тексте в Sphinx - PullRequest
Новая
       6

Разрывы строк в обычном тексте в Sphinx

0 голосов
/ 27 апреля 2018

У меня есть следующий текст в файле .rst: 

Some text.
* Heading
  | The first topic.
  | Another topic which is very verbose and spans multiple lines ad infinitum.
  Topic continued......................................

и я хотел бы, чтобы это выглядело как: 

Some text.
* Heading
  The first topic.
  Another topic which is very verbose and spans multiple lines ad infinitum....................
  Topic continued.............

Однако в HTML это выглядит так: 

Some text.
* Heading| The first topic.| Another topic which is very verbose and spans multiple lines ad infinitum .................... Topic continued

Документация Sphinx предлагает использовать символ | для обозначения разрыва строки, как это делают несколько постов здесь, в Stackoverflow, но я не смог заставить его работать. Мне бы хотелось, чтобы метод не зависел от используемого сборщика Сфинкса.

Пустые строки между элементами работают, но не дают желаемого визуального эффекта.

Что мне нужно сделать?

1 Ответ

0 голосов
/ 27 апреля 2018

Сделайте это в два этапа.

Сначала заставьте ваш reStructuredText использовать правильный пробел для создания полезной структуры HTML с примененными визуальными стилями по умолчанию. 

Some text.

* Heading

  | The first topic.
  | Another topic which is very verbose and spans multiple lines ad infinitum.

  Topic continued......................................

Второе переопределение таблицы стилей по умолчанию для создания желаемого визуального эффекта, как описано в этом сообщении SO. Как настроить пользовательские стили для reStructuredText, Sphinx, ReadTheDocs и т. Д .?.

...