Jump to content

Ajuda:Llistes

From mediawiki.org
This page is a translated version of the page Help:Lists and the translation is 99% complete.
Outdated translations are marked like this.
PD Nota: Quan modifiqueu aquesta pàgina, esteu acceptant que la vostra contribució es publiqui en el marc de CC0. Mireu Pàgines d'ajuda de domini públic per a més informació.
Algunes versions antigues d'aquesta pàgina s'han importat sota la llicència CC BY-SA. Només les contribucions noves són de domini públic.
PD

Aquesta pàgina tracta de com crear llistes a MediaWiki.

Conceptes bàsics de llistes

MediaWiki ofereix tres tipus de llistes: llistes no ordenades, llistes ordenades i llistes de definicions.

Bàsicament

Llistes no ordenades
Cada element que es troba en una línia nova comença amb un asterisc * p. ex. * element.
Llistes ordenades
Cada element que es troba en una línia nova comença amb un coixinet # p. ex. # element.
Llistes de definicions
Cada element té dues parts: el terme i la descripció
El terme que està en una línia nova comença amb un punt i coma ; per exemple ; terme.
La descripció segueix en la mateixa línia després dels dos punts : p. ex. ; terme : descripció,
o la descripció comença la seva pròpia línia amb dos punts : p. ex. : descripció (hi pot haver diverses descripcions per terme, cadascuna començant amb dos punts en una línia nova).

Una mica més enllà

A la taula següent trobareu alguns exemples d'ambdós mètodes:

Text wiki Resultat
* Les llistes són fàcils de fer:
** comença cada línia
* amb un asterisc
** més asteriscs signifiquen
*** nivells més profunds
  • Les llistes són fàcils de fer:
    • comença cada línia
  • amb un asterisc
    • més asteriscs signifiquen
      • nivells més profunds
* Una línia nova 
* en una llista 
marca el final de la llista. 
Per descomptat 
* podeu 
* tornar a començar.
  • Una línia nova
  • en una llista

marca el final de la llista. Per descomptat

  • podeu
  • tornar a començar.
# Les llistes numerades van bé, són:
## molt organitzades
## fàcils de seguir
  1. Les llistes numerades van bé, són:
    1. molt organitzades
    2. fàcils de seguir
* També podeu 
** trencar línies 
** d'aquesta manera
  • També podeu
    • trencar línies
    • d'aquesta manera
; Llistes de descripció amb definició 
; terme: definició
; punt i coma més terme
: dos punts més definició
Llistes de definició
terme
definició
punt i coma més terme
dos punts més definició
; Llistes de definició mixtes
; element 1: definició
:; subelement 1 més terme
:: dos punts més definició
:; subelement 2: dos punts més definició
; element 2
: torna a la llista principal
Llistes de definició mixtes
element 1
definició
subelement 1 més terme
dos punts més definició
subelement 2
dos punts més definició
element 2
torna a la llista principal
*O creeu llistes mixtes 
*# i niueu-les 
*#* com aquesta 
*#*; definicions 
*#*: treball: 
*#*; poma 
*#*; plàtan 
*#*: fruits
  • O creeu llistes mixtes
    1. i niueu-les
      • com aquesta
        definicions
        treball:
        poma
        plàtan
        fruits

Múltiple línia en les llistes

Per simplicitat, els elements de la llista en el marcatge wiki no poden ser més llargs que un paràgraf. Una línia en blanc a continuació d'una llista la finalitzarà i restablirà el comptador a les llistes ordenades. Separar els elements d'una llista no ordenada normalment no té efectes notables.

Els paràgrafs es poden forçar a les llistes utilitzant etiquetes HTML. Si voleu posar més d'una línia de text, afegiu dos símbols de salt de línia, <br /><br />, i obtindreu l'efecte desitjat. En fer ajustament del text en ‎<p>...‎</p> es presentarà el text en un paràgraf nou, que s'iniciarà en la seva pròpia línia quan es representi.

Continuar un element de llista després d'un subelement

En HTML, un element de llista pot contenir diverses subllistes, no necessàriament adjacents; per tant, pot haver-hi parts de l'element de llista no només abans de la primera subllista, sinó també entre subllistes, i després de l'última. No obstant això, en la sintaxi wiki, les subllistes segueixen les mateixes regles que les seccions d'una pàgina: l'única part possible de l'element de la llista que no es troba a les subllistes és abans de la primera subllista.

En el cas d'una llista de primer nivell sense numeració en el codi wiki, aquesta limitació es pot superar dividint la llista en múltiples llistes; el text sagnat entre les llistes parcials pot servir visualment com a part d'un element de llista després d'una subllista; tanmateix, això pot donar, depenent de CSS, una línia en blanc abans i després de cada llista, en aquest cas, per uniformitat, cada element de llista de primer nivell es podria convertir en una llista separada.

Les llistes numerades il·lustren que el que hauria de semblar una llista pot, per al programari, consistir en múltiples llistes; les llistes sense numerar donen un resultat corresponent, excepte que el problema de reiniciar amb 1 no és aplicable.

Text wiki Resultat
<ol>
  <li>element de llista A1
    <ol>
      <li>element de llista B1</li>
      <li>element de llista B2</li>
    </ol>continuant element de llista A1
  </li>
  <li>element de llista A2</li>
</ol>
  1. element de llista A1
    1. element de llista B1
    2. element de llista B2
    continuant element de llista A1
  2. element de llista A2
vs.
#element de llista A1
##element de llista B1
##element de llista B2
#:continuant element de llista A1
#element de llista A2
  1. element de llista A1
    1. element de llista B1
    2. element de llista B2
    continuant element de llista A1
  2. element de llista A2

Un nivell més profund, amb un element de subllista que continua després d'una subsubllista, s'obtenen fins i tot més línies en blanc; no obstant això, la continuació de la llista de primer nivell no es veu afectada:

Text wiki Resultat
#element de llista A1
##element de llista B1
###element de llista C1
##:continuant element de llista B1
##element de llista B2
#element de llista A2
  1. element de llista A1
    1. element de llista B1
      1. element de llista C1
      continuant element de llista B1
    2. element de llista B2
  2. element de llista A2

Vegeu també m:Template:List demo.

És possible incrustar pics sense numerar dins dels elements numerats que tanquen:

Text wiki Resultat
# 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

Canviar el tipus de llista

Per llista

El tipus de llista (el tipus de marcador que apareix abans de l'element de llista) es pot canviar a CSS establint la propietat list-style-type:

Text wiki Resultat
<ol style="list-style-type:lower-roman">
  <li>Sobre l'autor</li>
  <li>Prefaci a la primera edició</li>
  <li>Prefaci a la segona edició</li>
</ol>
  1. Sobre l'autor
  2. Prefaci a la primera edició
  3. Prefaci a la segona edició
<ol style="list-style-type:lower-alpha">
  <li>Sobre l'autor</li>
  <li>Prefaci a la primera edició</li>
  <li>Prefaci a la segona edició</li>
</ol>
  1. Sobre l'autor
  2. Prefaci a la primera edició
  3. Prefaci a la segona edició

Lloc-ample

El wikitext estàndard #, ##, ### es pot utilitzar juntament amb CSS a MediaWiki:Common.css per produir el sistema habitual de llistes numerades (1, 2, 3; després a, b, c; després 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; 
}

El primer ol anterior és el predeterminat, per tant no és necessari llevat que es requereixi algun altre tipus d'estil de llista.

Wikitext Resultat
#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

Sagnia extra de llistes

En una llista numerada en una font gran, alguns navegadors no mostren més de dos dígits, llevat que s'apliqui un sagnat addicional (si hi ha múltiples dos punts: per a cada dos punts). Això es pot fer amb CSS:

ol { margin-left: 2cm}

o alternativament, com es mostra a sota.

Wikitext Resultat Comentaris
:#abc
:#def
:#ghi
 
  1. abc
  2. def
  3. ghi
Una llista d'una o més línies que comencin amb dos punts crea una llista de descripció sense termes de definició, i amb els elements com a descripcions de definició, per tant, sagnats. No obstant això, si els dos punts estan davant dels codis "*" o "#" d'una llista no ordenada o ordenada, la llista es tractarà com una descripció de definició, de manera que tota la llista estarà sagnada.
<ul>
  <ol>
    <li>abc</li>
    <li>def</li>
    <li>ghi</li>
  </ol>
</ul>
    1. abc
    2. def
    3. ghi
MediaWiki tradueix una llista desordenada (ul) sense cap element de llista (li) en un div amb un style="margin-left: 2em", causant el sagnat del contingut. Aquest és el "mètode més versàtil", ja que permet començar amb un número diferent d'1, vegeu més avall.
<ul>
#abc
#def
#ghi
</ul>
    1. abc
    2. def
    3. ghi
Com a més amunt, amb el contingut de la "llista sense ordenar sense cap element de llista", que en si és una llista ordenada, expressada amb codis #. L'HTML produït, i per tant la representació, és el mateix. Aquest és el mètode recomanat quan s'inicia la llista amb un 1.


Especificant un valor inicial

L'especificació d'un valor inicial és possible amb sintaxi HTML.

<ol start="9">
<li>Amsterdam</li>
<li>Rotterdam</li>
<li>La Haia</li>
</ol>
  1. Amsterdam
  2. Rotterdam
  3. La Haia

O:

<ol>
<li value="9">Amsterdam</li>
<li value="8">Rotterdam</li>
<li value="7">La Haia</li>
</ol>
  1. Amsterdam
  2. Rotterdam
  3. La Haia

Comparació amb una taula

A part de proporcionar numeració automàtica, la llista numerada també alinea el contingut dels elements, comparable amb l'ús de la sintaxi d'una taula:

{|
|-
| align=right |  9.|| Amsterdam
|-
| align=right | 10.|| Rotterdam
|-
| align=right | 11.|| La Haia
|}

dona:

9. Amsterdam
10. Rotterdam
11. La Haia

Aquesta numeració no automàtica té l'avantatge que si un text es refereix als nombres, la inserció o supressió d'un element no pertorba la correspondència.

Llistes multicolumna

Vegeu també els Template:Col-begin, Template:Col-break, Template:Col-end.

Llista amb pics multicolumna

<div style="column-count:2">
* poma
* catifa
* geografia
* muntanya
* enlloc
* franqueig
* estripat
* torrada
</div>

dona:

  • poma
  • catifa
  • geografia
  • muntanya
  • enlloc
  • franqueig
  • estripat
  • torrada
<div style="column-count:3">
* poma
* catifa
* geografia
* muntanya
* enlloc
* franqueig
* estripat
* torrada
</div>

dona:

  • poma
  • catifa
  • geografia
  • muntanya
  • enlloc
  • franqueig
  • estripat
  • torrada

Lista numerada multicolumna

<div style="column-count:3">
# poma
# catifa
# geografia
# muntanya
# enlloc
# franqueig
# estripat
# torrada
</div>

dona:

  1. poma
  2. catifa
  3. geografia
  4. muntanya
  5. enlloc
  6. franqueig
  7. estripat
  8. torrada

A continuació s'especifica un valor inicial, amb sintaxi HTML (per a la primera columna es pot utilitzar sintaxi wiki o sintaxi HTML).

En combinació amb el sagnat addicional explicat a la secció 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>
|}

dona:

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

Utilitzant m:Template:multi-column numbered list el càlcul dels valors inicials es pot automatitzar, i només cal especificar el primer valor inicial i el nombre d'elements de cada columna, excepte l'últim. Afegir un element a, o eliminar-lo d'una columna requereix ajustar només un número, el nombre d'elements en aquesta columna, en lloc de canviar els números inicials per a totes les columnes posteriors.

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

dona:

    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}}

dona:

    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}}

dona:

    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}}

dona:

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

Estil en una línia o horitzontal

També és possible presentar llistes curtes utilitzant un format molt bàsic, com ara:

''Títol de la llista:'' exemple 1, exemple 2, exemple 3

Títol de la llista: exemple 1, exemple 2, exemple 3

Aquest estil requereix menys espai a la pàgina, i es prefereix si només hi ha unes poques entrades a la llista, es pot llegir fàcilment, i no es requereix un punt d'edició directe. Els elements de la llista haurien de començar amb una lletra minúscula a menys que siguin noms propis.

Taules

Una taula d'una columna és molt similar a una llista, però permet ordenar. Si el wikitext en si ja està ordenat amb la mateixa clau d'ordenació, aquest avantatge no s'aplica. Una taula de múltiples columnes permet ordenar qualsevol columna.

Veges també Quan utilitzar taules.

Canviar llistes desordenades a ordenades

Amb el CSS

ul { list-style: decimal }

les llistes no ordenades es canvien a llistes ordenades. Això s'aplica (pel que el selector CSS no ho restringeixi) a totes les llistes ul del codi font HTML:

  • aquelles produïdes amb *
  • aquelles amb ‎<ul> al wikitext
  • aquelles produïdes pel sistema

Com que cada pàgina especial, com altres pàgines, té una classe basada en el nom de pàgina, es pot especificar per separat per a cada tipus si les llistes s'han d'ordenar. Vegeu també també contribucions d'usuari i Què hi enllaça.

No obstant això, no sembla possible que totes les llistes d'historial de les pàgines estiguin ordenades (tret que es facin totes les llistes ordenades), perquè el nom de la classe es basa en la pàgina per a la qual es visualitza l'historial.

Vegeu també