Help:Template (Català) - ArchWiki

Jump to content

# Help: Template (Català)

From ArchWiki
Estat de traducció: Aquest article és una versió traduïda de Help:Template. Última traducció: 2023-02-06. Si hi han hagut canvis a la versió anglesa, podeu ajudar a traduir-lo o avisar a l'equip de traducció.

Articles relacionats

- Ajuda:Edició
- Ajuda:Lectura
- Ajuda:Estil

Una plantilla és una peça de wikitext predefinida que es pot inserir en un article. Les plantilles s'utilitzen principalment per a ajudar amb el format del contingut.

## Ús

Les plantilles s'utilitzen afegint el següent marcatge a un article:

    {{Nom de la plantilla}}

La majoria de plantilles prenen arguments addicionals, com és el cas de Template:Note (Català):

    {{Note (Català)|Aquest text hauria de notar-se.}}

que produeix:

Nota Aquest text hauria de notar-se.

Algunes plantilles poden emparar paràmetres amb nom, com és el cas de Template:hc:

    {{hc|head=/etc/machine-id|output=0123456789abcdeffedcba9876543210}}

que produeix:

    /etc/machine-id

    0123456789abcdeffedcba9876543210

El format general és:

    {{Nom de la plantilla|paràmetre1|paràmetre2|...|paràmetreN}}

Per a instruccions d'ús especifiques vegeu la pàgina de la plantilla en qüestió.

### Estil

- Les plantilles han d'usar-se amb la capitalització mostrada en els exemples de les seves pàgines. Per exemple, `{{Pkg|...` i `{{ic|...` són correctes, mentre `{{pkg|...` i `{{Ic|...` no ho són.
- No han d'haver-hi espais al voltant del nom de la plantilla: `{{Nom de la plantilla|...` és correcte, mentre per exemple `{{ Nom de la plantilla |...` no ho és.
- Les plantilles no han de categoritzar-se.

### Alteració de caràcters que trenquen les plantilles

Hi ha alguns caràcters que, quan s'utilitzen dins una plantilla, trenquen la seva sortida. Normalment, això passa amb "=" (el signe d'igualtat) i "|" (el signe de conducte). A continuació es descriuen les solucions a aquest problema.

Consell

- El signe de conducte "|" pot alterar-se mitjançant la paraula màgica `{{!}}`.
- El signe d'igualtat "=" pot alterar-se mitjançant la paraula màgica `{{=}}`.

#### Paràmetres amb nom i paràmetres enumerats

Si el problema només el causen signes "=", la solució recomanada és explicitar els nombres posicionals o els noms dels paràmetres.

Exemple: `{{Tip (Català)|1=https://archlinux.org/?foo=bar}}`

Resultat:

Consell https://archlinux.org/?foo=bar

Aquesta tècnica pot ser útil per a:

- Definicions de variables
- Enllaços externs amb cadenes de consulta a l'URL.
- Cadenes i comandes de l'intèrpret d'ordres.
- Línies de codi.

Els caràcters d'espai en blanc (com els salts de línia) s'eliminen automàticament de l'inici i el final del valor dels paràmetres amb nom. Per a conservar aquests caràcters, inicieu el valor del paràmetre amb una etiqueta `<nowiki/>`.

Exemple:

    {{Tip (Català)|1=<nowiki/>
    * https://archlinux.org/?foo=bar
    * https://archlinux.org/?foo=baz
    }}

Resultat:

Consell

- https://archlinux.org/?foo=bar
- https://archlinux.org/?foo=baz

##### Múltiples paràmetres

- Utilitzant els paràmetres posicionals `1` i `2`

     <nowiki>{{hc|1=$ echo "="|2==}}

Resultat:

    $ echo "="

    =

- Utilitzant els paràmetres amb nom `head` i `output`

    {{hc|head=$ echo "="|output==}}

Resultat:

    $ echo "="

    =

#### Etiquetes nowiki

Si esteu tenint dificultats amb caràcters diferents de "=" (per exemple, "}"), la solució recomanada és envoltar tot el paràmetre amb una etiqueta `<nowiki>`. Aquest mètode mostra tota mena de caràcters, però evita completament que el motor de la wiki processi cap marcatge de text, com enllaços o altres plantilles. Per exemple:

    {{Tip (Català)|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}

Consell = | }} https://archlinux.org/ {{ic|foo}}

Envoltar només parts especifiques (o fins i tot caràcters individuals) amb etiquetes `<nowiki>` també funciona, però per qüestions de llegibilitat es recomana només emparar aquest mètode si cal que es processin enllaços o altres plantilles. Per exemple:

    {{Tip (Català)|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}

Consell = | }} https://archlinux.org/ `foo`

#### Entitats HTML

Substituir els caràcters problemàtics amb les seves entitats HTML corresponents sempre funciona, però no es recomana utilitzar-les si es pot utilitzar qualsevol dels mètodes anteriors, ja que empitjora la llegibilitat del text font. Per exemple:

    {{Tip (Català)|&#61; &#124; &#123;&#123; &#125;&#125;}}

Consell = | {{ }}

## Creació

Nota

- L'espai de noms "Template" està semiprotegit. Només els usuaris autoconfirmats poden crear o editar plantilles.
- Abans de crear una plantilla, discutiu la idea a Help talk:Template.
- Creeu només plantilles rellevants. Si esteu intentant crear una plantilla molt especialitzada que probablement només s'usarà a uns pocs articles, si us plau no ho feu, eviteu embrutar l'espai de noms de plantilles.
- Creeu només plantilles concises. Recordeu El Mètode Arch: Fes-ho Simple, Estúpid!

La plantilla següent hauria d'utilitzar-se quan es creen noves plantilles per a facilitar l'ús i l'edició:

    <noinclude>
    {{Template (Català)}}

    Una descripció breu de la plantilla

    == Ús ==

    <nowiki>{{Nom de la plantilla|paràmetre1|paràmetre2|...|paràmetreN}}</nowiki>

    == Exemple ==

    {{Nom de la plantilla|paràmetre1|paràmetre2|...|paràmetreN}}</noinclude><includeonly>El codi de la plantilla va aquí...</includeonly>

Per a iniciar el procés de creació, simplement visiteu Template:Nom de la plantilla (substituint `Nom de la plantilla` amb el nom desitjat per a la plantilla), editeu-la, i afegiu-hi el wikitext rellevant.

Nota (de la traductora) Recordeu que els noms de les pàgines en català han de seguir el format `Nom de la pàgina (Català)`. Aquest criteri també s'aplica a les plantilles.

## Llista de plantilles

A continuació es llisten les plantilles que els usuaris poden utilitzar directament als articles de l'ArchWiki. Cliqueu als enllaços per veure el seu ús detallat. Per a una llista que inclogui també traduccions i meta-plantilles vegeu Special:AllPages/Template:, Special:PrefixIndex/Template: o Special:MostLinkedTemplates.

Advertència Si us plau, no experimenteu amb les plantilles existents. Si voleu editar una plantilla no protegida, copieu el text a Template:Sandbox, editeu-la i proveu-la allà, i copieu-la a la pàgina original només quan funcioni. És força recomanable (i necessari en el cas de les plantilles protegides) suggerir primer qualsevol modificació a les pàgines de discussió.

### Proves

- Template:Sandbox
- Template:Lorem Ipsum

### Plantilles d'estat d'article

Aquestes plantilles s'han d'afegir al principi d'articles o seccions preocupants. Vegeu també Help:Style (Català)#Plantilles d'estat d'article[broken link: invalid section].

Els traductors haurien de comprovar les pautes d'ús de les plantilles a ArchWiki:TranslationTeam (Català).

Es fa un seguiment de les pàgines marcades amb plantilles d'estat d'article a la categoria de manteniment corresponent i a ArchWiki:Statistics#Maintenance statistics.

Nom | Ús recomanat | Paràmetres
--- | --- | ---
Template:Style | Contingut amb problemes de llenguatge, sintaxi de wiki o estil. | `1` — raó, `2` — pàgina de discussió opcional, `section` — secció opcional a la pàgina de discussió per defecte
Template:Accuracy | Contingut incorrecte, enganyós o confús.
Template:Expansion | Contingut incomplet.
Template:Out of date | Contingut desfasat.
Template:Remove | Contingut irrellevant o inútil.
Template:Archive | Pàgines obsoletes.
Template:Laptop style | Pàgines de portàtils que no segueixen les Pautes per a les pàgines de portàtils.
Template:Translateme (Català) | Traduccions incompletes.
Template:Bad translation (Català) | Traduccions problemàtiques.
Template:TranslationStatus (Català) | Estat de les traduccions. | `1` — títol original, `2` — data de traducció, `3` — nombre de revisió
Template:Merge | Contingut que se superposa amb un altre article. | `1` — pàgina objectiu, `2` — raó, `3` — pàgina de discussió opcional, `section` — secció opcional a la pàgina de discussió per defecte
Template:Move | Pàgines a reanomenar, seccions a moure a un altre article.
Template:Redirect | Pàgines a reencaminar a un altre article.
Template:Unsupported | Pàgines d'usuari no suportades per Arch Linux. | `1` — data de l'última revisió de l'autor de la pàgina

### Plantilles d'articles relacionats

- Template:Related articles start (Català)
- Template:Related (o Template:Related2)
- Template:Related articles end

### Plantilles de formatatge de codi

- Template:ic
- Template:bc
- Template:hc
- Template:Text art

### Plantilles d'anotació

- Template:Note (Català)
- Template:Tip (Català)
- Template:Warning (Català)

Per a usar-se només als esborranys a les pàgines de discussió:

- Template:Comment (Català)

### Plantilles miscel·lànies

- Template:App
- Template:Broken package link (Català)
- Template:Broken section link (Català)
- Template:Bug
- Template:Committed identity (Català)
- Template:Dead link (Català)
- Template:Lowercase title
- Template:man
- Template:Unsigned (Català)

### Plantilles de paquets

- Template:Pkg
- Template:Grp
- Template:AUR

### Plantilles de cel·les de taula

Alineació del text:

Nom | Alineació | Marcatge wiki | Resultat
--- | --- | --- | ---
Template:C | centre | `{{C|text}}` | text
Template:L | esquerra | `{{L|text}}` | text

Fons de la cel·la:

Nom | Color | Marcatge wiki | Resultat
--- | --- | --- | ---
Template:R | vermell | `{{R|text}}` | text
Template:O | taronja | `{{O|text}}` | text
Template:Y | groc | `{{Y|text}}` | text
Template:G | verd | `{{G|text}}` | text
Template:B | blau | `{{B|text}}` | text
Template:V | violeta | `{{V|text}}` | text
Template:Grey | gris | `{{Grey|text}}` | text

Text d'ús freqüent:

Nom | Marcatge wiki | Resultat
--- | --- | ---
Template:Yes (Català) | `{{Yes (Català)}}` | Sí
`{{Yes (Català)|https://wiki.archlinux.org/}}` | Sí
Template:No | `{{No}}` | No
`{{No|https://wiki.archlinux.org/}}` | No
Template:- | `{{-}}` | –

Consell Podeu utilitzar atributs amb les plantilles de cela prefixant-les. Per exemple: `| colspan=2 {{Yes (Català)}}`.

### Plantilles de categoria

- Template:Cat main (Català)

## Vegeu també

- Template:Template (Català)
- Wikipedia:ca:Ajuda:Plantilla

Category:

- Help (Català)

Hidden category:

- Pages with broken section links

Help: Template (Català)
Add topic