Esta página de ayuda explica cómo crear y formatear 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 definiciones o listas de asociaciones ). 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 deben usarse solo para elementos de la 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 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 el código HTML subyacente y puede tener efectos perturbadores 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 las 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 provocar efectos secundarios perjudiciales 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 forman 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 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 la lista finalizará no solo el elemento sino toda la lista y restablecerá el contador en las listas ordenadas. La separación de elementos de lista desordenados con líneas en blanco puede parecer aproximadamente normal en la pantalla, pero crea muchas listas separadas de un solo elemento, lo cual es un problema para las personas que usan lectores de pantalla y la directriz sobre accesibilidad para personas con discapacidades lo desaconseja , 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 <p>...</p>
elemento HTML (párrafo) alrededor del segundo párrafo y los siguientes, sin saltos de línea en el wikimarkup :
No lo utilice <br>
como sustituto de <p>...</p>
; Tienen semántica diferente y no son intercambiables.
Para mejorar 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 al 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 <br>
para un salto de línea que no sea un 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 wikitext real (es decir, presionar enter/returnmientras se escribe el código fuente) pondrá fin a la lista.
Un uso similar de HTML 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:
Aquí, los saltos de línea aún no pueden ocurrir dentro del elemento de la lista, incluso si están dentro <pre>
, y el truco del comentario HTML no funciona dentro <pre>
, por lo que esta técnica solo es adecuada para ejemplos de código corto . Para los más largos, consulte la etiqueta MediaWiki <syntaxhighlight>.
El truco de los comentarios HTML funciona entre elementos dentro del mismo elemento de la lista:
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 sólo antes de la primera sublista, sino también entre las sublistas y después de la última.
Desafortunadamente, en wikimarkup, 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 sin numerar en wikimarkup, esta limitación se puede solucionar un poco 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, 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 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 lista, para el software (y por tanto para los usuarios de lectores de pantalla para personas con discapacidad visual) en realidad puede resultar en múltiples listas anidadas. Las listas sin numerar dan el resultado correspondiente, excepto que el problema de reiniciar con 1 no es aplicable.
El último de ellos es visualmente confuso y da como resultado un marcado no válido. Causó 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 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:
Nuevamente, el tercer ejemplo no es deseable, ya que produce marcas rotas 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 comentarios 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 elemento
Esto no produce espacios visibles no deseados ni códigos de lista incorrectos en la página representada, 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 terminar en su propia línea.
Equivocado:
# Primer elemento <!-- --> # Segundo elemento
Equivocado:
# Primer elemento <!----> #Segundo elemento
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:
# Artículo 1 < br >< br > # Artículo 2 < br >< br >
da
Compare la versión sin el espaciado:
El tipo de lista (qué tipo de marcador 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 {{ Lista ordenada }} :
O, usando HTML:
En una lista numerada en 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:
Cuando utilice <li>
elementos de lista HTML explícitos, utilice un espacio de margen CSS explícito de 4 em para duplicar el espacio predeterminado de 2 em. Aunque no es el más simple, este es el método 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 solo otro <ol>
) en a <div>
con a style="margin-left: 2em;"
, lo que provoca una sangría en el contenido. Este es un método versátil pero potencialmente confuso , ya que permite comenzar 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 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 en sí misma es una lista ordenada, expresada con códigos #; el HTML producido y, por tanto, la representación, 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 comienza 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 definir/describir/asociar, pero con los elementos como descripciones/definiciones/asociaciones. , por lo tanto sangría. Sin embargo, si los dos puntos están delante de los códigos "*" o "#" de una lista ordenada u desordenada, la lista se trata como una descripción/definición, por lo que se sangra toda la lista.
Método obsoleto : la siguiente técnica produce un marcado mal formado (aunque técnicamente valida DTD ) y abusa del propósito semántico HTML 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 ; consulte WP: Manual de estilo/Glosarios para conocer varios enfoques.
Es posible especificar un valor inicial con la plantilla {{ lista ordenada }} utilizando los atributos start
y value
.
O:
Alternativamente, solo el elemento de la lista cuyo valor se está configurando debe escribirse en HTML; el resto de la lista puede usar la sintaxis wiki:
Esto no funciona por dentro <ol>...</ol>
.
Además de proporcionar una numeración automática, la lista numerada también alinea el contenido de los elementos, de forma comparable al uso de la sintaxis de una tabla:
{| |- | estilo = "alineación de texto: derecha" | 9. || Ámsterdam |- | estilo = "alineación de texto: derecha" | 10. || Róterdam |- | estilo = "alineación de texto: derecha" | 11. || La Haya |}
da
Esta numeración no automática tiene la ventaja de que si un texto hace referencia a 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.
{{ columns-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.
También es posible presentar listas cortas utilizando un formato muy básico, como por ejemplo:
''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.
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 clasificación, esta ventaja no se aplica. Una tabla de varias columnas permite ordenar en cualquier columna.
Consulte también Ayuda:Tabla .
Las viñetas y los números de la lista a veces pueden superponerse a imágenes flotantes a la izquierda y es posible que las líneas sangradas no aparezcan correctamente al lado de 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 todo lo relacionado con cómo se muestran las listas se puede personalizar por parte 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 rebajas sin estilos.
Como se señaló 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; entonces 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 ordenadas para usuarios videntes ( pero no para usuarios que deben usar tecnología de asistencia ). Esto se aplica (en la medida en 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 de los usuarios#Estilos de usuario y Ayuda:Qué vínculos hay 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 para la que se ve el historial.
La forma más sencilla de encontrar artículos relevantes para una lista nueva o entradas faltantes en una existente es encontrar la categoría más relevante y verificar sus entradas. A veces, las listas tratan sobre elementos 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 en los artículos que ya aparecen en la lista, generalmente 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 añadidos después de OR
) y añadirles la palabra wiki
o Wikipedia
o site:Wikipedia.org
.
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 normalmente implican búsquedas en la Web.