Helpo:Informkestoj
| Vikipediaj ŝablonoj | Informkestoj | Helpo informkestoj |
| Helpo |
|---|
|
Informkestoj estas ebleco por unueca kaj facila uzado de tabeloj, kiuj staras ĉe kelkaj artikoloj je la komenco kaj enhavas bazajn datojn. Informkestoj ĉiam estas kreataj por certa grupo de artikoloj (akuz. ĉiuj montoj, muzikaj bandoj ...).
Informkestoj estu ilustriva helpilo je "flua" teksto (germane Fließtext) kaj ne anstataŭigu tiun, sed nur kompletigu. Ĉiuj por konvena klarigo de la termino bezonataj informoj tial ankaŭ devas aperi en la "flua" teksto. Nur rezigneblaj aldonaj informoj (ekz. poŝta kodo de urbo, valoro por la konduktiveco de zinko), kiuj estas nomataj en la informkestoj, ne devas je ĉiu kazo ankaŭ aperi en la "flua" teksto, kie ekz. ŝlosilnumeroj (germane Schlüsselnummern) eĉ estus malkonvenaj.
Ekzistantaj informkestoj estu troveblaj sur la paĝo Kategorio:Ŝablono:Informkesto.
Informkestas ne estas iu barilo por blindaj uzantoj. Pli bone dirite estas navigado ene de tabelo por blinduloj pli facila ol en la "fluaj" tekstoj, ĉar inversa navigado sen problemoj eblas. Por je lernado handikapitaj legantoj estas informkestoj ankaŭ avantaĝaj, ĉar la plej gravaj faktoj estas rapide superrigardeblaj.
Enhavo
|
[redakti] Enmetado de informkestoj en artikolojn
Skribu informkeston en la unuan linion de la artikolo, se tie ne staras unu el la sekvaj ŝablonoj:
- {{Apartigila paĝo}}, {{Apartigila sekcia paĝo}} aŭ {{TemasPri}}
- {{forigu}}
- {{redaktata}} aŭ {{Redaktas}}
[redakti] Kreado de informkestoj
Unue devas esti difinataj la parametroj de nova informkesto. Por nedevigaj parametroj vi povas uzi la informojn de la paĝo Vikipedio:Kondiĉaj ŝablonoj.
Bonvolu uzi laŭeble la vikian sintakson por tabelo de la informkesto.
[redakti] Nomo kaj aspekto de informkesto
La sekvajn ecojn laŭeble havu informkesto.
- La ŝablona nomo sekvu la iam proponitan nomskemon, por ke oni povu iom pli facile retrovi ĝin kaj por ke ni havu unuecon.
- Ĝi staru je la dekstra supra angulo.
- Ĝi larĝu 23em, precipe se uzeblu du aŭ tri unu sub alia en la sama artikolo. (Vidu {{biografiaj ŝablonoj}})
- Ĝi ankaŭ enhavu sian titolon.
- Informkesto havu du kolonojn, precipe se ili estu nesteblaj.
- La ĉefa titolo havu pli malhelan koloron ol aliaj linioj.
- Ĉiuj informkestoj havu nomon laŭ la skemo "Informkesto temo".[1]
- Ĝi uzu laŭeble la CSS-klasojn por formatoj.[1]
La sekvaĵojn ni prefere evitu:
- Kodado de la komencaj frazoj de artikolo ene de informkesto.
- Entute majusklajn parametrojn ni evitu, ĉar ili bezonas pli da atento dum la ŝablona uzado.
[redakti] Kodaj elementoj [2]
Ĉiuj informkestoj konsistas el la jenaj elementoj:
- komenco laŭ vikia tabelsintakso
- titola linio
- enhavo
- fina linio
[redakti] Komenco de informkesto
La kodo de tipa komenco de informkesto aspektas pli-malpli tiel:
{| class="infobox" style="width:23em; border: 1px #aaa solid; background: #F2F2F2;" id="infobox-nomo" summary="Informkesto nomo"
- Kion signifas apartaj elementoj de kodo oni povas trovi en la priskribo de la CSSa aŭ HTMLa stiloj.
La atributo class kun la valoro infobox estu laŭeble uzata, por havi unuecan aspekton de la informkestoj. Ĉi tiu klaso difinas, ke informkesto staras ĉe la dekstra rando de la paĝo kaj havas certan desajnon. Sed antaŭ la valoro infobox povas aperi pliaj klasoj, se necese.
Per helpo de la atributo id povas esti aldonata unusenca nomo, por ke alsalutintaj uzantoj povu adapti la aspekton de la informkesto per propra vector.css (vidu Vikipedio:CSS kaj JS), inklude de eventuala kaŝado de informkesto. La valoro de ĉi tiu atributo nur enhavu (mal)grandajn literojn de A ĝis Z, ciferojn, minuson kaj malsupran linieton kaj devas komenci kun unu el la antaŭe nomitaj literoj. Do kromsignoj ne eblas.
La atributo summary estas uzata de Screenreader. La resumo faciligas al vide handikapuloj la rekonon de la informkesto.
La valoro width:23em ĉe la atributo style aŭ simila estu laŭeble uzata, por doni al informkesto certan larĝecon kaj ankaŭ eviti, ke tro larĝaj elementoj en la informkesto povas difektigi la desajnon.
[redakti] Titolo
Tio estas la titola linio por la ĉefa superskribo de la tabelo.
|+ style="background-color:#e0e0e0;" class="kaplinio io" | {{{nomo}}}
Atentigo: CSS-klasoj "kaplinio" kaj "io" sed ankaŭ kelkaj aliaj ebligas individuan formatigon de la superskriboj de la tabelo. Krom tio ekzistas aldonaj CSS-formatoj, por plibeligo la informkestoj.
Anstataŭ |+ alternative eblas | aŭ !. Sed tiam devas esti uzata aldona atributo colspan="2", se la informkesto havas du kolumnojn. Ekz.
| colspan="2" style="background-color:#e0e0e0;" class="kaplinio io" | {{{nomo}}}
aŭ
! colspan="2" style="background-color:#e0e0e0;" class="kaplinio io" | {{{nomo}}}
- Iomete pli kompleksa kodo
Anstataŭ la parametro {{{nomo}}} povas esti uzata iomete pli kompleksa kodo.
! colspan="2" style="background-color:#e0e0e0;" class="kaplinio io" | {{#if: {{{nomo|}}}|{{{nomo}}}|{{PAGENAME}} }}
Tiam eblas, ke dum la uzado de la informkesto en artikolo eĉ povas esti forgesata la nomita parametro, sen tio ke neniu teksto tie estas montrata.
[redakti] Linio por enhavo
La sekva estas la unua enhava linio de la tabelo. Tre malofte estas uzataj superskribaj ĉeloj.
- Varianto, kiu okupas du kolumnojn
|-
| colspan="2" style="text-align:center; background-color: blue; font-size:120%; font-weight:bold" | {{{nomo}}}
En la atributo style povas aperi ĉiuj eblaj CSS-formatoj. La colspan="2" kaŭzas, ke du ĉeloj kunfandiĝas, kiuj alikaze estus en sinsekvaj kolumnoj.
- Varianto kiu estas duĉela
|-
| style="text-align:center; background-color: blue; " | Priskribo || {{{parametro-1}}}
La maldekstra ĉelo enhavas la tekston Priskribo, dum ke la dekstra enhavas la valoron de {{{parametro-1}}}.
[redakti] Nedeviga linio por enhavo
La sekva estas iu nedeviga enhava linio de la tabelo.
|-
{{#if:{{{parametro-1|}}}|
{{!}} style="text-align:center; background-color: blue;" {{!}} '''Priskribo''' {{!!}} {{{parametro-1}}}
}}
Pro teknikaj kialoj necesas uzi la ŝablonojn {{!}} kaj {{!!}} anstataŭ |, ĉar | en {{#if:-bloko estas uzata por disigi parametrojn.
[redakti] Por bildo
Se la nedeviga enhava linio enhavus bildon, uzeblas la jena kodo:
|-
{{#if:{{{bildo|}}} |
{{!}} colspan="2" {{!}} [[Dosiero:{{{bildo}}}|rand|center|{{#if:{{{bilda larĝo|}}} | {{{bilda larĝo}}} | 250x200px}}|alternativtext=|{{{bilda priskribo}}}]] <p style="text-align:center; font-size:90%;"> {{{bilda priskribo}}} </p>
}}
Per tio bildo povas esti enmetata per la parametro bildo kaj bilda priskribo. La parametro bilda larĝo estas ĉi tie nedeviga. La antaŭdifinita bilda larĝo estu tiel larĝa kiel la informkesto. Larĝo de pli ol 250 pikseloj prefere estu evitataj.
[redakti] Malsupra linio
Kaj tiel aspektas la fino de la tabelo, post kiu ĉiam sekvu <noinclude>{{dok}}</noinclude> aŭ simila por dokumentado. Sed ankaŭ kategorioj povas stari inter ĉi tiuj du HTML-etikedoj.
|}<noinclude>{{dok}}</noinclude>
Anstataŭ {{Dok}} vi povas uzi unu el la jenaj ŝablonoj, se la dokumentado estas malgranda:
Vidu ekzemplon: Helpo:Informkestoj/ekzemplo.
[redakti] Ekzemplo sen helpaj ŝablonoj
{| class="infobox" cellspacing="7" border="0"
| colspan="2" class="kaplinio io" style="background-color:#8C8C8C;" | {{#if:{{{nomo|}}} | {{{nomo|}}} | {{PAGENAME}} }}
|-
{{#if:{{{bildo|}}} |
{{!}} colspan="2" style="text-align:center;" {{!}} {{{bildo|}}}{{#if:{{{bilda priskribo|}}}|<br /><small>{{{bilda priskribo|}}}</small>}}<hr />
{{!-}}
}}
{{#if:{{{parametro 1|}}} |
! [[parametro 1]]
{{!}} {{{parametro 1|}}}
{{!-}}
}}
{{#if:{{{parametro 2|}}} |
! [[parametro 2]]
{{!}} {{{parametro 2|}}}
{{!-}}
}}
|}<noinclude>{{dok}}</noinclude>
Bonvolu ne uzi margin ĉe la supra elemento {|, ĉar tio havas influon sur la korektigajn paĝojn MediaWiki:Old-gecko.js kaj MediaWiki:Old-gecko.css por pli malnovaj versioj de Gecko-foliumiloj, se vi samtempe uzas |+ por la titola linio de la informkesto.
[redakti] Helpaj ŝablonoj
| Trajto | Speco | Komento |
|---|---|---|
| CSS-formatoj |
|
|
|
||
|
||
|
||
| Jam enhavas kodigon por nedeviga parametro. | Ne | |
| Jes |
Por tio vi povas uzi unu el la sekvaj kodaj elementoj
- Ŝablonoj por aranĝi certan nombron de apudaj tabeloĉeloj (laŭ rusa kaj sorabaj vikipedioj)
- Ŝablonoj por krei la kvar eblajn partojn de informkesto (laŭ franca vikipedio)
- {{Informkesto/Komenco}} kreas la tabelan komencon kun kelkaj formatoj
- {{Informkesto/Titolo}} enmetas la kaplinion kun titolo kaj la klasoj kaplinio io ktp.
- Enhava parto
- {{Informkesto/Bildo}} aranĝas bildon
- {{Informkesto/Opcia linio}} aranĝas nedevigajn parametrojn (Priskribo kaj teksto aperas en la sama tabela ĉelo.)
- {{Informkesto/Opcia linio2}} aranĝas nedevigajn parametrojn (Priskribo kaj teksto aperas en apartaj tabelaj ĉeloj.)
- {{Informkesto/Opcia subtitolo}} aranĝas subtitolon
- {{Informkesto/Geografia lokigo multobla}} aranĝas enmeti multoblajn bildojn pri geografia lokigo
- {{Informkesto/Fino}} finas la tabelon
- Ŝablonoj por enmeti bildojn duope unu apud alia (laŭ la suprasoraba vikipedio)
- {{Informkesto/bildoj}} enmetas du bildojn unu apud la alia. La priskribo aperas sub la koncerna bildo.
- {{1aŭ2bildoj}} enmetas du bildojn unu apud la alia. La priskribo aperas super la koncerna bildo.
Jen ŝablonoj, kiu ebligas krei la tutan informkeston (Detaloj troviĝas en la tieaj dokumentadoj.):
- {{Informkesto}} (Por kutimaj informkestoj, pli malpli laŭ hsb:Předłoha:Infokašćik, iom malpli laŭ de:Vorlage:Infobox),
- {{Informkesto2}} (Nur por malgrandaj, eble eĉ rekreenda.),
- {{Informkesto3}} (Por kompleksaj informkestoj, pli malpli laŭ en:Template:Infobox)
Por superskribo ankaŭ povas esti uzata la ŝablono {{Skatoltitolo}} jene:
{{skatoltitolo|Teksto}}
Se oni bezonas nedevigan parametron, eblas jena kodigo:
{{#if:{{{nedeviga parametro|}}}|{{skatoltitolo|Teksto}}}}
Por netitola linio vi povas uzi la ŝablonon {{Skatolero}}, por kiu krome ekzistas ekzemploj en la ŝablono {{Informkesto kemia elemento}}.
Vidu ankaŭ Kategorio:Vikipedio:Porŝablonaj ŝablonoj.
[redakti] Ŝablonoj "1 ĉelo en linio" kaj "1 ĉelo en linio/kaplinio"
- Laŭ sorabaj kaj rusa modeloj
Se vi uzas krom la ŝablono {{1 ĉelo en linio}} aŭ {{1 ĉelo en linio/kaplinio}} ankaŭ unu el la ŝablonoj {{2 ĉeloj en linio}} kaj {{2 ĉeloj en linio/kaplinio}}, vi bezonas la valoron colspan="2" kiel en la ekzemplo. Sed se vi uzas nur {{1 ĉelo en linio}} aŭ {{1 ĉelo en linio/kaplinio}}, ĉi tiu valoro devas esti forlasita.
{{1 ĉelo en linio
|atributoj=style="background-color:#e0e0e0; (kaj pliaj CSS-formatoj)" colspan="2"
|datoj=iu teksto
}}
Por nedevigaj parametroj vi povas uzi varianton kun parseraj funkcijoj.
{{#if:{{{parameter|}}}|
{{1 ĉelo en linio
|atributoj=style="background-color:#e0e0e0; (kaj pliaj CSS-formatoj)" colspan="2"
|datoj=iu teksto
}}
}}
[redakti] Ŝablonoj "2 ĉeloj en linio" kaj "2 ĉeloj en linio/kaplinio"
- Laŭ sorabaj kaj rusa modeloj
{{2 ĉeloj en linio | liniaj atributoj=style="font-size: 90%;"
| datoj1=nomo
| atributoj2=style="white-space: nowrap;"
| datoj2=senco
}}
Por nedevigaj parametroj vi povas uzi varianton kun parseraj funkcijoj.
{{#if:{{{parameter|}}}|
{{2 ĉeloj en linio | liniaj atributoj=style="font-size: 90%;"
| datoj1=nomo
| atributoj2=style="white-space: nowrap;"
| datoj2=senco
}}
}}
[redakti] Ekzempla fontokodo
Ekzempla ŝablono enhavas la sekvan kodon:
{{#if:{{{S RG|}}}{{{S WM|}}}{{{S US|}}}|
{{1 ĉelo en linio/kaplinio
|datoj=<center>'''unuopa ludo'''</center>
|atributoj=style="background:#d0d0d0;" colspan="2"
}}
}}
Tio difinas kaplinion kun la teksto unuopa ludo, kiu aperu nur tiam, se minimume unu el la parametroj S RG, S WM, S US estas difinita.
[redakti] Ekzemplo kun videbla superskribo
Se vi aldonas ĉiun parametrojn de la ŝablono tiel:
{{2 ĉeloj en linio/ekzemplo
|nomo = Gustavo Kuerten
|naskiĝdato = 10an de septembro 1976
|S RG = W (1997, 2000 - 2001)
|S WM = QF (1999)
|S US = QF (1999, 2001)
|www = http://guga.com/
}}
tiam aperas:
| Gustavo Kuerten | |
| naskiĝdato | 10an de septembro 1976 |
|
|
|
|---|---|
| Roland Garros | W (1997, 2000 - 2001) |
| Wimbledon | QF (1999) |
| US Open | QF (1999, 2001) |
| Interreta paĝo | |
[redakti] Ekzemplo kun kaŝita superskribo
Se vi forlasas kelkajn parametrojn de la ŝablono kiel ekz. tiel:
{{2 ĉeloj en linio/ekzemplo
|nomo = Gustavo Kuerten
|naskiĝdato = 10an de septembro 1976
|www = http://guga.com/
}}
tiam aperas:
| Gustavo Kuerten | |
| naskiĝdato | 10an de septembro 1976 |
| Interreta paĝo | |
|---|---|
Ĉimaniere nemontriĝas malplena superskribo unuopa ludo en la informkesto.
[redakti] Koda elemento por bildoj
Por bilda linio povas esti uzata la ŝablono {{skatolbildo}}. Ekzemplo troviĝas en la ŝablono {{Informkesto kemia elemento}}.
{{skatolbildo|{{{Dosiero}}}|270px|{{{Aspekto}}}}}
Se oni bezonas nedevigan parametron la kodigo similas al la jena:
{{#if:{{{Dosiero|}}}|{{skatolbildo|{{{Dosiero}}}|270px|{{{Aspekto}}}}}}}
[redakti] Parametroj
Gravas, doni konvenan nomon al la parametroj. Bonvolu eviti laŭeble majusklojn, mallongigojn, diminutivojn, pluralon.
[redakti]
Bona
Ĉi tiu varianto estas bona, ĉar ĝi estas bone superrigardebla kaj la parametroj klarigas per si mem siajn funkciojn. Krome | je la komenco de linio plifaciligas la aldonon de valoroj.
{{Informkesto nomo de informkesto
| nomo =
| bildo =
| legendo =
| plia =
}}
[redakti]
Malbona
{{Informkesto nomo de informkesto|
nomo =|
bildo =|
legendo =|
plia =|
}}
aŭ
{{Informkesto nomo de informkesto
|nomo =
|wob =
|leg =
|pli =
}}
[redakti] Kontrasto
La kolora kontrasto en informkestoj devas esti tia, ke ĉiuj uzantoj facile povas legi la tekstojn.
|
|
||||||||
[redakti] Dokumentado
Bonvolu enskribi ankaŭ ŝablonon por dokumentado en la informkeston. Por tio vi povas uzi la ŝablonon {{Dok}} aŭ {{ŝabloninformo}}. Detaloj troviĝas en la koncernaj ŝablonaj paĝoj. Sed atentu, ke ili ĉiukaze devas stari inter <noinclude> kaj </noinclude>, por ke la dokumentado ne aperu en artikoloj dum la uzado de la koncernata ŝablono.
La dokumentado enhavu la jenon:
- celo de la ŝablono
- malplena kodo por kopiado en artikolojn
- klarigo de la parametroj
- ekzemplo(j)
Ĉe la klarigo de la parametroj estu menciata, kiuj el ili estas devigaj aŭ nedevigaj.
La ekzemplo montru kiel la informkesto aspektas en artikolo.
[redakti] Truketo por certa parametro
Se estas bezonata parametro, kiu funkciu jene:
- se ĝi ne estas uzata, aperu la defaŭlta valoro
- se ĝi estas malplena, ankaŭ aperu la defaŭlta valoro
- se ĝi estas uzata kun valoro, la valoro estu konvene traktata
aplikatas kodo laŭ la sekva ekzemplo
! colspan="2" style="text-align:center; background-color:{{#if:{{{background|}}}|<nowiki/>{{{background}}}|{{Informkesto homoj/koloro}}}};" class="kaplinio persono" |{{{Nomo}}}
La kompleta kodo troviĝas en la ŝablono {{Informkesto homoj}}. Krome la ĉitiea kolordifino troviĝas en la subŝablono {{Informkesto homoj/koloro}}, kie ĝi estas metata inter <nowiki> kaj </nowiki>, por "superruzi" la parseron.