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

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

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

.. |br| raw:: html

   <br />

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

.. todo:: 

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

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

Надеюсь, это поможет кому-то!

Замена |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>