Ŝablono:ArtikolaMesaĝokesto/dokumentado

El Kitakujo

(Malsamoj inter versioj)
Iri al: navigado, serĉi
E (Teĥnikaj detaloj: korekto laŭ la angla kaj suprasoraba vikipedioj)
E (korekto)
Linio 3: Linio 3:
Sed ĝi havas kelkajn aldonajn valorojn kaj parametrojn laŭ la [[:ru:Шаблон:Ambox|rusa]] kaj [[:th:แม่แบบ:Ambox|tajlanda]] Vikipedioj.
Sed ĝi havas kelkajn aldonajn valorojn kaj parametrojn laŭ la [[:ru:Шаблон:Ambox|rusa]] kaj [[:th:แม่แบบ:Ambox|tajlanda]] Vikipedioj.
-
Ĝi estas uzata, por kreii ŝablonoj por artikolaj mesaĝokestoj (angle ''article message box''), kiel ekz. {{Ŝ|Vikiigenda}} ktp. Ĝi ofertas kelkajn malsamajn kolorojn kaj uzas ''defaŭltajn'' bildojn, se neniu parameto '''image''' estas definata kaj havas kelkajn pliajn trajtojn.
+
Ĝ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 parameto '''image''' estas definata kaj havas kelkajn pliajn trajtojn.
==Uzado==
==Uzado==
Simpla ekzemplo:
Simpla ekzemplo:
Linio 74: Linio 74:
==Aliaj bildoj==
==Aliaj bildoj==
-
Defaŭltaj bildoj, kiuj estas montritaj supre, ĉiam estas pro konveneco. En pli da kazoj estas pli konvene uzi pli specifikajn bildojn. Tiuj ekzemploj uzas '''image''' parametron por difini aliajn bildojn ol defaŭltajn.
+
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 '''image'''-parametron por difini aliajn bildojn ol defaŭltajn.
{{Vikipediisto:Tlustulimu/Ŝablono:Ambox
{{Vikipediisto:Tlustulimu/Ŝablono:Ambox
| type  = content
| type  = content
Linio 128: Linio 128:
'''type'''
'''type'''
-
:Se neniu '''type''' parametro estas difinata, tiam validas ŝablonaj defaŭltaĵoj por la tipo noto, kiu estas uzata por "artikolaj notoj". Tio signifas, ke estas montrata blua "side bar" kiel en la supra simpla ekzemplo.
+
:Se neniu '''type'''-parametro estas difinata, tiam validas ŝablonaj defaŭltaĵoj por la tipo noto, kiu estas uzata por "artikolaj notoj". Tio signifas, ke estas montrata blua "side bar" kiel en la supra simpla ekzemplo.
'''image'''
'''image'''
Linio 141: Linio 141:
'''imageright'''
'''imageright'''
-
:'''Neniu parametro''' = Se neniu '''imageright''' parametro estas difinata, tiam neniu bildoj je la dekstra flanko estas montrata.
+
:'''Neniu parametro''' = Se neniu '''imageright'''-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:
:'''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:
Linio 150: Linio 150:
'''style'''
'''style'''
-
:Opcionala [[Cascading Style Sheets]] valoro, kiu estas uzata por la artikola mesaĝa kesto enhavanta [[HTML]] (<code><nowiki><table style="{{{style|}}}" class="..."> ... </table></nowiki></code>) Ekz.:
+
:Opcionala [[CSS]]-valoro, kiu estas uzata por la artikola mesaĝokesto enhavanta [[HTML]] (<code><nowiki><table style="{{{style|}}}" class="..."> ... </table></nowiki></code>) Ekz.:
::<code><nowiki>width: 400px; color: red; font-weight: bold; font-style: italic</nowiki></code>
::<code><nowiki>width: 400px; color: red; font-weight: bold; font-style: italic</nowiki></code>
Linio 179: Linio 179:
==Teĥnikaj detaloj==
==Teĥnikaj detaloj==
-
Se vi bezonas uzi specialajn signojn en la parametro '''text''', tiam vi bezonas  "eskapi" kiel sekve:
+
Se vi bezonas uzi specialajn signojn en la parametro '''text''', tiam vi devas "eskapi" kiel sekve:
<pre>
<pre>
{{Vikipediisto:Tlustulimu/Ŝablono:Ambox
{{Vikipediisto:Tlustulimu/Ŝablono:Ambox

Kiel registrite je 20:12, 15. Dec 2007

Tio estas helpdokumentado por la ŝablono {{ArtikolaMesaĝokesto}}.
Ĝi enhavas informojn pri la uzado de ŝablono, ĝiaj kategorioj kaj interlingvaj ligiloj, kiu ne estas enhavo de la ĝusta ŝablona paĝo.

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 parameto image estas definata kaj havas kelkajn pliajn trajtojn.

Enhavo

Uzado

Simpla ekzemplo:

{{Vikipediisto:Tlustulimu/Ŝablono:Ambox | text = Iu teksto.}}

Vikipediisto:Tlustulimu/Ŝablono:Ambox

Kompleksa ekzemplo

{{Vikipediisto:Tlustulimu/Ŝablono:Ambox
| type  = style
| image = [[Image:Icon apps query.svg|38px]]
| style = width: 400px; color: red; font-weight: bold; font-style: italic
| text  = Mesaĝa teksto.
}}

Vikipediisto:Tlustulimu/Ŝablono:Ambox

Defaŭltaj bildoj

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

Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox

Aldonaj valoroj

Laŭ la rusa kaj tajlanda Vikipedioj ni aldonis kelkajn valorojn de la parametro type. Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox

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 image-parametron por difini aliajn bildojn ol defaŭltajn. Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox

Specialaj

Kelkaj kombinoj de parametroj Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox Vikipediisto:Tlustulimu/Ŝablono:Ambox

Parametroj

Listo de ĉiuj parametroj:

{{Vikipediisto:Tlustulimu/Ŝablono:Ambox
| type  = serious / content / style / merge / growth / notice / delete / discussion / good / protection
| image = none / blank / [[Image:Iu bildo.svg|40px]] / [[Dosiero:Iu bildo.svg|40px]]
| imageright = [[Image:Iu bildo.svg|40px]] / [[Dosiero:Iu bildo.svg|40px]]
| style = Kaskadanta Stilfolio-valoro
| text  = Mesaĝa teksto. 
}}

mini

Opcionala 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 mini mankas, tiam estas montrata la normala kesteto.

type

Se neniu type-parametro estas difinata, tiam validas ŝablonaj defaŭltaĵoj por la tipo noto, kiu estas uzata por "artikolaj notoj". Tio signifas, ke estas montrata blua "side bar" kiel en la supra simpla ekzemplo.

image

Neniu parametro = Se neniu image-parametro estas difinata, tiam la ŝablono uzas la defaŭltan bildon. La defaŭlta bildo dependas de la type-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:
[[Image:Unbalanced scales.svg|40px]]
none = Signifas, ke neniu bildo estas uzata.
blank = Signifas, ke neniu bildo estas uzata, sed la malplena kestero estas montrata kun sama grandeco kiel defaŭlta bildo. (Vidu "specialaj" ekzemploj supre.)

imageright

Neniu parametro = Se neniu imageright-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:
[[Image:Nuvola apps bookcase.png|40px]]
Io = Iu alia objekto, kiujn vi volas montrigi dekstre.

style

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

text

Mesaĝa teksto.

text-small (aldono laŭ la rusa vikipedio)

Aldona mesaĝa teksto aŭ klariga komento.

Malgranda kesteto

Vikipediisto:Tlustulimu/Ŝablono:Ambox

{{Vikipediisto:Tlustulimu/Ŝablono:Ambox
|mini=1
|type=notice
|text=Tio estas ekzemplo kun malgranda kesteto. 
|text-small=Kaj tio estas aldona teksto.
}}

Teĥnikaj detaloj

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

{{Vikipediisto:Tlustulimu/Ŝablono:Ambox
| text  = <div>
Egalosigno = kaj komenca kaj fina krampoj { } funkcias bone kiel ili estas. 
Sed ĉi tie estas "pipe" {{!}} kaj duoblaj finaj krampoj <nowiki>}}</nowiki>. 
Kaj nun "pipe" kaj du finaj krampoj <nowiki>|}}</nowiki>.
</div>
}}

Vikipediisto:Tlustulimu/Ŝablono:Ambox

CSS-klasoj

Ĉi tiu ŝablono uzas CSS-klasojn por sia aspekto. Ĉi tiuj CSS-klasoj (table.ambox ktp.) estas en la paĝo MediaWiki:Common.css, tiel ke nur administrantoj povas ŝanĝi formatojn. Sed vi povas proponi pliajn formatojn aŭ tipojn sur la diskuta paĝo.

CSS-klasoj povas esti uzataj ankaŭ rekte en tabeloj:

{| class="ambox ambox-content"
|-
| class="ambox-image" | [[Image:Emblem-important.svg|40px]]
| Iu teksto
|}
Dosiero:Emblem-important.svg Iu 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.

Personaj iloj