Ŝablono:Np/dokumentado

Foje okazas, ke en iu artikolo nombra parametro de iu ŝablono (tre verŝajne informkesto) havas nenombran signifon. La ŝablono {{np}} (nombra parametro) provizas facilan manieron kontroli tion en la kodo de ŝablonoj. Sed atentu: se vi ne posedas la lingvon por markado de ŝablonoj, ĉi tiu ŝablono apenaŭ helpos vin.

Se la signifo, transdonita al ĉi tiu ŝablono, estas nombro, la ŝablono formatos ĝin (kaj, se estas indikita, mezurunuon). Se la signifo ne estas nombro, la ŝablono montros ĝin (kaj, se necesas, mezurunuon) senŝanĝe, montros erarmesaĝon kaj, se la ŝablono troviĝas en artikolo, aldonos tiun artikolon al la kaŝita kategorio Nenombraj signifoj de nombraj parametroj.

Parametroj

La ŝablono traktas ĝis tri sennomajn kaj unu nomitan parametrojn:

1. (deviga) parametra nomo, ĉirkaŭita per tri paroj de figuraj krampoj (do, ne nomo sed signifo de la esplorata parametro);
2. (nedeviga) mezurunuo;
3. (nedeviga) estas sama kiel la dua kaj povas esti uzata anstataŭ ĝi.

La nomita parametro estas ŝablono. Ĝi ne estas deviga, tamen estas ege dezirinde uzi ĝin. Ĝia valoro estu la nomo de la ŝablono, en kies kodo vi uzas la ŝablonon {{np}} (sen la vorto ŝablono); ekzemple, en la kodo de la ŝablono {{Informkesto akvofalo}} tio estas |ŝablono=Informkesto akvofalo.

La tabelo montras diferencon inter la dua kaj tria parametroj.

la dua kaj tria	unua
	nombro	ne nombro
dua plenigita	unua kaj dua formatite	unua kaj dua senŝanĝe
dua malplena, tria plenigita	unua kaj tria formatite	unua senŝanĝe

Plej verŝajne, vi ne bezonos la trian parametron: indiku mezurunuon en la dua parametro. La tria parametro necesas nur tiam, kiam en pluraj artikoloj koncerna informkesta parametro estas plenigita per ambaŭ nombro kaj mezurunuo (ekzemple, tio povas okazi, se la informkesta dokumentaro antaŭe rekomendis tion). Se vi ne certas, uzu la duan parametron.

Uzite sen parametroj, la ŝablono donos nenion.

Ekzemploj

kodo	rezulto
	kun 1234	kun ĉ. 1234
<!-- unua kaj dua --> {{#if:{{{Distanco|}}}| Distanco: {{np|{{{Distanco}}}|km|ŝablono=Informkesto akvofalo}} }}	Distanco: 1 234 km	Distanco: ĉ. 1234 km
<!-- unua kaj dua --> {{#if:{{{Distanco|}}}| Distanco: {{np|{{{Distanco}}}|km}} }}	Distanco: 1 234 km	Distanco: ĉ. 1234 km
<!-- nur unua --> {{#if:{{{Numero|}}}| Numero: {{np|{{{Numero}}}|ŝablono=Informkesto akvofalo}} }}	Numero: 1 234	Numero: ĉ. 1234
<!-- nur unua --> {{#if:{{{Numero|}}}| Numero: {{np|{{{Numero}}}}} }}	Numero: 1 234	Numero: ĉ. 1234
ne faru tiel: «{{np}}»	«»

kodo	rezulto
	kun 1234	kun ĉ. 1234	kun 1234 km
<!-- unua kaj dua --> {{#if:{{{Distanco|}}}| Distanco: {{np|{{{Distanco}}}|km|ŝablono=Informkesto akvofalo}} }}	Distanco: 1 234 km	Distanco: ĉ. 1234 km	Distanco: 1234 km km
<!-- unua kaj dua --> {{#if:{{{Distanco|}}}| Distanco: {{np|{{{Distanco}}}|km}} }}	Distanco: 1 234 km	Distanco: ĉ. 1234 km	Distanco: 1234 km km
<!-- unua kaj tria --> {{#if:{{{Distanco|}}}| Distanco: {{np|{{{Distanco}}}||km|ŝablono=Informkesto akvofalo}} }}	Distanco: 1 234 km	Distanco: ĉ. 1234	Distanco: 1234 km
<!-- unua kaj tria --> {{#if:{{{Distanco|}}}| Distanco: {{np|{{{Distanco}}}||km}} }}	Distanco: 1 234 km	Distanco: ĉ. 1234	Distanco: 1234 km

Vidu ankaŭ

• {{ĈuNombro}}
• {{ĈuNombro2}}
• {{Unuo}}
• {{Atentigo pri numeroj}} estu metata en la dokumentadon de ŝablonoj, kiuj enplektas {{np}}