Сохранение разрывов строк в сфинксе и примере todolist

Question

Попытка выяснить, как добавить разрывы строк в список задач в sphinx.

Answer 1

Замена |br| не требуется. Этот пример работает и возвращает семантически правильные элементы списка HTML вместо разрывов строк. Если вы не удовлетворены визуальным отображением, вам следует использовать собственный CSS.

.. todo::

    - blah
    - blah
    - blah

<p class="first admonition-title">Todo</p>
<ul class="last simple">
<li>blah</li>
<li>blah</li>
<li>blah</li>
</ul>

Answer 2

Я не смог найти хорошего ответа на это и закончил тем, что собрал несколько разных вещей, которые в итоге сработали.

По сути, я пытался добавить тодолиста в мою документацию по сфинксу. Но .. todolist :: не печатал, а .. todo :: просто выходил длинной строкой без разрывов строки. Поэтому я добавил это в конец моего основного файла index.rst:

.. |br| raw:: html

   <br />

И затем для моего списка задач я сделал это:

.. todo:: 

   - blah |br|
   - blah |br|
   - blah |br|

и в процессе получил окно todo, которое выглядит так:

Надеюсь, это сэкономит кому-то время!