Ŝablono:ArtikolaMesaĝokesto/dokumentado

Tio estas helpdokumentado por la ŝablono {{ArtikolaMesaĝokesto}}.

Ĝi enhavas informojn pri la uzado de ŝablono, ĝiaj kategorioj kaj interlingvaj ligiloj. Kaj ĝi ne estas enhavo de la ŝablona paĝo mem.

Tio estas ŝablono laŭ la angla Vikipedio en:Template:Ambox (angla mallongigo: article message box) de tipo meta-ŝablono. Sed ĝi havas kelkajn aldonajn valorojn kaj parametrojn laŭ la rusa kaj tajlanda Vikipedioj.

Ĝi estas uzata, por krei ŝablonojn por artikolaj mesaĝokestoj (angle article message box). Ĝi ofertas kelkajn malsamajn kolorojn kaj uzas defaŭltajn bildojn, se neniu parametro bildo estas difinata kaj havas kelkajn pliajn trajtojn.

Uzado

Simpla ekzemplo:

{{ArtikolaMesaĝokesto | teksto = Iu teksto.}}

Iu teksto.

Kompleksa ekzemplo

{{ArtikolaMesaĝokesto
| speco  = stilo
| bildo = [[Dosiero:Icon apps query.svg|38px]]
| css-stiloj = width: 400px; color: red; font-weight: bold; font-style: italic
| teksto  = Mesaĝa teksto.
}}

{{{teksto}}}

Defaŭltaj bildoj

La sekvaj ekzemploj uzas diversajn speco-parametrojn, sed ili ne uzas bildo-parametrojn tiel ke ili uzas defaŭltajn bildojn por ĉiu tipo.

{{{teksto}}}

Aldonaj valoroj

Laŭ la rusa kaj tajlanda Vikipedioj ni aldonis kelkajn valorojn de la parametro speco.

speco=forigo | css-stiloj=background:#FEE;font-size:96% - proponoj por forigo, ekz. {{Forigu}}

speco=diskuto - por diskutopaĝoj, ekz. {{Jen arkivo}}

speco=bona - kvalite bona artikolo, ekz. {{Leginda}}, {{Elstara}}

speco=ĝermo - grandeca manko, ekz. {{Ĝermo}}, {{Ĝermeto}}, {{Ne finita}}

speco=protekto - informoj pri protektitaj artikoloj, ekz. {{Pp-ŝablono}}, {{Duonŝlosita}}

speco=humuro - averto ke la artikolo estas humura, {{Vikipedia humuro}}

Aliaj bildoj

Defaŭltaj bildoj, kiuj estas montritaj supre, ĉiam estas pro konveneco. En pli da kazoj estas pli konvene uzi pli specifajn bildojn. Tiuj ekzemploj uzas bildo-parametron por difini aliajn bildojn ol defaŭltajn.

{{{teksto}}}

Specialaj

Kelkaj kombinoj de parametroj

Nek parametro speco nek bildo estas difinitaj.

Neniu parametro speco kaj parametro bildo=malplena – kaŭzas malplenan kesteron kun la sama grandeco kiel defaŭlta bildo.

Neniu parametro speco kaj parametro bildo=neniu – Neniu bildo estas uzata, kaj la teksto uzas la tutan larĝecon.

bildo = [[Dosiero:Gnome globe current event.svg|42px]]
bildodekstra = [[Dosiero:Nuvola apps bookcase.svg|40px]]

Parametroj

Listo de ĉiuj parametroj:

{{ArtikolaMesaĝokesto
| speco  = serioza / enhavo / stilo / mikso / ĝermo / noto / forigo / diskuto / bona / protekto
| bildo = neniu / malplena / [[Dosiero:Iu bildo.svg|40px]]
| bildodekstra = [[Dosiero:Iu bildo.svg|40px]]
| css-stiloj = Kaskadanta Stilfolio-valoro
| teksto  = Mesaĝa teksto. 
}}

eta: Opcia parametro, kies valoro ne estas grava. Ĉi tiu parametro kaŭzas mallarĝan kesteton je la dekstra flanko. Se la valoro mankas aŭ eĉ la parametro eta mankas, tiam estas montrata la normala kesteto.

speco: Se neniu speco-parametro estas difinata, tiam validas ŝablonaj defaŭltaĵoj por la speco noto, kiu estas uzata por "artikolaj notoj". Tio signifas, ke estas montrata blua maldekstra dika linio (angle: side bar) kiel en la supra simpla ekzemplo.

bildo: Neniu parametro = Se neniu bildo-parametro estas difinata, tiam la ŝablono uzas la defaŭltan bildon. La defaŭlta bildo dependas de la speco-parametro.; Iu bildo = Vi povas uzi por la bildo la normalan vikian sintakson. 40px - 50px larĝeco estas plej ofte tute ĝusta depende de la proporcioj inter la alteco kaj larĝeco de iu bildo. Ekz:

[[Dosiero:Unbalanced scales.svg|40px]]

neniu = Signifas, ke neniu bildo estas uzata.: malplena = Signifas, ke neniu bildo estas uzata, sed la malplena kestero estas montrata kun sama grandeco kiel defaŭlta bildo. (Vidu "specialaj" ekzemploj supre.)

bildodekstra: Neniu parametro = Se neniu bildodekstra-parametro estas difinata, tiam neniu bildo je la dekstra flanko estas montrata.; Iu bildo = Vi povas uzi por la bildo la normalan vikian sintakson. 40px - 50px larĝeco estas plej ofte tute ĝusta depende de la proporcioj inter la alteco kaj larĝeco de iu bildo. Ekz:

[[Dosiero:Nuvola apps bookcase.png|40px]]

Io = Iu alia objekto, kiujn vi volas montrigi dekstre.

css-stiloj

Opcia CSS-valoro, kiu estas uzata por la artikola mesaĝokesto enhavanta HTML (<table style="{{{style|}}}" class="..."> ... </table>) Ekz.:

width: 400px; color: red; font-weight: bold; font-style: italic

teksto: Mesaĝa teksto.

teksteto (aldono laŭ la rusa vikipedio): Aldona mesaĝa teksto aŭ klariga komento.

Malgranda kesteto

Tio estas ekzemplo kun malgranda kesteto.

Kaj tio estas aldona teksto.

{{ArtikolaMesaĝokesto
|eta=1
|speco=noto
|teksto=Tio estas ekzemplo kun malgranda kesteto. 
|teksteto=Kaj tio estas aldona teksto.
}}

Kun parametro teksteto-grando

Tio estas ekzemplo kun malgranda kesteto.

Kaj tio estas aldona teksto.

{{ArtikolaMesaĝokesto
|eta=1
|speco=noto
|teksto=Tio estas ekzemplo kun malgranda kesteto. 
|teksteto=Kaj tio estas aldona teksto.
|teksteto-grando=70%
}}

Teĥnikaj detaloj

Se vi bezonas uzi specialajn signojn en la parametro teksto, tiam vi devas "eskapi" kiel sekve:

{{ArtikolaMesaĝokesto
| teksto  = <div>
Egalosigno = kaj komenca kaj fina krampoj { } funkcias bone kiel ili estas. 
Sed ĉi tie estas dukto {{!}} kaj duoblaj finaj krampoj <nowiki>}}</nowiki>. 
Kaj nun dukto kaj du finaj krampoj <nowiki>|}}</nowiki>.
</div>
}}

{{{teksto}}}

Atentigo

Ĉi tiu ŝablono profitas de la kodigo en HTML, sed ne de vikiteksto. Tio estas normala maniero ellabori ŝablonojn por ŝablonoj, ĉar vikiteksto havas kelkajn problemojn. Ekzemple estas malfacile ĉe ĝi uzi parserajn funkciojn kaj specifajn signojn en parametroj.