Как сделать вложенные списки с автоматической нумерацией в Sphinx?

Question

Я использую Sphinx для написания документации для программы на Python. Я хотел бы создать упорядоченный список с вложенным списком и с автоматической нумерацией.

Я хотел бы получить что-то вроде этого:

Здесь следует нумерованный список

1. Это первый пункт списка
2. Это второй
   • Второй элемент имеет вложенный список с двумя элементами
   • это последний элемент вложенного списка
3. Родительский список продолжается с третьего элемента

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

Я пытался использовать следующий код:

Here it follows a numbered list

#. This is the first item of the list
#. This is the second one

  * The second item has a nested list with two items
  * this is the last item of the nested list

#. The parent list continues with its third item

И результат, который я получаю, следующий:

Здесь следует нумерованный список

1. Это первый пункт списка

2. Это второй

   • Второй элемент имеет вложенный список с двумя элементами
   • это последний элемент вложенного списка

0,1. Родительский список продолжается с третьего элемента

[Я должен добавить некоторый символ, здесь точка, для 3-го элемента или системы уценки в stackru показывает 3!]

Как видите, нумерация после вложенного списка начинается заново.

Answer 1

Вы должны правильно сделать отступ для двух элементов вложенного списка маркеров, чтобы они соответствовали тексту родительского списка, поэтому просто добавьте пробел, как этот:

#. This is the first item of the list
#. This is the second one

   * The second item has a nested list with two items
   * this is the last item of the nested list

#. The parent list continues with its third item

Полное объяснение здесь