Як створити вкладений список у reStructuredText?


90

Я намагаюся створити належним чином вкладений список, використовуючи такий код (наступні документи Sphinx та Docutils ):

1. X

  a. U
  b. V
  c. W

2. Y
3. Z

Я очікую, що це призведе за два OLсекунди, але замість цього я отримаю такий результат:

<ol class="arabic simple"> 
  <li>X</li> 
</ol> 

<blockquote> 
  <div>
    <ol class="loweralpha simple"> 
      <li>U</li> 
      <li>V</li> 
      <li>W</li> 
    </ol> 
  </div>
</blockquote> 

<ol class="arabic simple" start="2"> 
  <li>Y</li> 
  <li>Z</li> 
</ol> 

Що я роблю не так? Чи неможливо отримати такий результат?

<ol class="arabic simple"> 
  <li>X
    <ol class="loweralpha simple"> 
      <li>U</li> 
      <li>V</li> 
      <li>W</li> 
    </ol> 
  </li>
  <li>Y</li> 
  <li>Z</li> 
</ol> 

Відповіді:


107

Переконайтеся, що вкладений список має відступ до того ж рівня, що і текст батьківського списку (або три символи, залежно від того, який із значень більший), наприклад:

1. X

   a. U
   b. V
   c. W

2. Y
3. Z

Тоді ви отримаєте результат, який очікували.


4
Здається, це не зовсім правильно. У моєму випадку я використовував *як індикатор списку, і коли я відступав у наступному рядку два символи, необхідні для вирівнювання з текстом батьківського списку, мій список трактувався як окремий список всередині блок-цитати. Я знайшов емпіричне правило, що внутрішній список повинен мати відступи принаймні з трьох символів .
Акрікос

@Akrikos Дякую! Я оновив відповідь, включивши це застереження.
ddbeck 06.03.18

36

Якщо ви хочете, щоб Сфінкс подбав про нумерацію, зробіть це.

#. X
#. Y

   #. u 
   #. v 

#. Z

6
Просто повторно виділивши цю деталь, оскільки вона все ще застосовується: u та v повинні мати відступи принаймні 3 пробіли (а не 2 пробіли), щоб відповідати тексту батьківського рівня. В іншому випадку ви отримаєте "1. Z" замість "3. Z".
С. Кірбі,

2
@ S.Kirby Також здається, що потрібно робити відступи більше, якщо використовується елемент списку типу iii., який використовує більше місць. Здається, текст повинен бути вирівняний, і, здається, не існує певної кількості пробілів, які можна використовувати для всіх випадків.
Зельфір Кальцталь

3
Зверніть увагу, що тут також важливі зайві порожні рядки. Отже, вам знадобляться 3 пробіли для кожного елемента вкладеного підспису, а також над і під порожнім рядком.
flazzarini
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.