Mòdul:XCols/proves/ús
Aquesta és una subpàgina de documentació per a la Mòdul:XCols/proves Té la informació d'ús, les categories i qualsevol altre contingut que no forma part essencial del codi del mòdul. |
Mòdul per col·locar text en columnes:
- Repartiment automàtic o manual de les línies. En el repartiment es prioritza que l'emplenament sigui segons l'ordre de la columna (així, per exemple, es descarta un repartiment en dues columnes, més ajustades per contingut, en que la segona columna estigués més plena que la primera).
- Per tal de millorar la lectura el repartiment automàtic en columnes té en compte no trencar:
- Les línies que contenen "sublínies". Així, les "sublínies" sempre estaran sota de la línia principal i, per tant, en la mateixa columna. Un exemple de línia amb "sublínies" seria:
- Línia 1
- Sublínia 1.1
- Sublínia 1.2
- Línia 1
- Les agrupacions de línies (vegeu #Agrupant).
- Pel grup de columnes: es pot definir amplada, encapçalament, peu, color de fons, alineació. L'alineació a dreta o esquerra permet que el text de l'article flueixi per l'altre costat.
- Per a les columnes, es pot definir:
- Que l'amplada de cadascuna sigui igual o ajustada al contingut.
- La separació entre columnes.
Utilitzat per {{XCols}}.
Lists
[modifica]{{#invoke:XCols/proves|main|allitems=params}}
Key | Default names | Localized names (i18n) | T. |
---|---|---|---|
Lines | lines | línies | s |
Header | header | encapçalament | s |
FreeHeader | free_header | encapçalament_lliure | s |
Footer | footer | peu | s |
NumColumns | col_n | n_cols | i (1-10) |
Width | width | amplada | sz |
SameWidth | same_width | id_amplada | b |
HAlign | h_align | alineació_h | s |
VAlign | v_align | alineació_v | s |
SepCols | col_sep | sep_cols | sz |
BgColor | bg_color | color_fons | s |
HeaderBgColor | header_bg_color | color_fons_encapçalament | s |
FooterBgColor | footer_bg_color | color_fons_peu | s |
You can change the localizated text in: Module:XCols/proves/i18nUsed argument types: s (string), i (integer), sz (size), b (boolean)
{{#invoke:XCols/proves|main|allitems=template}}
<templatedata>
{
"params": {
"línies": {
"aliases": [
"lines"
],
"type": "line"
},
"encapçalament": {
"aliases": [
"header"
],
"type": "line"
},
"encapçalament_lliure": {
"aliases": [
"free_header"
],
"type": "line"
},
"peu": {
"aliases": [
"footer"
],
"type": "line"
},
"n_cols": {
"aliases": [
"col_n"
],
"type": "number"
},
"amplada": {
"aliases": [
"width"
],
"type": "line"
},
"id_amplada": {
"aliases": [
"same_width"
],
"type": "boolean"
},
"alineació_h": {
"aliases": [
"h_align"
],
"type": "line"
},
"alineació_v": {
"aliases": [
"v_align"
],
"type": "line"
},
"sep_cols": {
"aliases": [
"col_sep"
],
"type": "line"
},
"color_fons": {
"aliases": [
"bg_color"
],
"type": "line"
},
"color_fons_encapçalament": {
"aliases": [
"header_bg_color"
],
"type": "line"
},
"color_fons_peu": {
"aliases": [
"footer_bg_color"
],
"type": "line"
}
},
"format": "block"
}
</templatedata>
{{#invoke:XCols/proves|main|allitems=errors}}
Key | Source | Translation |
---|---|---|
NColsBiggerNLabs | El nombre de columnes ($1) és més gran que el nombre d'etiquetes ($2) | El nombre de columnes ($1) és més gran que el nombre d'etiquetes ($2) |
You can change the localizated text in: Module:XCols/proves/i18n
Sintaxi
[modifica]El mode més senzill és:
{{#invoke:XCols/proves|main|n_cols=|línies=
línia 1
línia 2
..
}}
On:
- n_cols és el nombre de columnes (per defecte 1)
nom del paràmetre | què fa | |
---|---|---|
en anglès | en català | |
lines | línies | Les línies, únic camp obligatori. Una línia que sigui "---" indica salt de columna manual. Si va seguida d'una mida (en px, em o %), aquesta indica la mida de l'amplada de la columna. |
col_n | n_cols | Nombre de columnes. Es comprovarà que no hi hagi una línia "separadora" (que tingui de començament "---"), si hi és, es considerarà que és un salt de columna manual, llavors el nombre de columnes es calcularà pel nombre de línies "separadores". |
width | amplada | Nombre. Màxim espai ocupat per les columnes. El número pot ser en px, em o %. Per defecte ocupa l'amplada segons l'amplada ocupada per les línies. |
same_width | id_amplada | Booleà, Si és que sí, l'amplada de les columnes serà igual per a totes elles, independentment de l'amplada ocupada per les línies. Per defecte l'amplada depèn de l'amplada ocupada per les línies. |
header | encapçalament | A dalt de les columnes, apareixerà en negreta i centrat. |
footer | peu | A baix de les columnes. |
h_align | alineació_h | Es pot determinar que s'alinei al centre/center, a la dreta/right o a l'esquerra/left. Només té efecte si l'amplada no és del 100%. Si s'alinea a dreta o esquerra, el text de l'article podrà fluir pel costat (com en una imatge inserida). |
v_align | alineació_v | Per defecte s'alinea a dalt, però es pot determinar que s'alinei al centre/center o avall/bottom. |
col_sep | sep_cols | Estableix els marges de separació del text entre les columnes. El número pot ser en px, em. Per defecte és 0.6em per costat de columna. |
bg_color | color_fons | Color de fons. Per defecte és transparent. |
free_header | encapçalament_lliure | A dalt de les columnes. És una alternativa a encapçalament. No té estil definit. |
header_bg_color | color_fons_encapçalament | Color de fons de l'encapçalament. Per defecte és transparent o del color de fons. |
footer_bg_color | color_fons_peu | Color de fons de l'encapçalament. Per defecte és transparent o del color de fons. |
Exemples
[modifica]Llistes puntejades
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| línies = *[[Primer]] *Segon *Tercer *Quart *'''Cinquè''' *{{color|red|Sisè}} *Setè }}
|
|
Amb diferents nivells
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| línies = *Primer **A ***A1 ***A2 **B *Segon *Tercer *Quart *Cinquè *Sisè *Setè }}
|
|
En aquest exemple (degut a l'ús d'aquest mòdul) no se separen les "sublínies" de "Tercer", per millorar-ne la lectura.
{{#invoke:XCols/proves|main| n_cols = 2| línies = *Primer *Segon *Tercer **A **B **C *Quart *Cinquè *Sisè *Setè }}
|
|
Això és el mateix que l'anterior, però realment, no fa falta posar les separacions:
{{#invoke:XCols/proves|main| n_cols = 2| línies = *Primer *Segon *Tercer **A **B **C *Quart *Cinquè *Sisè *Setè }}
|
|
Observeu que si no es tingués en compte de no separar les "sublínies" (com fa aquest mòdul) es veuria així:
|
|
Amb pitjor lectura, tot i que les columnes serien més igualades.
Llista no puntejada
[modifica]{{#invoke:XCols/proves|main| n_cols = 3| línies = Primer Segon Tercer Quart Cinquè Sisè Setè }}
Primer Segon Tercer |
Quart Cinquè |
Sisè Setè |
Amb agrupació de línies
[modifica]Fent tres grups de línies (primer en una sola columna):
{{#invoke:XCols/proves|main| línies = Primer Segon Tercer Quart Cinquè Sisè Setè }}
Primer Tercer Sisè |
Amb dues columnes:
{{#invoke:XCols/proves|main| n_cols = 2| línies = Primer Segon Tercer Quart Cinquè Sisè Setè }}
Primer Tercer |
Sisè |
Llista amb salt de columna manual
[modifica]Senzill
[modifica]{{#invoke:XCols/proves|main| línies = Primer Segon --- Tercer Quart Cinquè --- Sisè Setè }}
Primer Segon |
Tercer Quart Cinquè |
Sisè Setè |
Agrupant
[modifica]{{#invoke:XCols/proves|main| línies = Primer Segon --- Tercer Quart Cinquè --- Sisè Setè }}
Primer |
Tercer Quart |
Sisè |
Vegeu també: #Amb encapçalaments.
Alineació horitzontal
[modifica]{{#invoke:XCols/proves|main| n_cols = 3| alineació_h = centre| línies = Primer Segon Tercer Quart Cinquè Sisè Setè }}
Primer Segon Tercer |
Quart Cinquè |
Sisè Setè |
Alineació vertical
[modifica]{{#invoke:XCols/proves|main| n_cols = 3| alineació_v = centre| línies = Primer Segon Tercer Quart Cinquè Sisè Setè }}
Primer Segon Tercer |
Quart Cinquè |
Sisè Setè |
Text al costat
[modifica]No utilitzeu el text al costat per a més d'una o dues columnes.
{{#invoke:XCols/proves|main| alineació_h = dreta| línies = ---30px [[File:Baseball bat (1904).jpg|30px]] ---100px En el [[beisbol]], el '''[[bat de beisbol|bat]]''' és el bastó que es fa servir per colpejar la pilota llançada pel [[pitcher]] o llançador. El que utilitza el bat, s'anomena batedor, i forma part de l'equip ofensiu. }} {{lorem|3}}
En el beisbol, el bat és el bastó que es fa servir per colpejar la pilota llançada pel pitcher o llançador. El que utilitza el bat, s'anomena batedor, i forma part de l'equip ofensiu. |
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.
Fusce convallis, mauris imperdiet gravida bibendum, nisl turpis suscipit mauris, sed placerat ipsum urna sed risus. In convallis tellus a mauris. Curabitur non elit ut libero tristique sodales. Mauris a lacus. Donec mattis semper leo. In hac habitasse platea dictumst. Vivamus facilisis diam at odio. Mauris dictum, nisi eget consequat elementum, lacus ligula molestie metus, non feugiat orci magna ac sem. Donec turpis. Donec vitae metus. Morbi tristique neque eu mauris. Quisque gravida ipsum non sapien. Proin turpis lacus, scelerisque vitae, elementum at, lobortis ac, quam. Aliquam dictum eleifend risus. In hac habitasse platea dictumst. Etiam sit amet diam. Suspendisse odio. Suspendisse nunc. In semper bibendum libero.
{{#invoke:XCols/proves|main| alineació_h = esquerra| n_cols = 2| encapçalament = Explicació| línies = '''Primer''' Nota '''Segon''' Nota 1 Nota 2 }} {{lorem|2}}
Explicació | |
Primer |
Segon |
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.
Color de fons
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Una Dues Tres Quatre }}
Una Dues |
Tres Quatre |
Llista no puntejada amb encapçalament i peu
[modifica]Estil predefinit de l'encapçalament
[modifica]{{#invoke:XCols/proves|main| n_cols = 3| encapçalament = Encapçalament| línies = Primer Segon Tercer<ref>Referència al peu d'aquestes columnes</ref> Quart Cinquè Sisè Setè| peu=<references/> }}
Encapçalament | ||
Primer Segon Tercer[1] |
Quart Cinquè |
Sisè Setè |
|
Estil d'encapçalament definit per l'usuari
[modifica]{{#invoke:XCols/proves|main| n_cols = 3| color_fons = Snow| encapçalament_lliure = '''{{color|green|Encapçalament}}''' <small>(amb una nota a sota, amb text petit)</small>| color_fons_encapçalament = Lavender| línies = Primer Segon Tercer Quart Cinquè Sisè Setè| peu = Aquesta és una nota al peu de les columnes| color_fons_peu = Lavender| }}
Encapçalament (amb una nota a sota, amb text petit) | ||
Primer Segon Tercer |
Quart Cinquè |
Sisè Setè |
Aquesta és una nota al peu de les columnes |
Modificant l'amplada
[modifica]Amplada de les columnes proporcional al contingut
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| amplada = 50%| color_fons = LightYellow| línies = Una línia, més o menys llarga Altra }}
Una línia, més o menys llarga |
Altra |
Amplada de les columnes proporcional a l'amplada total
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| amplada = 50%| id_amplada = sí| color_fons = LightYellow| línies = Una línia, més o menys llarga Altra }}
Una línia, més o menys llarga |
Altra |
Modificant el marge de les columnes
[modifica]Sense modificar
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Una línia, més o menys llarga Altra }}
Una línia, més o menys llarga |
Altra |
Modificant-lo
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| sep_cols = 1.2em| color_fons = LightYellow| línies = Una línia, més o menys llarga Altra }}
Una línia, més o menys llarga |
Altra |
Línies heterogènies
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Una línia, més o menys llarga Amb la 1ª També amb la 1ª Altre Final }}
Una línia, més o menys llarga |
Altre Final |
{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Una línia, més o menys llarga :Amb la 1ª :També amb la 1ª Altre *Altre 1 *Altre 2 ;Final: I ja està }}
Una línia, més o menys llarga
Altre
|
|
{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Una línia, més o menys llarga Altra Tercera Quarta }}
Una línia, més o menys llarga |
Tercera Quarta |
{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Una línia, més o menys llarga Altra }}
Una línia, més o menys llarga |
Altra |
{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = *Una línia, més o menys llarga *Altra }}
|
|
Una línia massa llarga
[modifica]El problema
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Primer Segon, amb un comentari que pot resultar massa llarg Tercer Quart }}
Primer Segon, amb un comentari que pot resultar massa llarg |
Tercer Quart |
Solució 1
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Primer Segon, amb un comentari<br>que pot resultar massa llarg Tercer Quart }}
Primer Segon, amb un comentari |
Tercer Quart |
Solució 2
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = Primer Segon, amb un comentari que pot resultar massa llarg Tercer Quart }}
Primer Segon, amb un comentari |
Tercer Quart |
Solució 3
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| amplada = 20%| línies = ---80% Primer Segon, amb un comentari que pot resultar massa llarg ---20% Tercer Quart }}
Primer Segon, amb un comentari que pot resultar massa llarg |
Tercer Quart |
Solució 4
[modifica]{{#invoke:XCols/proves|main| n_cols = 2| color_fons = LightYellow| línies = ---200px Primer Segon, amb un comentari que pot resultar massa llarg ---50px Tercer Quart }}
Primer Segon, amb un comentari que pot resultar massa llarg |
Tercer Quart |
Amb encapçalaments
[modifica]Rarament útil. Més que res per a llistes ordenades alfabèticament, i així permetent que apareguin en la taula de continguts; com en l'exemple:
Ciutats de Moldàvia |
---|
{{#invoke:XCols/proves|main |alineació_h = centre |n_cols = 4 |línies = ====A==== *[[Anenii Noi]] ====B==== *[[Basarabeasca]] *[[Bălți]] *[[Biruința]] *[[Briceni]] *[[Bucovăț]] ====C==== *[[Cahul]] *[[Camenca]] *[[Cantemir]] *[[Căinari]] *[[Călărași]] *[[Căușeni]] *[[Ceadîr-Lunga]] *[[Chișinău]] *[[Cimișlia]] *[[Codru]] *[[Comrat]] *[[Cornești]] *[[Costești]] *[[Crasnoe]] *[[Cricova]] *[[Criuleni]] *[[Cupcini]] ====D==== *[[Dnestrovsc]] *[[Dondușeni]] *[[Drochia]] *[[Dubăsari]] *[[Durlești]] ====E==== *[[Edineț]] ====F==== *[[Fălești]] *[[Florești]] *[[Frunză]] ====G==== *[[Ghindești]] *[[Glodeni]] *[[Grigoriopol]] ====H==== *[[Hîncești]] ====I==== *[[Ialoveni]] *[[Iargara]] ====L==== *[[Leova (Moldàvia)|Leova]] *[[Lipcani]] ====M==== *[[Maiac (Moldàvia)|Maiac]] *[[Mărculești]] ====N==== *[[Nisporeni]] ====O==== *[[Ocnița]] *[[Orhei]] *[[Otaci]] ====R==== *[[Rezina]] *[[Rîbnița]] *[[Rîșcani]] ====S==== *[[Sîngera]] *[[Sîngerei]] *[[Slobozia]] *[[Soroca]] *[[Strășeni]] ====Ş==== *[[Șoldănești]] *[[Ștefan Vodă]] ====T==== *[[Taraclia]] *[[Telenești]] *[[Bender|Tighina (Bender)]] *[[Tiraspol]] *[[Tiraspolul Nou]] *[[Tvardița]] ====U==== *[[Ungheni]] ====V==== *[[Vadul lui Vodă]] *[[Vatra]] *[[Vulcănești]] }} |
ABC |
DEFGHI |
LMNORS |
ŞTUV |