viñetas varios una tipos sirven que para numerada niveles multinivel lista las hacer ejemplos con como haskell haddock

haskell - varios - Atadura lista numerada continuación



viñetas ejemplos (1)

No puedes. Estás usando >>> . Para que esto se represente como ejemplo, debe estar al principio del párrafo.

¿Qué se considera un comienzo del párrafo?

  • Cualquier cosa al comienzo de un comentario de Haddock, omitiendo cualquier espacio en blanco que lo precede.

  • Cualquier cosa siguiendo una línea vacía.

En su escenario, tiene 4 párrafos: elemento de lista, elemento de lista, ejemplo, elemento de lista. Internamente, Haddock ignora por completo los números de lista que está anotando: podría comenzar desde 999 si quisiera. Cuando Haddock ve párrafos consecutivos con el mismo tipo de lista, los une y los numera. A medida que se rompe el patrón, las listas no se tratan como una continuación. La sangría >>> con espacios no tiene ningún sentido en este escenario, ya que se eliminarán ya que estamos en un nuevo párrafo. Tenga en cuenta que los espacios son importantes si tiene ejemplos consecutivos: puede ponerlos en el mismo párrafo siempre que su sangría sea idéntica.

Otras cosas que deben estar en su propio párrafo (y, por lo tanto, romperán el orden de la lista) son listas, birdtracks, codeblocks (párrafo que contiene solo texto entre @ s) y propiedades ( prop> ).

Si bien esto podría resolverse permitiendo el anidamiento de párrafos, esto no está planeado. El boleto n. ° 27 es únicamente sobre listas de anidamiento (que resultan ser entidades de nivel de párrafo) pero no resolvería este problema.

Recomiendo que use listas desordenadas si los números no son vitales o engañan un poco y usan listas con nombre ( [name] content )

EDITAR: A partir del 12 de enero de 2014, el trac.haskell.org/haddock/ticket/27 se resolvió y ahora es posible sangrando los 4 espacios del ejemplo después del segundo elemento de la lista. Esta:

1. First element 2. Second element >>> your example your example result 3. Third element

Ahora resulta en:

Artículos de la lista anidada de Haddock http://fuuzetsu.co.uk/images/1389605057.png

¿Cómo continuar una lista numerada con la herramienta de documentación de eglefino? Las siguientes líneas en eglefino

-- 1. First line. -- -- 2. Second line with instructions to do something -- -- >>> command-linecmd param -- -- 3. Third line.. --

generar el siguiente html:

</p><ol><li> First line. </li><li> Second line with instructions to do something </li></ol><pre class="screen"><code class="prompt">&gt;&gt;&gt; </code><strong class="userinput"><code>command-linecmd param </code></strong></pre><ol><li> Third line.. </li></ol>

Esto rompe la numeración. ¿Hay alguna forma de hacer que el eglefino continúe con el tercer número también en HTML o debo probar con otra opción (>>> da un buen formato, por qué me gustaría usarlo)?