Ayuda: Lista


Esta página de ayuda explica cómo crear y editar listas en la Wikipedia en inglés.

Hay tres tipos de listas: listas desordenadas , listas ordenadas y listas de descripción (también conocidas como listas de definición o listas de asociación ). En las siguientes secciones, se utilizan varios tipos de listas para diferentes ejemplos, pero otros tipos de listas generalmente darán los resultados correspondientes. Las listas ordenadas (numeradas) generalmente deben usarse solo para los elementos de la lista que deben estar en un orden específico, como los pasos en una receta de cocina .

Errores comunes

No debe haber líneas en blanco entre los elementos de la lista. Las líneas en blanco terminan una lista, dividiéndola en dos listas separadas . Esto se ilustra más fácilmente usando una lista ordenada:

En el segundo ejemplo anterior, la numeración se restablece después de la línea en blanco. Este problema es menos notorio con otros tipos de listas, pero aún afecta al código HTML subyacente y puede tener efectos perjudiciales para algunos lectores; consulte WP: LISTGAP para obtener más detalles.

Para que sea una lista, cada línea debe comenzar de la misma manera. Esto es válido para listas mixtas.

Este error también puede ser menos notorio en algunas circunstancias, pero crea listas de elementos únicos de diferentes tipos; además de ser semánticamente incorrecto, esto puede causar efectos secundarios perjudiciales para algunos lectores.

No utilice un punto y coma simplemente para dar un título a una lista. El punto y coma y los dos puntos forman un tipo de lista ; los asteriscos hacen otro.

Todas las técnicas descritas en esta sección se pueden utilizar entre sí y con cualquier tipo de lista, en cualquier nivel de lista.

Párrafos dentro de los elementos de la lista

Por simplicidad, los elementos de la lista en el marcado wiki puro no pueden ser más complejos que un párrafo básico. Un salto de línea en el wikimarkup de un elemento de lista terminará no solo el elemento, sino toda la lista, y restablecerá el contador en listas ordenadas. La separación de elementos de la lista desordenada con líneas en blanco puede parecer aproximadamente normal en la pantalla, pero crea muchas listas separadas de un elemento, lo cual es un problema para las personas que usan lectores de pantalla y no es recomendable por la guía sobre accesibilidad para personas con discapacidades , y también es problemático para el análisis automático del artículo y para la reutilización del contenido de Wikipedia en general.

Los párrafos se pueden crear dentro de los elementos de la lista utilizando el elemento HTML

...

(párrafo) alrededor del segundo párrafo y los siguientes, sin saltos de línea en el wikimarkup :

No lo utilice
como sustituto de

...

; tienen una semántica diferente y no son intercambiables.

Para la legibilidad del código (la mejora es más evidente cuando los párrafos son largos, en lugar de con ejemplos cortos como estos), se pueden crear saltos de línea con comentarios HTML , que comienzan en una línea contra el final del código de esa línea y terminan en otra línea, contra el comienzo del código de esa línea:

Esta técnica se puede utilizar con los otros ejemplos siguientes.

Saltos de línea dentro de los elementos de la lista

Use un solo
para un salto de línea que no sea de párrafo, por ejemplo, cuando no se desee usar una lista anidada porque los subelementos ya están precedidos por números:

Esto debe hacerse con
saltos de línea codificados ; un salto de línea de wikitexto real (es decir, presionar enter/returnmientras se escribe el código fuente) traerá la lista a su fin.

Bloques anidados dentro de elementos de lista

El uso de HTML similar puede proporcionar citas en bloque dentro de los elementos de la lista:

Otro caso como este son los pequeños bloques de código anidados:

La {{fnord}}plantilla tiene dos parámetros:

  1. |foo=Esto indica el nivel foo :
    {{fnord | foo = 20}}
  2. |bar= Esto indica...

Aquí, los saltos de línea aún no pueden ocurrir dentro del elemento de la lista, incluso si están adentro

, y el truco de comentarios HTML no funciona adentro 
, por lo que esta técnica solo es adecuada para ejemplos de código corto . Para los más largos, consulte la etiqueta MediaWiki .

El truco de comentarios HTML funciona entre elementos dentro del mismo elemento de lista:

Continuación de un elemento de la lista después de un subelemento

En HTML, un elemento de lista puede contener varias sublistas, no necesariamente adyacentes; por lo tanto, puede haber partes del elemento de la lista no solo antes de la primera sublista, sino también entre las sublistas y después de la última.

En wikimarkup, desafortunadamente, las sublistas siguen las mismas reglas que las secciones de una página: la única parte posible del elemento de la lista que no está en las sublistas es antes de la primera sublista.

En el caso de una lista de primer nivel no numerada en wikimarkup, esta limitación se puede solucionar de alguna manera dividiendo la lista en varias listas; El texto con sangría entre las listas parciales puede servir visualmente como parte de un elemento de la lista después de una sublista. Sin embargo, muchos lectores encuentran esto confuso, ya que la sangría hace que parezca más una continuación del último elemento de la sublista. Además, esta técnica puede dar, dependiendo de CSS, una línea en blanco antes y después de cada lista, en cuyo caso, para uniformidad, cada elemento de la lista de primer nivel podría convertirse en una lista separada, aunque esto complica aún más el código. Para listas complejas como esta, se recomienda utilizar la técnica {{ lista ordenada }} o {{ lista con viñetas }}, y reemplazar instancias de la versión "rápida y sucia" de wikimarkup con la versión {{ lista ordenada }}.

Las listas numeradas ilustran que lo que debería verse como una lista puede, para el software (y por lo tanto, para los usuarios de lectores de pantalla para personas con discapacidad visual) dar como resultado múltiples listas anidadas. Las listas no numeradas dan un resultado correspondiente, excepto que el problema de reiniciar con 1 no es aplicable.

El último de estos es visualmente confuso y da como resultado un marcado no válido. Provocó la creación de una lista de descripción incrustada pero formada incorrectamente (el

elemento HTML): tiene una definición, indicada por :(en HTML que es
), pero ningún término (el ;elemento faltante , que corresponde a HTML
).


Un nivel más profundo, con un elemento de sublista que continúa después de una sub-sublista, se obtienen aún más líneas en blanco; sin embargo, la continuación de la lista de primer nivel no se ve afectada:

Una vez más, el tercer ejemplo no es deseable, ya que produce un marcado roto y es visualmente confuso de todos modos.

Ver también meta: Plantilla: Demo de lista .

Espaciado entre elementos

Para una lista ordenada con elementos que tienen más de un párrafo, puede ser necesario usar el truco de comentarios HTML mencionado anteriormente para agregar una línea en blanco entre los elementos en el código wikicode para evitar la confusión del editor. Esto se hace con una línea comentada:

# Primer elemento  -># Segundo artículo

Esto no produce un espaciado visible no deseado o un código de lista incorrecto en la página renderizada como lo haría agregar una línea en blanco simple:

  1. Primer elemento
  2. Segundo artículo

El comentario debe comenzar en la misma línea en la que termina el elemento anterior y el comentario debe terminar en su propia línea.

Equivocado:

# Primer elemento -># Segundo artículo

Equivocado:

# Primer elemento-> # Segundo artículo

Si el texto renderizado tiene un problema de legibilidad debido a elementos de lista complejos, o por alguna otra razón se desea espacio entre los elementos de la lista, simplemente agregue un par de saltos de línea HTML explícitos al final de los elementos de la lista:

# Elemento 1 

# Elemento 2

da

  1. Artículo 1

  2. Elemento 2

Compare la versión sin el espaciado:

  1. Artículo 1
  2. Elemento 2

El tipo de lista (qué tipo de marcador aparece antes del elemento de la lista) se puede cambiar en CSS estableciendo la propiedad list-style-type . Esto se puede hacer usando la plantilla {{ Lista ordenada }}:

O, usando HTML:

En una lista numerada con una fuente grande, algunos navegadores no muestran más de dos dígitos (2 espacios de ancho) de sangría, a menos que se aplique una sangría adicional (si hay varias columnas: para cada columna). Esto se soluciona aumentando la sangría predeterminada de 3.2em en 2em más, y se puede hacer de varias maneras:

Cuando utilice

  • elementos de lista HTML explícitos , utilice un espaciado de margen CSS explícito de 4em para duplicar el espaciado predeterminado de 2em. Aunque no es el más simple, este es el método más limpio y versátil , ya que no se basa en ninguna peculiaridad del analizador, ni en el abuso de marcas semánticas con fines puramente visuales. Permite comenzar con un número que no sea 1 ( ver más abajo ). Es el método recomendado para listas complejas .

    El analizador traduce una lista ordenada

      , sin ningún elemento de la lista,
    1. (en este caso, contiene solo otro
        ) a una
        con a style="margin-left: 2em;", lo que provoca la sangría del contenido. Este es un método versátil pero potencialmente confuso , ya que permite comenzar con un número que no sea 1 ( ver más abajo ). Es torpe , innecesariamente complejo y parece HTML inválido . Si bien el analizador lo corrige sobre la marcha, solo los expertos en MediaWiki lo saben, con el resultado de que es probable que otros editores intenten "corregirlo" eliminando lo que parece un
          código redundante .

          Simplemente coloque un HTML explícito

            ...
          alrededor de los elementos de la lista de marcas de wiki. Funciona igual que el ejemplo anterior con el contenido de la "lista ordenada sin ningún elemento de lista", que en sí misma es una lista ordenada, expresada con códigos #; el HTML producido y, por tanto, el renderizado, es el mismo. Este es el método más simple y se recomienda al comenzar una lista simple con el número 1 .

          Una lista de una o más líneas que comienzan con dos puntos crea una lista de descripción HTML5 (anteriormente lista de definiciones en HTML4 y lista de asociaciones en el borrador de HTML5), sin términos para definir / describir / asociar, pero con los elementos como descripciones / definiciones / asociaciones , por lo tanto sangrado. Sin embargo, si los dos puntos están delante de los códigos "*" o "#" de una lista ordenada o desordenada, la lista se trata como una descripción / definición, por lo que toda la lista tiene sangría.

          Método obsoleto : la técnica siguiente produce un marcado deficiente (aunque técnicamente valida DTD ) y abusa del propósito HTML semántico de las listas de descripción para un efecto puramente visual, y por lo tanto es un problema de usabilidad y accesibilidad. Funcionará rápidamente, pero debe reemplazarse con un código más limpio ; ver WP: Manual de estilo / Glosarios para varios enfoques.

          La demostración de la página meta: Ayuda: Lista demuestra que varios de estos métodos muestran todos los dígitos de números de 3 dígitos (es decir, pueden manejar listas de hasta 999 elementos sin problemas de visualización incluso en fuentes bastante grandes).

        1. Es posible especificar un valor inicial con la plantilla {{ lista ordenada }} utilizando los atributos starty value.

          O:

          Alternativamente, solo el elemento de la lista cuyo valor se establece debe escribirse en HTML, el resto de la lista puede usar la sintaxis wiki:

          Esto no funciona por dentro

            ...
          .

          Además de proporcionar numeración automática, la lista numerada también alinea el contenido de los elementos, comparable con el uso de la sintaxis de tabla:

          {|| -| style = "text-align: right" | 9. || Amsterdam| -| style = "text-align: right" | 10. || Rotterdam| -| style = "text-align: right" | 11. || La haya|}

          da

          Esta numeración no automática tiene la ventaja de que si un texto se refiere a los números, la inserción o eliminación de un elemento no perturba la correspondencia.

          Envuelva una lista en {{ Columns-list }} para agregar columnas.

          Esta configuración también funciona con listas numeradas.

          {{ column-list }} es la solución general. Puede combinarlo con cualquier otro tipo de formato de lista, incluidos, entre otros, todos los tipos de sintaxis de lista mencionados en esta página. También funciona con contenido que no son listas.

          Lista numerada de varias columnas

          Si desea hacerlo, puede dividir una lista numerada en varias listas más pequeñas, una por columna. En este caso, es útil especificar un valor inicial para evitar reiniciar desde uno en cada columna. Como se mencionó anteriormente, esto solo es posible con la sintaxis HTML (para la primera columna se puede usar la sintaxis wiki o la sintaxis HTML).

          En combinación con la sangría adicional, usando el |gap=parámetro:

          {{col-begin | width = auto}}{{col-break | gap = 2em}}{{lista ordenada | inicio = 125 | a | bb | ccc}}{{col-break | gap = 2em}}{{lista ordenada | inicio = 128 | ddd | ee | f}}{{col-end}}

          da

          Con la {{ lista numerada de varias columnas }} se puede automatizar el cálculo de los valores iniciales, y solo se debe especificar el primer valor inicial y el número de elementos de cada columna, excepto el último. Para agregar o eliminar un elemento de una columna, es necesario ajustar solo un número, el número de elementos de esa columna, en lugar de cambiar los números iniciales de todas las columnas posteriores.

          {{multi-column numbered list|125|a

        2. bb
        3. ccc|3|
        4. ddd
        5. ee
        6. f}}
        7. Puede especificar el tipo de lista CSS con el parámetro lst:

          {{multi-column numbered list|lst=lower-roman|125|a

        8. bb
        9. ccc|3|
        10. ddd
        11. ee|2|
        12. f}}
        13. {{multi-column numbered list|lst=disc|125|a

        14. bb
        15. ccc|3|
        16. ddd
        17. ee|2|
        18. f}}
        19. Tenga en cuenta que los valores iniciales de cada columna (125, +3, +2) no tienen ningún efecto cuando se utiliza el tipo de lista de disco no numérico.

          También es posible presentar listas cortas utilizando un formato muy básico, como:

          '' Título de la lista: '' ejemplo 1, ejemplo 2, ejemplo 3

          Título de la lista: ejemplo 1, ejemplo 2, ejemplo 3

          Este estilo requiere menos espacio en la página y se prefiere si solo hay unas pocas entradas en la lista, se puede leer fácilmente y no se requiere un punto de edición directo. Los elementos de la lista deben comenzar con una letra minúscula a menos que sean nombres propios.

          Consulte también WP: HLIST .

          Una tabla de una columna es muy similar a una lista, pero permite ordenar. Si el wikitexto en sí ya está ordenado con la misma clave de clasificación, esta ventaja no se aplica. Una tabla de varias columnas permite ordenar en cualquier columna.

          Consulte también Ayuda: Tabla .

          Interacción con elementos flotantes

          Atajo
          • WP: EISL

          Las viñetas y los números de las listas a veces pueden superponerse a las imágenes flotantes a la izquierda, y es posible que las líneas con sangría no aparezcan correctamente al lado de las imágenes flotantes a la izquierda. Por ejemplo:

          La plantilla {{ flowlist }} permite que las listas se mantengan alejadas de estos objetos flotantes a la izquierda:

          [[Archivo: Westminstpalace.jpg | izquierda | pulgar | 100px]]{{ flowlist }} 
        20. elemento de lista A1
        21. elemento de lista B1
        22. elemento de lista B2 continuando elemento de lista A1 < li> elemento de lista A2 {{ endflowlist }}{{lista de flujo }}Primera linea:Segunda linea:: Tercera línea::: Cuarta línea{{ endflowlist }}
        23. Se renderiza como:

          Westminstpalace.jpg
          1. elemento de lista A1
            1. elemento de lista B1
            2. elemento de lista B2
            Continuación del elemento de lista A1
          2. elemento de lista A2
          Westminstpalace.jpg

          Primera linea

          Segunda linea
          Tercera linea
          Cuarta línea

          Este método no funcionará dentro de una tabla, y si su lista es más larga que el elemento flotante, entonces la lista no fluirá alrededor de la imagen como de costumbre, sino que será un bloque, dejando un espacio en blanco debajo del elemento flotante.


          Prácticamente cualquier cosa sobre cómo se muestran las listas se puede personalizar en el extremo del usuario con CSS . Algunos de los ajustes más útiles se describen a continuación. Por supuesto, ingresa el código en el modo Editor de texto; si lo ingresa en el modo WYSIWYG, se ingresa usando caracteres de escape. Además, si ingresa HTML en el Editor de texto y cambia al modo WYSIWYG, el HTML se pierde y se vuelve a convertir a Markdown sin estilos.

          Sangría adicional

          Como se indicó anteriormente , en una lista numerada en una fuente grande, algunos navegadores no muestran más de dos dígitos de ancho de sangría, a menos que se aplique una sangría adicional (si hay varias columnas; luego sangría para cada columna). Si bien esto debería solucionarse en el wikicode, la hoja de estilo CSS del usuario puede solucionar el problema mientras esté presente, aumentando la sangría predeterminada de 3.2em en 2em más:

           ol  {  margen izquierdo :  5.2 em ;}

          Cambiar listas desordenadas a ordenadas

          Con el siguiente estilo CSS de usuario , las listas desordenadas se cambian a listas ordenadas para usuarios videntes ( pero no usuarios que deben usar tecnología de asistencia ). Esto se aplica (en la medida en que el selector de CSS no lo restrinja) a todas las listas ul en el código fuente HTML:ul { list-style: decimal; }

          • los producidos con *
          • aquellos con
              en el wikitexto
          • los producidos por el sistema

          Dado que cada página especial, al igual que otras páginas, tiene una clase basada en el nombre de la página, se puede especificar por separado para cada tipo si las listas deben ordenarse, consulte Ayuda: Contribuciones del usuario # Estilos de usuario y Ayuda: Qué enlaces aquí # Estilos de usuario .

          Sin embargo, no parece posible ordenar todas las listas del historial de páginas (a menos que uno haga todas las listas ordenadas), porque el nombre de la clase se basa en la página para la que se visualiza el historial.

          La forma más fácil de encontrar artículos relevantes para una nueva lista o entradas que faltan en una existente es encontrar la categoría más relevante y verificar sus entradas. A veces, las listas se refieren a cosas que son intersecciones de categorías para las que se puede utilizar la herramienta PetScan .

          También se pueden encontrar artículos más relevantes vinculados en el artículo del tema de la lista y los artículos que ya aparecen en la lista, con mayor frecuencia en sus secciones "Ver también" (si existen) y los "ARTÍCULOS RELACIONADOS" sugeridos automáticamente debajo de ellos.

          Otras formas de encontrar artículos relevantes incluyen buscar en Wikipedia el tema de las listas y buscar en la Web el tema entre comillas "(con sinónimos también entre comillas y anexados después de una OR) y agregar la palabra wikio Wikipediao site:Wikipedia.orga ellos.

          Por último, la herramienta " Qué enlaces aquí " se puede utilizar en el artículo del tema de la lista para encontrar artículos relevantes.

          Para las listas que no requieren que las entradas tengan un artículo de Wikipedia, existen formas adicionales de encontrar entradas relevantes, como listas en sitios web externos (por ejemplo, Goodreads para libros), que generalmente implican búsquedas en la Web.

          • MOS: PLIST , que explica el formato de listas sin viñetas.
          • Wikipedia: Manual de estilos / listas , para estilos sugeridos de listas.
          • Lista de categorías de plantillas de formato .
          • (  {{·}} Y {{•}} , puntos ( intersecciones ) y viñetas que se pueden usar para separar elementos en listas horizontales sin el uso de marcas de lista HTML.
            Un método más accesible, manejable y semánticamente robusto es para usar {{ flatlist }} o la clase "hlist".
          • Wikipedia: manejo de saltos de línea , incluido cómo manejar el ajuste de línea en listas horizontales.
          • Wikipedia: Mesa de ayuda , para hacer preguntas sobre el uso de listas en artículos si no pudo encontrar la información que necesita aquí.