Saltu al enhavo

Ŝablono:Unuo/dokumentado

El Vikinovaĵoj, libera retgazeto
Dokumentado
Ĉi tio estas dokumentado por la ŝablono {{Unuo}}.
Ĝi enhavas informojn pri la uzado de la ŝablono, ĝiaj kategorioj kaj interlingvaj ligiloj.
Kaj ĝi ne estas enhavo de la ŝablona paĝo mem.

Uzado[redakti]

La ŝablono {{unuo}} ebligas facile skribi nombron sekvatan de unuo. Kompare al rekta skribo, la avantaĝoj estas :

  • aŭtomata formatado de nombro, arigante la ciferojn laŭ grupoj de tri, kiel en « 30 000 animoj » (tamen en la kazo de nombro sen unuo sufiĉas uzi la ŝablonon {{nombro}} aŭ la kodon {{formatnum:}}) ;
  • evitado de aŭtomata salto al la sekvanta linio inter la nombro kaj la responda unuonomo, kiel en « 30 km » fine de linio ;
  • faciligo de la skribo de la eksponentoj kaj de la multopaj unuoj, kiel en « 10 m⋅sŜablono:Eksp ».

Sintakso[redakti]

Parametroj[redakti]

La ŝablono povas enhavi ĝis naŭ numeritaj parametroj kaj unu nomita parametro :
Parametro Priskribo Tipo
1= Videbligota valoro Deviga
e= Videbligota potenco 10 Opcia
2= Unua simbolo Opcia
3= Eksponento de la unua simbolo Opcia
4= Dua simbolo Opcia
5= Eksponento de la dua simbolo Opcia
6= Tria simbolo Opcia
7= Eksponento de la tria simbolo Opcia
8= Kvara simbolo Opcia
9= Eksponento de la kvara simbolo Opcia
Eblas specifi kompleksan unuon per sola parametro aŭ dispartigi ĝin laŭ formo de listo simbolo|eksponento. Eblas ankaŭ ne enmeti eksponenton (kiam ĝi valoras unu) ; por tio, sufiĉas lasi ĝin malplena. Eblas videbligi maksimume kvar simbolojn, ĉiu kun eksponento.

Ŝablono:Atenton

Ekzemploj de uzado[redakti]

Sintakso Rezulto Komento
{{Unuo|1234567}}
{{Unuo|1234567.89}}
{{Unuo|1.23456789|e=15}}
1 234 567
1 234 567,89
1,23456789Ŝablono:X10
Kazo de minimuma uzo : sola valoro (sen unuo), eventuale kun uzo de potencoj 10 (scienca uzado) en la parametro nomita e, formatata helpe de la ŝablono {{x10}}. La uzo de la ŝablono nur por valoro ekvivalentas al la uzo de la speciala ŝablono {{formatnum:}}.
{{Unuo|10000|km}}
{{Unuo|10000|km/h}}
10 000 km
10 000 km/h
Kazo de minimuma simpla uzo : valoro sekvata de simbolo.
{{Unuo|10000|km|2}}
{{Unuo|10000|m|3}}
10 000 kmŜablono:Eksp
10 000 mŜablono:Eksp
Kazo de uzado por unuo kun Eksponento.
{{Unuo|10000|kilometroj hore}} 10 000 kilometroj hore (ne konsilata) Eblas skribi la unuon per vortoj. Tiukaze, tamen, ne necesas strikte malebligi linifinan rompon inter la nombro kaj la kompleta unuonomo, nur la unua vorto devas resti ligita al la nombro, tie « {{Unuo|10000|kilometroj}} hore ». Rimarku ke la ŝablono {{Unuo}} (kia {{nobr}}) malebligas la linifinajn rompojn en la tuta esprimo « 10 000 kilometroj hore ».
{{Unuo|10000|km||h|-1}} 10 000 km⋅hŜablono:Eksp Du sinsekvaj simboloj, la dua kun eksponento.
{{Unuo|10000|J|2|K|3|s|-1}} 10 000 JŜablono:Eksp⋅KŜablono:Eksp⋅sŜablono:Eksp Tri simboloj kun du apartaj eksponentoj.
{{Unuo|10000|J||kg||m|-2}} 10 000 J⋅kg⋅mŜablono:Eksp Tri simboloj, la du unuaj sen eksponento.
{{Unuo|-40.234|°C}} −40,234 °C Kazo evidentiganta la uzon de la angla-usona notacio en la unua parametro, kiu estas videbligota laŭ la esperanta konvencio.
{{Unuo|1.23456|e=9|J|2|K|3|s|-1}} 1,23456Ŝablono:X10 JŜablono:Eksp⋅KŜablono:Eksp⋅sŜablono:Eksp Tri simboloj kun apartaj eksponentoj, evidentiganta la uzon de la angla-usona notacio, same kiel la uzon de potencoj 10 (scienca uzado) en la parametro nomita e, formatota de la ŝablono {{x10}}.
{{Unuo|1|[[kvadrata kilometro|km{{eksp|2}}]]}} 1 [[kvadrata kilometro|kmŜablono:Eksp]] Eblas ankaŭ enmeti ligilon al la unuoj.

Nombroj sen unuo[redakti]

Kvankam tiu ŝablono funkcias ankaŭ en tiu kazo, por videbligi kvanton sen unuo, ne necesas uzi ĝin. Tiam la ŝablono {{nombro}} aŭ la magia vorto « {{formatnum:}} » plene sufiĉas:

{{nombro|nombro}}
aŭ
{{formatnum:nombro}}

(Rimarku la eston de dupunkto anstataŭ vertikala streko). Por la nombroj laŭ scienca notacio sen unuo, vi povas uzi la ŝablonon {{x10}}.

En kiuj kazoj ne uzi tiun ŝablonon ?[redakti]

Rezulto identa por viki-kodo multe pli simpla por fari sen modelo
Viki-kodo Rezulto en HTML
{{Unuo|20|%}} 20Ŝablono:Ruĝa%
20 % 20Ŝablono:Ruĝa%
20 % 20Ŝablono:Ruĝa%

Tiu ŝablono estas neutila kiam la unuo estas procento.

Principe, oni devas meti neapartigeblan spacon inter la nombro kaj la signo « % », kiu sekvas ĝin. Tial, oni povus opinii ke tiu ŝablono utilas ankaŭ en tiu kazo.

Sed en vikipedio, ne necesas mane aldoni neapartigeblan spacon antaŭ la signo « % » : nu, normala spaco sufiĉas, ĉar MediaWiki (la programaro uzata de Vikipedio) aŭtomate transformas tiun spacon en neapartigeblan spacon (vi povas videbligi la kodon en HTML de la paĝo por konstati tion).

Fakte, tio ne estas nur neutila, sed ankaŭ malkonsilenda, ĉar tio plikomplikigas la skribon kaj malfaciligas la legadon de la vikia kodo por identa rezulto.

Noto: Tamen, tiu ŝablono devas esti uzata kiam la unuo estas « promilo ». {{Unuo|5|‰}} videbligos : 5 ‰.

Konata problemo[redakti]

Kiam la rezulto de la ŝablono {{Unuo}} estas inter rondaj krampoj, kiel en (1 309 m), iuj TTT-legiloj permesas linifinan rompon inter unu el la krampoj kaj la esprimo. Tiu problemo estis konfirmita kun Internet Explorer 5.5, 6 kaj 7, sed ĝi ŝajnas esti korektita en la versio 8.0.

Vidu ankaŭ[redakti]