Esta página de ayuda explica cómo crear y formatear listas en la Wikipedia en inglés.
Existen 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 resultados correspondientes. Las listas ordenadas (numeradas) generalmente se deben usar solo para elementos de lista que deben estar en un orden específico, como los pasos de una receta de cocina .
No debe haber líneas en blanco entre los elementos de una lista. Las líneas en blanco terminan una lista y la dividen en dos listas independientes . Esto se ilustra más fácilmente con 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 el código HTML subyacente y puede tener efectos disruptivos para algunos lectores; consulte WP:LISTGAP para obtener más detalles.
Para que una lista sea válida , todas las líneas deben comenzar de la misma manera. Esto es válido para las listas mixtas.
Este error también puede ser menos notorio en algunas circunstancias, pero crea listas de elementos individuales de diferentes tipos; además de ser semánticamente incorrecto, puede causar efectos secundarios perturbadores para algunos lectores.
No utilice un punto y coma simplemente para darle un título a una lista. Los puntos y comas y los dos puntos forman un tipo de lista ; los asteriscos, 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.
Para simplificar, los elementos de una lista en un marcado wiki puro no pueden ser más complejos que un párrafo básico. Un salto de línea en el marcado wiki de un elemento de una lista no solo terminará el elemento, sino la lista entera, y reiniciará el contador en las listas ordenadas. Separar elementos de una lista desordenada con líneas en blanco puede parecer aproximadamente normal en la pantalla, pero crea muchas listas separadas de un solo elemento, lo que es un problema para las personas que usan lectores de pantalla y está desaconsejado por la directriz 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.
Se pueden crear párrafos dentro de los elementos de la lista utilizando el <p>...</p>elemento HTML (párrafo) alrededor del segundo párrafo y los subsiguientes, sin saltos de línea en el wikimarkup :
No lo utilice <br>como sustituto de <p>...</p>; tienen una semántica diferente y no son intercambiables.
Para facilitar la lectura 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.
Utilice un solo carácter <br>para un salto de línea que no sea de párrafo, por ejemplo, cuando no se desea utilizar una lista anidada porque los subelementos ya están precedidos por números:
Esto debe hacerse con <br>saltos de línea codificados; un salto de línea de wikitexto real (es decir, presionar enter/returnmientras se escribe el código fuente) llevará la lista al final.
Un uso similar de HTML puede proporcionar citas en bloque dentro de elementos de lista:
Otro caso como este son pequeños bloques de código anidados:
En este caso, los saltos de línea no pueden ocurrir dentro del elemento de lista, incluso si están dentro de <pre>, y el truco del comentario HTML no funciona dentro de <pre>, por lo que esta técnica solo es adecuada para ejemplos de código cortos . Para ejemplos más largos, consulte la etiqueta MediaWiki <syntaxhighlight>.
El truco del comentario HTML funciona entre elementos dentro del mismo elemento de lista:
En HTML, un elemento de lista puede contener varias sublistas, no necesariamente adyacentes; por lo tanto, puede haber partes del elemento de lista no sólo antes de la primera sublista, sino también entre sublistas y después de la última.
En el marcado wiki, lamentablemente, 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 sublistas es antes de la primera sublista.
En el caso de una lista de primer nivel sin numerar en el wikimarkup, esta limitación se puede solucionar en cierta medida dividiendo la lista en varias listas; el texto sangrado entre las listas parciales puede servir visualmente como parte de un elemento de 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, según el 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 las instancias de la versión de wikimarkup "rápida y sucia" con la versión {{ lista ordenada }} .
Las listas numeradas ilustran que lo que debería parecer una sola lista puede, para el software (y por lo tanto para los usuarios de lectores de pantalla para personas con discapacidad visual), en realidad resultar en 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 mal formada (el <dl>elemento HTML): tiene una definición, indicada por :(en HTML, es <dd>), pero ningún término (el elemento faltante ;, que corresponde a HTML <dt>).
Un nivel más profundo, con un elemento de sublista que continúa después de una subsublista, 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:
Nuevamente, el tercer ejemplo no es deseable, ya que produce un marcado defectuoso y, de todos modos, es visualmente confuso.
Para una lista ordenada con elementos que tienen más de un párrafo, puede ser necesario usar el truco de comentario HTML mencionado anteriormente para agregar una línea en blanco entre los elementos en el código wiki para evitar la confusión del editor. Esto se hace con una línea comentada:
# Primer elemento <!-- --> # Segundo elementoEsto no produce espacios visibles no deseados ni código de lista incorrecto en la página renderizada como lo haría agregar una línea en blanco:
El comentario debe comenzar en la misma línea en la que termina el elemento anterior y el comentario debe finalizar en su propia línea.
Equivocado:
# Primer elemento <!-- --> # Segundo elementoEquivocado:
# Primer elemento <!----> #Segundo elementoSi el texto representado tiene un problema de legibilidad debido a elementos de lista complejos, o por alguna otra razón se desea espacio entre los elementos de lista, simplemente agregue un par de saltos de línea HTML explícitos al final de los elementos de lista:
# Artículo 1 < br >< br > # Artículo 2 < br >< br >da
Compare la versión sin espaciado:
El tipo de lista (el tipo de marcador que aparece antes del elemento de la lista) se puede cambiar en CSS configurando la propiedad list-style-type. Esto se puede hacer usando la plantilla {{ Ordered list }} :
O bien, 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,2 em en 2 em más, y se puede hacer de varias maneras:
Al utilizar <li>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étodo más simple, es el más limpio y versátil , ya que no depende de ninguna peculiaridad del analizador ni del abuso de ningún marcado semántico con fines puramente visuales. Permite comenzar con un número distinto de 1 ( ver más abajo ). Es el método recomendado para listas complejas .
El analizador traduce una lista ordenada, <ol>, sin ningún elemento de lista, <li>(en este caso, contiene sólo otro <ol>) en un <div>con un 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 empezar con un número distinto de 1 ( ver más abajo ). Es torpe , innecesariamente complejo y parece HTML no válido . Aunque el analizador lo corrige sobre la marcha, sólo los expertos de MediaWiki lo saben, con el resultado de que es probable que otros editores intenten "corregirlo" eliminando lo que parece <ol>código redundante.
Simplemente coloque un código HTML explícito <ol>...</ol>alrededor de los elementos de la lista de marcado wiki. Funciona igual que el ejemplo anterior con el contenido de la "lista ordenada sin ningún elemento de lista", que es en sí misma una lista ordenada, expresada con códigos #; el código HTML producido y, por lo tanto, la representación, es el mismo. Este es el método más simple y se recomienda cuando se comienza 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 HTML5), sin términos que se deban definir, describir o asociar, pero con los elementos como descripciones, definiciones y asociaciones, por lo que se los sangra. Sin embargo, si los dos puntos están delante de los códigos "*" o "#" de una lista desordenada u ordenada, la lista se trata como una sola descripción o definición, por lo que se sangra toda la lista.
Método obsoleto : la técnica que se describe a continuación produce un marcado mal formado (aunque técnicamente valida la DTD ) y abusa del propósito semántico del HTML de las listas de descripción para lograr un efecto puramente visual, por lo que es un problema de usabilidad y accesibilidad. Funcionará rápidamente, pero se debe reemplazar por un código más limpio ; consulte WP:Manual of Style/Glossaries para conocer varios enfoques.
Es posible especificar un valor inicial con la plantilla {{ lista ordenada }} utilizando los atributos starty value.
O:
Como alternativa, solo el elemento de la lista cuyo valor se va a establecer debe escribirse en HTML, el resto de la lista puede usar la sintaxis wiki:
Esto no funciona en el interior <ol>...</ol>.
Además de proporcionar numeración automática, la lista numerada también alinea el contenido de los elementos, de forma comparable con el uso de la sintaxis de tabla:
{| |- | style = "text-align: right" | 9. || Ámsterdam |- | style = "text-align: right" | 10. || Róterdam |- | style = "text-align: right" | 11. || La Haya |} da
Esta numeración no automática tiene la ventaja de que si un texto hace referencia a los números, la inserción o eliminación de un elemento no altera la correspondencia.
Envuelva una lista en {{ Columns-list }} para agregar columnas.
Esta configuración también funciona con listas numeradas.
{{ columnas-lista }} es la solución general. Puede combinarla 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 sea una lista.
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 es el preferido 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.
Véase también WP:HLIST .
Una tabla de una columna es muy similar a una lista, pero permite ordenar. Si el wikitexto ya está ordenado con la misma clave de ordenación, esta ventaja no se aplica. Una tabla de varias columnas permite ordenar por cualquier columna.
Véase también Ayuda:Tabla .
Las viñetas y los números de las listas a veces pueden superponerse a las imágenes flotantes a la izquierda, y las líneas sangradas pueden no aparecer correctamente cuando están junto a 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 }} < ol > < li > elemento de lista A1 < ol > < li > elemento de lista B1 </ li > < li > elemento de lista B2 </ li > </ ol > elemento de lista continua A1 </ li > < li > elemento de lista A2 </ li > </ ol > {{ endflowlist }}{{ lista de flujo }}Primera linea: Segunda línea :: Tercera línea ::: Cuarta línea {{ endflowlist }}Se representa como:
Primera linea
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 aspecto de la visualización de las listas se puede personalizar desde el lado del usuario con CSS . A continuación se describen algunos de los ajustes más útiles. Por supuesto, se introduce el código en el modo Editor de texto; si se introduce en modo WYSIWYG, se introduce utilizando caracteres de escape. Además, si se introduce HTML en el Editor de texto y se cambia al modo WYSIWYG, el HTML se pierde y se vuelve a convertir a Markdown sin estilos.
Como se indicó anteriormente, en una lista numerada con 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, en cuyo caso se aplicará una sangría para cada columna). Si bien esto debería solucionarse en el código wiki, la hoja de estilo CSS del usuario puede solucionar el problema mientras esté presente, aumentando la sangría predeterminada de 3,2 em en 2 em más:
ol { margen izquierdo : 5.2 em ;} Con el siguiente estilo CSS de usuario, las listas desordenadas se cambian a listas ordenadas para usuarios videntes ( pero no para usuarios que deben usar tecnología de asistencia ). Esto se aplica (siempre que el selector CSS no lo restrinja) a todas las listas ul en el código fuente HTML:ul { list-style: decimal; }
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:Lo que enlaza aquí#Estilos de usuario .
Sin embargo, no parece posible ordenar todas las listas del historial de páginas (a menos que se ordenen todas las listas), porque el nombre de la clase se basa en la página cuyo historial se visualiza.
La forma más sencilla de encontrar artículos relevantes para una nueva lista o entradas faltantes en una lista existente es buscar la categoría más relevante y consultar sus entradas. A veces, las listas tratan sobre temas 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 al artículo del tema de la lista y a los artículos que ya aparecen en la lista, generalmente en sus secciones "Ver también" (si existen) y en 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 añadidos después de un OR) y añadir la palabra wikio Wikipediao site:Wikipedia.orga ellos.
Por último, la herramienta " Qué enlaza 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.
