Ayuda:Listas

From mediawiki.org
This page is a translated version of the page Help:Lists and the translation is 89% complete.
Outdated translations are marked like this.
PD Nota: Cuando editas esta página, aceptas liberar tu contribución bajo la licencia CC0. Para más información mira las páginas de ayuda de dominio público.
PD

Esta página trata acerca de crear listas en MediaWiki.

Conceptos básicos de listas

MediaWiki Ofrece tres tipos de listas: listas ordenadas, listas desordenadas, y listas de definiciones. En las secciones siguientes, se usan listas ordenadas para los ejemplos. Las listas desordenadas darían resultados correspondientes.

Basically

Unordered lists
Each item is on a new line starting with an asterisk * e.g. * item.
Ordered lists
Each item is on a new line starting with a hash # e.g. # item.
Definition lists
Each item has two parts : the term and the description
The term is on a new line starting with a semicolon ; e.g. ; term.
The description follows on the same line after a colon : e.g.; term : description,
or the description starts its own line with a colon : e.g. : description (there can be several descriptions per term, each one starting with a colon on a new line).


A little bit further

In the following sections, ordered lists are used for examples. Unordered lists would give corresponding results.

Wikitexto Resultado
* Las listas son fáciles de hacer:
** empieza cada línea
* con un asterisco
** más asteriscos significan
*** niveles más profundos
  • Las listas son fáciles de hacer:
    • empieza cada línea
  • con un asterisco
    • más asteriscos significan
      • niveles más profundos
* Un salto de línea
* en una lista  
marca el fin de la lista. 
Naturalmente
* puedes
* empezar otra vez.
  • Un salto de línea
  • en una lista

marca el fin de la lista. Naturalmente

  • puedes
  • empezar otra vez.
# Las listas numeradas son buenas
## muy organizadas
## fáciles de seguir
  1. Las listas numeradas son buenas
    1. muy organizadas
    2. fáciles de seguir
* Puedes también
** romper líneas
** de este modo
  • Puedes también
    • romper líneas
    • de este modo
; Listas de definición
; Elemento : definición
; punto y coma más el término
: dos puntos más la definición
Listas de definición
Elemento
definición
punto y coma más el término
dos puntos más la definición
; Listas de definición mixta
; elemento 1 : definición
:; sub-elemento 1 más el término
:: dos veces dos puntos más la definición
:; sub-elemento 2 : dos puntos más la definición
; elemento 2 
: De vuelta a la lista principal
Listas de definición mixta
elemento 1
definición
sub-elemento 1 más el término
dos veces dos puntos más la definición
sub-elemento 2
dos puntos más la definición
elemento 2
De vuelta a la lista principal
* O crear listas mixtas
*# y anidarlas 
*#* así
*#*; definiciones
*#*: trabajo:
*#*; manzana
*#*; banana
*#*: frutas
  • O crear listas mixtas
    1. y anidarlas
      • así
        definiciones
        trabajo:
        manzana
        banana
        frutas

Párrafos en listas

Por simplicidad, los elementos de una lista en código wiki no pueden ser más largos que un párrafo. Un salto de línea acabará la lista y reiniciará el contador en las listas ordenadas. Separar los elementos en listas desordenadas no tiene efectos visibles normalmente.

Los párrafos pueden ser forzados en las listas usando etiquetas de HTML. Dos símbolos de salto de línea, <br /><br />, creará el efecto deseado. También lo hará envolver todo excepto el primer párrafo con ‎<p>...‎</p>.

Continuar un elemento de lista después de un sub-elemento

En HTML, un elemento de lista puede contener varias sub-listas, no necesariamente adyacentes; así, puede haber partes del elemento de lista no sólo antes de la primera sub-lista, sino también entre sub-listas, y después de la última. Sin embargo, en la sintaxis wiki, las sub-listas siguen las mismas reglas que las secciones de una página: la única parte posible del elemento de lista que no esté en una sub-lista es antes de la primera sub-lista.

En el caso de una lista no-numerada de primer nivel en wikitexto, esta limitación puede superarse separando la lista en múltiples listas; un texto "sangrado" entre las listas parciales puede parecer visualmente como parte de un elemento después de una sub-lista; sin embargo, esto puede traer consigo, según el CSS, una línea en blanco antes y después de cada lista, en cuyo caso, para uniformidad, cada elemento de lista de primer nivel podría convertirse en una lista separada.

Las listas numeradas ilustran que, lo que podría parecer una lista, para el software consiste de múltiples listas; las listas desordenadas dan el resultado correspondiente, excepto que el problema de reiniciar con 1 no aplica.

Wikitexto Resultado
<ol>
  <li>elemento de lista A1
    <ol>
      <li>elemento de lista B1</li>
      <li>elemento de lista B2</li>
    </ol>continuando elemento de lista A1
  </li>
  <li>elemento de lista A2</li>
</ol>
  1. elemento de lista A1
    1. elemento de lista B1
    2. elemento de lista B2
    continuando elemento de lista A1
  2. elemento de lista A2
vs.
#elemento A1
##elemento B1
##elemento B2
#:continuando elemento A1
#elemento A2
  1. elemento A1
    1. elemento B1
    2. elemento B2
    continuando elemento A1
  2. elemento A2

En un nivel más profundo, con un elemento de sub-lista continuando después de una sub-sub-lista, se consiguen aún más líneas en blanco; sin embargo, la continuación de la lista de primer nivel no se afecta:

Wikitexto Resultado
#elemento A1
##elemento B1
###elemento C1
##:continuando elemento B1
##elemento B2
#elemento A2
  1. elemento A1
    1. elemento B1
      1. elemento C1
      continuando elemento B1
    2. elemento B2
  2. elemento A2

Véase también m:Template:List demo.

It is possible to embed unnumbered bullets inside enclosing numbered items:

Wikitexto Resultado
# list item A
#* nested bullet A1
#* nested bullet A2
# continuing list item B
#* nested bullet B1
#* nested bullet B2
  1. list item A
    • nested bullet A1
    • nested bullet A2
  2. continuing list item B
    • nested bullet B1
    • nested bullet B2

Cambiando el tipo de lista

Por lista

El tipo de lista (qué tipo de marcador aparece antes del elemento de lista) puede ser cambiado en CSS usando la propiedad list-style-type:

Wikitexto Representación
<ol style="list-style-type:lower-roman">
  <li>Sobre el autor</li>
  <li>Prefacio a la primera edición</li>
  <li>Prefacio a la segunda edición</li>
</ol>
  1. Sobre el autor
  2. Prefacio a la primera edición
  3. Prefacio a la segunda edición
<ol style="list-style-type:lower-alpha">
  <li>Sobre el autor</li>
  <li>Prefacio a la primera edición</li>
  <li>Prefacio a la segunda edición</li>
</ol>
  1. Sobre el autor
  2. Prefacio a la primera edición
  3. Prefacio a la segunda edición

Site-wide

The standard #, ##, ### wikitext can be used alongisde CSS in MediaWiki:Common.css to produce the usual system of numbered lists (1, 2, 3; then a, b, c; then i, ii, iii):

ol { 
	list-style-type: decimal; 
}
ol li > ol { 
	list-style-type: lower-alpha; 
}
ol li > ol li > ol { 
	list-style-type: lower-roman; 
}

The first ol above is the default, so not necessary unless some other list-style-type is required.

Wikitext Rendering
#list item A1
##list item B1
###list item C1
###list item C2
##list item B2
#list item A2
  1. list item A1
    1. list item B1
      1. list item C1
      2. list item C2
    2. list item B2
  2. list item A2

Sangría extra de listas

En una lista numerada en una fuente grande, algunos navegadores no muestran más de dos dígitos, a no ser que la sangría extra está aplicada (si hay columnas múltiples: para cada columna). Esto puede ser hecho con CSS:

ol { margin-left: 2cm}

o alternativamente, como está abajo.

Wikitexto Resultado Comentarios
:#abc
:#def
:#ghi
 
  1. abc
  2. def
  3. ghi
Una lista de una o más líneas que comienzan con dos puntos crea una lista de descripción sin términos de definición y con los elementos como descripciones de definición, por lo tanto, con sangría. 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 descripción de definición, por lo que se sangra toda la lista.
<ul>
  <ol>
    <li>abc</li>
    <li>def</li>
    <li>ghi</li>
  </ol>
</ul>
    1. abc
    2. def
    3. ghi
MediaWiki traduce una lista desordenada (ul) sin ningún elemento de la lista (li) en un div con un style="margin-left: 2em", lo que provoca una sangría en el contenido. Este es el método más versátil, ya que permite comenzar con un número distinto de 1, ver más abajo.
<ul>
#abc
#def
#ghi
</ul>
    1. abc
    2. def
    3. ghi
Como arriba, con el contenido de la "lista desordenada sin elementos de lista", que en sí misma es una lista ordenada, expresada con códigos #. El HTML producido y, por lo tanto, el resultado es el mismo. Este es el método recomendado al comenzar la lista en 1.

Para demostrar que todos los tres métodos muestran todos los dígitos de números de 3 dígitos, ve Lista demo.

Especificando un valor inicial

Especificar un valor inicial es posible con sintaxis de HTML.

<ol start="9">
<li>Ámsterdam</li>
<li>Róterdam</li>
<li>La Haya</li>
</ol>
  1. Ámsterdam
  2. Róterdam
  3. La Haya

O:

<ol>
<li value="9">Ámsterdam</li>
<li value="8">Róterdam</li>
<li value="7">La Haya</li>
</ol>
  1. Ámsterdam
  2. Róterdam
  3. La Haya

Comparación con una tabla

Aparte de proporcionar numeración automática, la lista numerada también alinea los contenidos de los elementos, comparable con utilizar sintaxis de tabla:

{|
|-
| align=right |  9.|| Ámsterdam
|-
| align=right | 10.|| Róterdam
|-
| align=right | 11.|| La Haya
|}

da:

9. Ámsterdam
10. Róterdam
11. La Haya

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

Lista multicolumnas

Véase también Template:Col-begin, Template:Col-break, Template:Col-end.

Lista con viñetas multicolumna

<div style="column-count:2">
* manzana
* alfombra
* geografía
* montaña
* ningún lado
* franqueo
* andrajoso
* tostada
</div>

da:

  • manzana
  • alfombra
  • geografía
  • montaña
  • ningún lado
  • franqueo
  • andrajoso
  • tostada
<div style="column-count:3">
* manzana
* alfombra
* geografía
* montaña
* ningún lado
* franqueo
* andrajoso
* tostada
</div>

da:

  • manzana
  • alfombra
  • geografía
  • montaña
  • ningún lado
  • franqueo
  • andrajoso
  • tostada

Lista numerada multicolumna

<div style="column-count:3">
# manzana
# alfombra
# geografía
# montaña
# ningún lado
# franqueo
# andrajoso
# tostada
</div>

da:

  1. manzana
  2. alfombra
  3. geografía
  4. montaña
  5. ningún lado
  6. franqueo
  7. andrajoso
  8. tostada

Abajo se especifica un valor inicial, con sintaxis HTML (para la primera columna el sintaxis wiki o HTML pueden ser usados).

En combinación con la sangría extra explicada en la sección anterior:

{| valign="top"
|-
|<ul><ol start="125"><li>a</li><li>bb</li><li>ccc</li></ol></ul>
|<ul><ol start="128"><li>ddd</li><li>ee</li><li>f</li></ol></ul>
|}

da:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    3. f

Usando m:Template:multi-column numbered list, el cálculo de los valores iniciales se puede automatizar, y solo se debe especificar el primer valor inicial y la cantidad de elementos en cada columna, excepto el último. Agregar un elemento o eliminar un elemento de una columna requiere ajustar solo un número, el número de elementos en esa columna, en lugar de cambiar los números iniciales para todas las columnas posteriores.

{{Multi-column numbered list|125|a<li>bb<li>ccc|3|<li>ddd<li>ee<li>f}}

da:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    3. f
{{Multi-column numbered list|lst=lower-alpha|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}

da:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f
{{Multi-column numbered list|lst=lower-roman|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}

da:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f
{{Multi-column numbered list|lst=disc||a<li>bb<li>ccc||<li>ddd<li>ee||<li>f}}

da:

    1. a
    2. bb
    3. ccc
    1. ddd
    2. ee
    1. f

Estilo aerodinámico o estilo horizontal

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

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

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

Este estilo requiere menos espacio en la página, y es preferido si solo hay algunas pocas entradas en la lista, puede ser fácil de leer, y no se requiere un punto final directo. Los ítems de la lista deben empezar con minúscula a menos que sean nombres propios.

Tablas

Una tabla unicolumna es muy similar a una lista, pero permite ordenarla. Si el wikitexto por sí solo ya está ordenado con la misma clave de ordenación, no se aplica esta ventaja. Una tabla multicolumna permite ordenar cualquier columna.

Ve también Cuándo usar tablas.

Cambiar listas no ordenadas a ordenadas

Con CSS

ul { list-style: decimal }

las listas no ordenadas son cambiadas a ordenadas. Esto aplica (siempre que el selector CSS no lo restrinja) para todas las listas "ul" en el código HTML.

  • aquellas producidas con *
  • aquellas con ‎<ul> en el wikitexto
  • aquellas producidas por el sistema

Ya que cada página especial, como otras páginas, tiene una clase basada en el nombre de página, uno puede especificar separadamente cada tipo si las listas deben estar ordenadas, ve Contribuciones del usuario y Lo que enlaza aquí.

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 visualiza el historial.

Véase también