Ŝablono:BildaMesaĝokesto/dokumentado

El Komunejo

< Ŝablono:BildaMesaĝokesto(Malsamoj inter versioj)
Iri al: navigado, serĉi
E
E (korekto, korekto interwiki)
 
(9 mezaj versioj ne montrata.)
Linio 2: Linio 2:
<!-- BONVOLU ALDONI KATEGORIOJN KAJ INTERVIKIOJN ĈE LA SUBO DE LA PAĜO. -->
<!-- BONVOLU ALDONI KATEGORIOJN KAJ INTERVIKIOJN ĈE LA SUBO DE LA PAĜO. -->
-
Tio estas ŝablono laŭ la angla Vikipedio [[:en:Template:imbox]] (angla mallongigo: ''image message box'') de tipo meta-ŝablono.
+
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 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.
Linio 45: Linio 45:
{{BildaMesaĝokesto
{{BildaMesaĝokesto
| speco = serioza
| speco = serioza
-
| teksto = type=<u>serioza</u> - serioza problemo.
+
| teksto = speco=<u>serioza</u> - serioza problemo.
}}
}}
{{BildaMesaĝokesto
{{BildaMesaĝokesto
| speco = forigo
| speco = forigo
-
| teksto = type=<u>forigo</u> – Proponoj por forigo.
+
| teksto = speco=<u>forigo</u> – Proponoj por forigo.
}}
}}
{{BildaMesaĝokesto
{{BildaMesaĝokesto
Linio 72: Linio 72:
}}
}}
{{BildaMesaĝokesto
{{BildaMesaĝokesto
-
| speco = licenso
+
| speco = licenco
-
| teksto = speco=<u>licenso</u> – Licensaj ŝablonoj.
+
| teksto = speco=<u>licenco</u> – Licencaj ŝablonoj.
}}
}}
{{BildaMesaĝokesto
{{BildaMesaĝokesto
Linio 95: Linio 95:
}}
}}
{{BildaMesaĝokesto
{{BildaMesaĝokesto
-
| speco = licenso
+
| speco = licenco
| bildo = [[Dosiero:Heckert GNU white.svg|48px]]
| bildo = [[Dosiero:Heckert GNU white.svg|48px]]
-
| teksto = speco = licenso <br> bildo = <nowiki>[[Dosiero:Heckert GNU white.svg|48px]]</nowiki> <br> Ĉi tiu bildo estas uzata por la GFDL-licensaj ŝablonoj, kiel {{ŝ|GFDL}}.
+
| teksto = speco = licenco <br> bildo = <nowiki>[[Dosiero:Heckert GNU white.svg|48px]]</nowiki> <br> Ĉi tiu bildo estas uzata por la GFDL-licencaj ŝablonoj, kiel {{ŝ|GFDL}}.
}}
}}
-
=== Special ===
+
=== Specialaj ===
-
Some other parameter combinations.
+
Kelkaj kombinoj de parametroj.
-
{{imbox
+
{{BildaMesaĝokesto
-
| text  = No type and no image given ('''default''')
+
| teksto = Nek parametro '''speco''' nek '''bildo''' estas difinitaj. (defaŭlta)
}}
}}
-
{{imbox
+
{{BildaMesaĝokesto
-
| image = none
+
| bildo = neniu
-
| text  = No type and '''image=none''' – No image is used and the '''text''' uses the whole message box area.
+
| teksto = Neniu parametro '''speco''' kaj parametro '''bildo'''=malplena – kaŭzas malplenan kesteron kun la sama grandeco kiel defaŭlta bildo.  
}}
}}
-
{{imbox
+
{{BildaMesaĝokesto
-
| type = license
+
|bildo=[[Dosiero:Gnome globe current event.svg|42px]]
-
| image = [[Image:Imbox license.svg|40px]] <br> [[Image:Ambox warning yellow.svg|40px]]
+
|bildodekstra = [[Dosiero:Nuvola apps bookcase.svg|40px]]
-
| imageright = [[Image:Shuttle.svg|30px]]
+
|teksto=<nowiki>bildo = [[Dosiero:Gnome globe current event.svg|42px]]</nowiki><br /><nowiki>bildodekstra = [[Dosiero:Nuvola apps bookcase.svg|40px]]</nowiki>
-
| text  = type = license <br> image = <nowiki>[[Image:Imbox license.svg|40px]] &lt;br> [[Image:Ambox warning yellow.svg|40px]]</nowiki> <br> imageright = <nowiki>[[Image:Shuttle.svg|30px]]</nowiki>
+
}}
}}
-
{{imbox
+
==Parametroj==
-
| type = license
+
Listo de ĉiuj parametroj:
-
| image = [[Image:Imbox license.svg|40px]] <br> [[Image:Ambox warning yellow.svg|40px]]
+
<pre style="overflow:auto;">
-
| imageright = [[Image:Shuttle.svg|30px]]
+
{{BildaMesaĝokesto
-
| text = '''This file is in the [[public domain]] because it was created by [[NASA]].'''
+
| speco  = serioza / enhavo / stilo / mikso / noto / forigo / diskuto / bona / protekto / licenco
-
<br>Note that use of NASA logos, insignia and emblems are restricted per US law.
+
| bildo = neniu / malplena / [[Dosiero:Iu bildo.svg|40px]]
 +
| bildodekstra = [[Dosiero:Iu bildo.svg|40px]]
 +
| css-stiloj = Kaskadanta Stilfolio-valoro
 +
| teksto = Mesaĝa teksto.  
}}
}}
 +
</pre>
-
=== Parameters ===
 
-
List of all parameters:
+
'''speco'''
-
<pre>
+
: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.
-
{{imbox
+
-
| type  = speedy / delete / content / style / notice /
+
-
          move / protection / license / featured
+
-
| image = none / [[Image:Some image.svg|40px]]
+
-
| imageright = [[Image:Some image.svg|40px]]
+
-
| style = CSS value
+
-
| textstyle = CSS value
+
-
| text  = The message body text.
+
-
}}
+
-
</pre>
+
-
'''type'''
+
'''bildo'''
-
:If no '''type''' parameter is given the template defaults to type '''notice'''. That means it gets a blue border.
+
-
'''image'''
+
:'''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.
-
:'''No parameter''' = If no '''image''' parameter is given the template uses a default image. Which default image it uses depends on the '''type''' parameter.  
+
:'''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:
-
:'''An image''' = Should be an image with usual wiki notation. 40px - 50px width are usually about right depending on the image height to width ratio. (Images over 52 pixels width will cause padding problems.) For example:  
+
-
::<code><nowiki>image = [[Image:Gnome-dev-camera.svg|40px]]</nowiki></code>
+
-
:'''none''' = Means that no image is used.
+
-
'''bigimage'''
+
::<code><nowiki>[[Dosiero:Unbalanced scales.svg|40px]]</nowiki></code>
-
:'''yes''' = If the image above needs to be bigger then 52px, add this parameter to the template; it causes the image cell to adapt it's width to the image instead of using a static width of 52px.
+
-
'''imageright'''
+
:'''neniu''' = Signifas, ke neniu bildo estas uzata.
-
:'''No parameter''' = If no '''imageright''' parameter is given then no image is shown on the right side.
+
:'''malplena''' = Signifas, ke neniu bildo estas uzata, sed la malplena kestero estas montrata kun sama grandeco kiel defaŭlta bildo<!--, which means that text in the message box gets aligned well with other article message boxes-->. (Vidu "specialaj" ekzemploj supre.)
-
:'''An image''' = Should be an image with usual wiki notation. 40px - 50px width are usually about right depending on the image height to width ratio. (But on this side the message box can handle images of any size.) For example:
+
-
::<code><nowiki>imageright = [[Image:Nuvola apps bookcase.png|40px]]</nowiki></code>
+
-
:'''Anything''' = Any other object that you want to show on the right side.
+
-
'''style'''
+
'''bildodekstra'''
-
:An optional [[Cascading Style Sheets|CSS]] value used by the entire message box table. Without quotation marks <code>" "</code>. For example:
+
:'''Neniu parametro''' = Se neniu '''bildodekstra'''-parametro estas difinata, tiam neniu bildo je la dekstra flanko estas montrata.
-
::<code>style = margin-bottom: 0.5em;</code>
+
:'''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:
-
'''textstyle'''
+
::<code><nowiki>[[Dosiero:Nuvola apps bookcase.png|40px]]</nowiki></code>
-
:An optional [[Cascading Style Sheets|CSS]] value used by the text cell. For example:
+
-
::<code>textstyle = text-align: center;</code>
+
-
'''text'''
+
:Io = Iu alia objekto, kiujn vi volas montrigi dekstre.
-
:The message body text.
+
-
=== Technical details ===
+
'''css-stiloj'''
-
This template currently uses hard coded styles. Later it will use CSS classes enabling it to be skinned.
+
:Opcionala [[CSS]]-valoro, kiu estas uzata por la artikola mesaĝokesto enhavanta [[HTML]] (<code><nowiki><table style="{{{style|}}}" class="..."> ... </table></nowiki></code>) Ekz.:
-
If you need to use special characters in the text parameter then you need to escape them like this:  
+
::<code><nowiki>width: 400px; color: red; font-weight: bold; font-style: italic</nowiki></code>
 +
'''teksto'''
 +
 +
:Mesaĝa teksto.
 +
 +
 +
 +
==Teĥnikaj detaloj==
 +
Se vi bezonas uzi specialajn signojn en la parametro '''teksto''', tiam vi devas "eskapi" kiel sekve:
<pre>
<pre>
-
{{imbox
+
{{BildaMesaĝokesto
-
| text = <div>
+
| teksto = <div>
-
Equal sign = and a start and end brace { } work fine as they are.  
+
Egalosigno = kaj komenca kaj fina krampoj { } funkcias bone kiel ili estas.  
-
But here is a pipe {{!}} and two end braces &lt;nowiki>}}&lt;/nowiki>.  
+
Sed ĉi tie estas dukto {{!}} kaj duoblaj finaj krampoj &lt;nowiki>}}&lt;/nowiki>.  
-
And now a pipe and end braces &lt;nowiki>|}}&lt;/nowiki>.
+
Kaj nun dukto kaj du finaj krampoj &lt;nowiki>|}}&lt;/nowiki>.
</div>
</div>
}}
}}
</pre>
</pre>
-
 
+
{{BildaMesaĝokesto
-
{{imbox
+
| teksto = <div>
-
| text = <div>
+
Egalosigno = kaj komenca kaj fina krampoj { } funkcias bone kiel ili estas.
-
Equal sign = and a start and end brace { } work fine as they are.  
+
Sed ĉi tie estas dukto {{!}} kaj duoblaj finaj krampoj <nowiki>}}</nowiki>.  
-
But here is a pipe {{!}} and two end braces <nowiki>}}</nowiki>.  
+
Kaj nun dukto kaj du finaj krampoj <nowiki>|}}</nowiki>.
-
And now a pipe and end braces <nowiki>|}}</nowiki>.
+
</div>
</div>
}}
}}
-
Internally this meta-template uses HTML markup instead of wiki markup for the table code. That is the usual way we make meta-templates since wiki markup has several drawbacks. For instance it makes it harder to use [[m:Help:ParserFunctions|parser functions]] and special characters in parameters.
+
===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 [[:m:Help:ParserFunctions|parserajn funkciojn]] kaj specifajn signojn en parametroj.
-
For more technical details see the [[Template talk:Imbox|talk page]]. Since this template works almost exactly like {{tl|ambox}} and {{tl|cmbox}} their talk pages and related pages might also contain more details.
+
-
 
+
-
=== See also ===
+
-
 
+
-
* {{tl|ambox}} – The meta-template for article message boxes.
+
-
* {{tl|cmbox}} – The meta-template for category message boxes.
+
<includeonly>
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
-
[[Category:Wikipedia metatemplates|{{PAGENAME}}]]
 
-
[[mk:Шаблон:Imbox]]
+
{{Porŝablona ŝablono}}
 +
[[Kategorio:Komunejo:Meta-ŝablono|{{PAGENAME}}]]
 +
[[Kategorio:Mesaĝoŝablonoj|{{PAGENAME}}]]
 +
[[de:Vorlage:Bildmitteilung]]
 +
[[eo:Ŝablono:BildaMesaĝokesto]]
 +
[[hsb:Předłoha:Imbox]]
</includeonly>
</includeonly>

Nuna versio ekde 17:01, 17. Okt 2010

Ŝablono:BildaMesaĝokestoDokumentadoDiskuto

Tio estas dokumentado por ŝablono {{BildaMesaĝokesto}}. Ĝi enhavas informojn pri la uzado, kategorioj ktp. de ŝablono, kiu ne estas enhavo de la ĝusta ŝablona paĝo.


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.

Enhavo

Uzado

Simipla ekzemplo de uzado:

{{BildaMesaĝokesto| teksto = Iu 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.
}}
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.

speco=serioza - serioza problemo.
speco=forigo – Proponoj por forigo.
speco=enhavo – Enhavaj mankoj.
speco=stilo – Problemetoj kaj avertetoj pri stilo.
speco=noto – Noto aŭ konsileto.
speco=mikso – proponoj por unuigo, disigo aŭ ŝovado.
speco=protekto – Protektaj ŝabonoj kiam montrata en bilda paĝo.
speco=licenco – Licencaj ŝablonoj.
speco=bona – Ŝablonoj por elstaraj bildoj.

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.

speco = stilo
bildo = [[Dosiero:Gnome-dev-camera.svg|42px]]
speco = mikso
image = [[Dosiero:To Commons.svg|52px]]
speco = licenco
bildo = [[Dosiero:Heckert GNU white.svg|48px]]
Ĉi tiu bildo estas uzata por la GFDL-licencaj ŝablonoj, kiel {{GFDL}}.

Specialaj

Kelkaj kombinoj de parametroj.

Nek parametro speco nek bildo estas difinitaj. (defaŭlta)
Neniu parametro speco kaj parametro bildo=malplena – kaŭzas malplenan kesteron kun la sama grandeco kiel defaŭlta bildo.
bildo = [[Dosiero:Gnome globe current event.svg|42px]]
bildodekstra = [[Dosiero:Nuvola apps bookcase.svg|40px]]
Dosiero:Nuvola apps bookcase.svg

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

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

Ĉ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