¿Cómo crear una lista anidada en reStructuredText?

90

Estoy tratando de crear una lista correctamente anidada usando el siguiente código (siguiendo los documentos de Sphinx y docutils ):

1. X

  a. U
  b. V
  c. W

2. Y
3. Z

Espero que esto dé como resultado dos OLs, pero obtengo el siguiente resultado:

<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>

¿Qué estoy haciendo mal? ¿No es posible obtener el siguiente resultado?

<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>

markup restructuredtext python-sphinx

— muhuk
fuente

107

Asegúrese de que la lista anidada tenga sangría al mismo nivel que el texto de la lista principal (o tres caracteres, el que sea mayor), así:

1. X

   a. U
   b. V
   c. W

2. Y
3. Z

Entonces obtendrá el resultado que esperaba.

— ddbeck
fuente

4

Parece que esto no es exactamente correcto. En mi caso, estaba usando *como indicador de lista y cuando sangré mi siguiente línea los dos caracteres necesarios para alinearse con el texto de la lista principal, mi lista se trató como una lista separada dentro de una cita en bloque. La regla empírica que he encontrado es que la lista interior debe tener una sangría de al menos tres caracteres .

— Akrikos

@Akrikos ¡Gracias! Actualicé la respuesta para incluir esa advertencia.

— ddbeck

36

Si desea que Sphinx se encargue de la numeración por usted, haga esto.

#. X
#. Y

   #. u 
   #. v 

#. Z

— zsoobhan
fuente

6

Simplemente volviendo a resaltar este detalle, ya que todavía se aplica: uyv deben tener una sangría de al menos 3 espacios (no 2 espacios), para que coincida con el texto del nivel principal. De lo contrario, obtendrá "1. Z" en lugar de "3. Z".

— S. Kirby

2

@ S.Kirby También parece que uno debe sangrar más, si se usa un elemento de lista como iii., que usa más lugares. Parece que el texto tiene que estar alineado y parece que no hay un recuento específico de espacios que se pueda usar para todos los casos.

— Zelphir Kaltstahl

3

Tenga en cuenta que las líneas vacías adicionales también son importantes aquí. Por lo tanto, necesitará 3 espacios para cada elemento de la sublista anidada, y encima y debajo de una línea vacía.

— flazzarini