Ŝablono:Mesaĝokesto/dokumentado

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

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), kiel ekz. {{Vikiigenda}} ktp. Ĝi ofertas kelkajn malsamajn kolorojn kaj uzas defaŭltajn bildojn, se neniu parametro bildo estas difinata kaj havas kelkajn pliajn trajtojn.

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.
}}
Mesaĝa teksto.

Defaŭltaj bildoj

redakti

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

Serioza
speco=serioza - serioza problemo, ekz. {{NowCommons}} (esperante: NunKomunejo), {{Nevikia}}
Enhavo
speco=enhavo - enhavaj mankoj, ekz. {{Neneŭtrala}}, {{Malneŭtraleco}}, {{Ĝisdatiginda}}
Stilo
speco=stilo - stilaj mankoj, ekz. {{Polurinda}}, {{Vikiigenda}}, {{Gralima}}, {{Esperantigu artikolon}}, {{PaĝoNeligita}}, {{Rq}}
Mikso
speco=mikso - proponoj por unuigo, disigo aŭ ŝovado, ekz. {{Kunigu}}, {{Ŝovu}}, {{Transloku al vikivortaro}}
Noto
speco=noto - noto aŭ konsileto, ekz. {{Redaktas}}, {{Futuro}}
Arkivo
arkivo ekzemple de diskutpaĝo
Funebro
por funebra informo - ekz : {{Forpasinta vikipediisto}}

Aldonaj valoroj

redakti

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

Forigo
speco=forigo | css-stiloj=background:#FEE;font-size:96% - proponoj por forigo, ekz. {{Forigu}}
Diskuto
speco=diskuto - por diskutopaĝoj, ekz. {{Jen arkivo}}
Bona
speco=bona - kvalite bona artikolo, ekz. {{Leginda}}, {{Elstara}}
Ĝermo
speco=ĝermo - grandeca manko, ekz. {{Ĝermo}}, {{Ĝermeto}}, {{Ne finita}}
Protekto
speco=protekto - informoj pri protektitaj artikoloj, ekz. {{Pp-ŝablono}}, {{Duonŝlosita}}
Humuro
speco=humuro - averto ke la artikolo estas humura, {{Vikipedia humuro}}

Aliaj bildoj

redakti

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.

speco=enhavo
bildo = [[Dosiero:Unbalanced scales.svg|40px]]
speco=stilo
bildo = [[Dosiero:Wikitext.svg|50px]]
speco=mikso

bildo = [[Dosiero:Merge-arrows.svg|50px]]

Ekz. {{Kunfandiĝo‎}}

Specialaj

redakti

Kelkaj kombinoj de parametroj

Nek parametro speco nek bildo estas difinitaj.
Malplena
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

redakti

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

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


Kun parametro teksteto-grando

redakti
Noto
Tio estas ekzemplo kun malgranda kesteto.
{{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

redakti

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

Egalosigno = kaj komenca kaj fina krampoj { } funkcias bone kiel ili estas. Sed ĉi tie estas dukto | kaj duoblaj finaj krampoj }}. Kaj nun dukto kaj du finaj krampoj |}}.

Atentigo

redakti

Ĉ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.