Ŝablono:BildaMesaĝokesto/dokumentado

El Kitakujo

Nuna versio ekde 16:58, 17. Okt 2010

Tio estas ŝablono laŭ la angla Vikipedio wikipedia:en:Template:imbox (angla mallongigo: image message box) de tipo meta-ŝablono.

Ĝi estas uzata, por krei ŝablonojn por bildaj mesaĝokestoj (angle image message box), kiel ekz. {{PD}} ktp. Ĝi ofertas kelkajn malsamajn kolorojn kaj uzas defaŭltajn bildojn, se neniu parameto bildo estas definata kaj havas kelkajn pliajn trajtojn.

Ĉi tiu ŝablono funkcias preskaŭ precize simile al la ŝablono {{ArtikolaMesaĝokesto}}, kaj uzas la samajn parametrojn.

Uzado

Simipla ekzemplo de uzado:

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

Kompleksa ekzemplo:

{{BildaMesaĝokesto
| speco         = stilo
| bildo         = [[Dosiero:Emblem-question-yellow.svg|40px]]
| css-stiloj    = width: 400px; 
| teksto-stiloj = color: red; font-weight: bold; font-style: italic;
| teksto        = La teksto de la mesaĝo.
}}

Specoj de Bildaj Mesaĝokestoj

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

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.

Specialaj

Kelkaj kombinoj de parametroj.

Parametroj

Listo de ĉiuj parametroj:

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

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

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

Teĥnikaj detaloj

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

{{BildaMesaĝ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>
}}

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.