Šablona:Val

Dokumentace  

Tato šablona používá programovací jazyk Lua: Modul:Module:Val Modul:Module:Val/units

Toto šablona slouží pro formátování číselných hodnot ve vědecké notaci včetně uvedení fyzikálních (nebo jiných) jednotek a případné chyby měření nebo tolerance, jak to předepisuje Stylový manuál Wikipedie v části .

Popis

{{Val}} zajišťuje formátování čísel především ve vědecké notaci, s případným uvedením chyby měření, a s uvedením fyzikálních jednotek. Cílem je, aby výstup odpovídal Stylovému manuálu Wikipedie, a aby zápis číselné hodnoty a jednotky byl vždy na jednom řádku.

Výpis čísel:

• {{val|123456.78901}} → hodnota, formátovaná s mezerami: 123456,78901
• {{val|number|number}} → hodnota ± chyba měření, např. 12347,85±0,25
• {{val|number|(number)}} → hodnota(nejistoty), jako 12345(56)
• {{val|number|number|number}} → hodnota  +tolerance
  −tolerance  jako 1234+56
  −78

Výpis hodnot včetně fyzikální veličiny:

• {{val|4|ul=m2}} → 4 m². m2 je „kód jednotky“, který šablona Val používá pro vyhledání odkazu na článek o jednotce a k formátování symbolu jednotky. Val propojuje jednotky se stránkami, které o nich má uložené. Viz Šablona:Val/list.

Šablona Val rozumí velkému počtu kódů jednotek a udržuje je „v souladu s normami“. Kód jednotky je pouze zkratka pro jméno jednotky, ale u složených nebo kombinovaných jednotek s „násobiteli“ nebo „děliteli“ může být poměrně složitý. Viz Modul:Val/units.

Určitá flexibilitu při zpracování kódů jednotek poskytují čtyři parametry, jejichž výběrem lze stanovit, zda vytvořit odkaz či nikoli (viz Nadměrné odkazování), a zda se nejedná o jednotku v čitateli:

• {{val|number|ul=unit code}} → číslo symbol, jako je 9,8 km²
• {{val|number|u=unit code}} → číslo symbol, jako je 9,8 km²
• {{val|number|u=unit code|upl=unit code}} → číslo symbol/symbol, jako je 9,8 gal/min
• {{val|number|ul=unit code|up=unit code}} → číslo symbol/symbol, jako je 9,8 pc/a

Pokud |u nerozpoznává kód jednotky, je možné použít zápis pomocí wikitextu, který Val zobrazí obvyklým způsobem.

• {{val|5.4|u=[[kg]]&sdot;[[meter|m]]/s<sup>2</sup>}} → 5,4 kg⋅m/s²
• {{val|7.6|u=[[metre za sekundu squared|m/s<sup>2</sup>]]}} → 7,6 m/s²

V Modul:Val/units je popsáno, jak doplnit jednotku do seznamu, který se používá na české Wikipedii.

Ve zvláštních případech lze celý zápis hodnoty a jednotky doplnit předponou a příponou: |p a |s.

• {{val|7600|u=C&sdot;Ga|p=>|s=<}} → >7600 C⋅Ga<
• {{val|7600|u=C|p=<span style="color:green"><sup>|s=</sup></span>}} → ^7600 C

Stránka {{val/testcases}} poskytuje množství ukázek, jak používat parametry šablony Val.

Parametry

Podrobnější informace naleznete na stránce Help:Template#Parameters.

Šablona Val má tři nepojmenované parametry. První je vždy numerická hodnota. Pokud druhý a třetí parametr jsou čísla, vypíšou se jako chyby měření nebo odchylky; druhý nepojmenovaný parametr však může také sloužit pro spojení prvního a třetího čísla.

Val ignoruje mezery okolo nepojmenovaných parametrů.

1. nebo |1	Číslo. Při zadání se používá desetinná tečka, ale na stránkách české Wikipedie se objeví s desetinou čárkou; pro zápis čísel ve vědecké notaci se používá znak e pro zápis charakteristiky (exponentu). Číslo zadané prvním parametrem je základem formátování šablonou Val. {{val|1234567.1234567}} → 1234567,1234567 {{val|.1234}} → 0,1234                    (doplní nulu) {{val|+1234}} → +1234                     (zobrazí plus) {{val|-1234}} → −1234                     (nahradí pomlčka-minus znakem minus) {{val|12e34}} → 12×1034                (E notace)
|fmt	Umožňuje změnit implicitní formátování čísla šablonou Val, které odděluje trojice číslic nalevo i napravo od řádové čárky mezerou (u čísel s více než 4 ciframi) a používá řádovou čárkou jako desetinnou značkou. Ve čtyřciferných celých číslech se první číslice neodděluje; použití |fmt = gaps oddělení vynutí. |fmt = none vypne formátování (trojice číslic se neoddělují mezerou a tečka jako desetinná značka) |fmt = gaps vynutí vložení mezery i do čtyřciferného čísla |fmt = commas odděluje trojice číslic čárkami (plete se s desetinnou značkou) {{val|1234567.1234567}} → 1234567,1234567 {{val|1234567.1234567|fmt=commas}} → 1,234,567,1234567 {{val|1234}} → 1234 {{val|1234|fmt=gaps}} → 1234 {{val|1234.5}} → 1234,5 {{val|1234.5|fmt=none}} → 1234.5
|end	Wikitext, který se přidá za hlavní číslo (před cokoli, co následuje). {{val|11|end=[END]}} → 11[END] {{val|11|22|end=[END]}} → 11[END]±22 {{val|1111|(22)|end=[END]}} → 1111[END](22) {{val|11|22|33|end=[END]}} → 11[END]+22 −33 {{val|11|ul=m/s|end=[END]}} → 11[END] m/s
2. nebo |2	chyba měření v libovolném formátu. {{val|11|22}} → 11±22 {{Val|11|(22)}} → 11(22) Spojka pro spojení dvou čísel. Užitečné pro zápis rozsahů, vložení textové spojky, apod. {{val|11|-|33}} → 11–33 {{val|11|–|33}} → 11–33 {{val|11|,|33}} → 11, 33 {{val|11|times|33|e=9}} → {{val|11|and|33|end=[[$]]}} → 11$ a 33$ {{val|11|or|33}} → 11 nebo 33 {{val|11|to|33}} → 11 až 33 {{val|11|x|33}} → 11 × 33 {{val|11|×|33}} → 11 × 33 {{val|11|/|33|ul=m/s}} → 11/33 m/s Všimněte si, že při použití čárky nebo znaků x je výsledkem vždy výstup ve správném stylu.
3. nebo |3	Asymetrický nejistoty. {{Val|11|22|33}} → 11+22 −33
|errend nebo |+errend a |-errend	Přidá wikitext za chybu měření nebo toleranci. {{val|11|22|errend=[Errend]}} → 11±22[Errend] {{val|11|22|33|+errend=[+Errend]|-errend=<−Errend>}} → 11+22[+Errend] −33<−Errend>
|u nebo |ul	Kód jednotky. Val přidává mezera a jednotka. |ul Odkaz na jednotku. |u Bez odkazu na jednotku. Místo kódu jednotky lze zadat také libovolný wikitext. {{val|11|ul=m}} → 11 m
|up nebo |upl	Kód jednotky, ale místo mezera Val přidává lomítko a jednotka, „na“ jednotka ( jmenovatel), pro vytvoření poměr. |upl Odkaz na jednotku. |up Bez odkazu na jednotku. Poměr může být ze dvou kódů jednotek nebo z předpony a kódu jednotky. Pokud kód jednotky obsahuje tečku nebo lomítko, Val přidá závorky pro zjednoznačnění. {{Val|11|ul=J/C|upl=F/m}} → 11 (J/C)/(F/m) {{Val|11|upl=acre|p=$}} → $11/acre {{Val|11|ul=km/s|upl=Mpc}} → 11 (km/s)/Mpc {{Val|11|ul=kg.m|upl=s-2}} → 11 (kg·m)/s−2
|p	Přidá předponu před celý výraz vytvořený šablonou Val. Bez mezer, ale umožňuje použití značek. {{Val|11|22|ul=m/s|p=[Prefix]}} → [Prefix]11±22 m/s {{Val|11|22|ul=m/s|p=[Prefix]&nbsp;}} → [Prefix] 11±22 m/s
|s	Sufix celý Val výraz. Bez mezer, ale umožňuje použití značek. {{Val|11|22|ul=m/s|s=[Suffix]}} → 11±22 m/s[Suffix] {{Val|11|22|ul=m/s|s=&nbsp;[Suffix]}} → 11±22 m/s [Suffix]
|e	Exponent. Val alternativně přijímá e v zápisu čísel v prvním parametru; vylučuje se s ??? (viz „1.“ argument výše). {{Val|11|22|33|e=11}} → 11+22 −33×1011 {{Val|11e11|22|33}} → 11+22 −33×1011 {{Val|e=33}} → 1033
|long scale	Tento parametr nemá v češtině význam, protože tisíc milionů je miliarda a milion milionů je bilion, viz „Krátká a dlouhá škála“.
|nocategory	Pokud se tento parametr použije pro každou hodnotu, chyby v použití této šablony nezpůsobí přidání stránky do Stránky s nesprávným použitím formátovací šablony. To je užitečné pro dokumentační a testovací stránky, které nemají být opravovány.

Chyby

{{Val}} používá striktní kontrolu validity argumentů; každé nesprávné použití způsobí chybu. Stránky, které obsahují nesprávné použití této šablona, budou vloženy do Kategorie:Stránky s nesprávným použitím formátovací šablony.

Val kontroluje, zda nejsou použity nepodporované parametry, a v případě jejich nalezení zobrazí poměrně nenápadné varování. V kategorii „sledování“ můžete sledovat všechna takováto nesprávná použití, která se vyskytují na wiki. Podržte kurzor myši nad slovem „varování“, abyste si zobrazili podrobnosti. Takto vypadají varování:

• {{val|1.23|exp=6|u=m/s}} → 1,23 m/s
• {{val|1.23|us=kbit/s}} → 1,23
• {{val|1.23|.05|.04|.03|u=m/s}} → 1,23+0,05
  −0,04 m/s

Formát čísel

{{Val}} produkuje formátování v souladu s Příručkou stylu Wikipedie.

Příručka stylu doporučuje, aby čísla byla oddělena buď úzkými mezerami po obou stranách desetinné čárky, nebo čárkami vlevo a bez oddělovačů vpravo. Články by měly být jednotné, pokud jde o styl oddělování. Šablona ve výchozím nastavení používá první styl; toto nastavení lze upravit pomocí parametru |fmt= (viz výše).

Třídění

Podrobnější informace naleznete na stránce :en:Help:Sortable tables.

Třídicí klíč pro každou tříditelnou jednotku je viditelný v Šablona:Val/list.

Živý příklad ukazující minimální značkování pro tříditelnou tabulku:

{| class="wikitable sortable floatright" summary="Val sorting test" |+ Click to sort ↓ |- ! Test řazení šablonou Val ! V základních jednotkách ! {{Netučně|1=(nesetříděno)}} |- | {{val|3|ul= Mm }} | style="text-align:right" | {{val|3000000|u=m}} | style="text-align:right; font-size:small;" | {{rand|100|1|67}} |- | {{val|4e6|ul= m }} | style="text-align:right" | {{val|4000000|u=m}} | style="text-align:right; font-size:small;" | {{rand|100|3|67}} |- | {{val|1|ul= km }} | style="text-align:right" | {{val|1000|u=m}} | style="text-align:right; font-size:small;" | {{rand|100|5|67}} |- | {{val|5e3|u= m }} | style="text-align:right" | {{val|5000|u=m}} | style="text-align:right; font-size:small;" | {{rand|100|7|67}} |- | {{val|2|u= m }} | style="text-align:right" | {{val|2|u=m}} | style="text-align:right; font-size:small;" | {{rand|100|11|67}} |} |}

Kliknout setřídit ↓ Test řazení šablonou Val V základních jednotkách (nesetříděno) 3 Mm 3000000 m 49 4×106 m 4000000 m 75 1 km 1000 m 1 5×103 m 5000 m 27 2 m 2 m 79

Výraz zadaný pomocí šablony Val se zpracovává při řazení takto:

1. Vychází se z numerické hodnoty.
2. Pokud má jednotka SI předponu, je použit příslušný násobek nebo díl.
3. Je použita hodnota jednotky z vlastní soustavy jednotek.
4. Pokud je jednotka složená, každá podjednotka je znásobena nebo vydělena jejími rozměry.
5. Výsledek je předán šabloně {{ntsh}}, který použije normalizační vzorec.
6. Výstup {{ntsh}} je skrytě přidán do tabulky pomocí atributu pro třídění tabulky.

Další příklady výrazů

Čísla

{{val|1234567.1234567}} → 1234567,1234567
⟨{{val|  1234567.1234567   }}⟩ → ⟨1234567,1234567⟩
{{val|.1234567|fmt=commas}} → 0,1234567
{{val|+1234567|fmt=commas}} → +1,234,567
{{val|-1234567}} → −1234567

Chyby měření, tolerance

{{val|1.234|0.005}} → 1,234±0,005
{{val|1.234|0.005|e=3}} → (1,234±0,005)×10³
{{val|1.234|+0.005|-0.006}} → 1,234+0,005
−0,006
{{val|1.234|(5)}} → 1,234(5)

Jednotky

{{val|1.234|u=m}} → 1,234 m
{{val|1.234|u=m2}} → 1,234 m²
{{val|1.234|ul=m}} → 1,234 m
{{val|123.4|ul=USgal}} → 123,4 US gal
{{val|12.34|ul=mpgimp}} → 12,34 mpg_-imp

{{val|12.34|u=deg}} → 12,34°
{{val|1.234|0.005|u='}} → 1,234′±0,005′
{{val|1.234|+0.005|-0.006|u="}} → 1,234″+0,005″
−0,006″

{{val|1.234|u=%}} → 1,234%
{{val|1.234|end= [[m/s]]}} → 1,234 m/s

{{val|12.34|u=degC}} → 12,34°C
{{val|12.34|u=K}} → 12,34 K

Exponenty

{{val|e=5}} → 10⁵
{{val|e=5|ul=m}} → 10⁵ m

{{val|1.234e5|ul=m}} → 1,234×10⁵ m
{{val|1.234|e=5|ul=m}} → 1,234×10⁵ m

{{val|1.234e7|0.056}} → (1,234±0,056)×10⁷
{{val|1.234|0.056|e=7}} → (1,234±0,056)×10⁷

{{val|1.23456e-9|+0.00007|-0.00008|ul=m/s}} → 1,23456+0,00007
−0,00008×10⁻⁹ m/s
{{val|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}} → 1,23456+0,00007
−0,00008×10⁻⁹ m/s

{{val|1.234e7|0.056|ul=psi}} → (1,234±0,056)×10⁷ psí
{{val|1.234|0.056|e=7|ul=psi}} → (1,234±0,056)×10⁷ psí

{{val|1.234e-2|(5)}} → 1,234(5)×10⁻²
{{val|1.234|(5)|e=-2}} → 1,234(5)×10⁻²

Předpona/sufix

{{val|12.34|p=Δ }} → Δ 12,34
{{val|12.34|u=%|p=≅}} → ≅12,34%
{{val|12.34|0.25|s=%}} → 12,34±0,25%

Čitatel/jmenovatel

{{val|1.234|e=7|ul=W|up=m2}} → 1,234×10⁷ W/m²

Opakování číslic

{{val|1.2|end={{overline|34}}|e=7|ul=W|up=m2}} → 1,234×10⁷ W/m²

Další příklady

Viz testy v {{val/testcases}}.

FAQ a komentáře

Q. Proč mám používat Val?

A1. Val formátuje čísla:

• vkládá mezery mezi trojice číslic,
• formátuje standardní tolerancí hodnoty, poskytování ± znak, správný odstup, a správný zarovnání,
• formátuje exponenty 10 a vědecký zápis čísel,
• nahrazuje „-“ (pomlčku) znakem „−“ (minus).

A2. Val zajišťuje použití nezlomitelných mezer.

Q. Proč nepoužívá <math>?

A. Ze stejného důvodu proč je některých případech formátování pomocí HTML preferováno před formátováním pomocí TeXu:

• Protože fonty v matematické sazbě jsou jiné než v normálním textu, což může narušit vzhled textu a rozložení stránky.
• Matematické výrazy zformátované pomocí LaTeXu nelze kopírovat jako text.
• Obrázky zabírají více místa a přenášejí se pomaleji než text, což může být problém při zobrazování na mobilních zařízeních.
• <math> nevyhovuje úplně Stylovému manuálu Wikipedie pro zápis čísel.

TemplateData

Tato sekce obsahuje strukturovaný popis parametrů této šablony využívající rozšíření TemplateData, který umožňuje snadnější používání této šablony v prostředí Vizuálního editoru.

Val

Tato šablona slouží pro zobrazení hodnoty s fyzikální jednotkou ve vědecké notaci včetně uvedení případné odchylky (plus-minus), jak je popsáno ve Stylovém manuálu Wikipedie.

Parametry šablony[Upravit strojový popis šablony]

Tato šablona upřednostňuje parametry formátované v jediném řádku.

Parametr		Popis	Typ	Stav
Číslo	1	Číslo s desetinnou tečkou (jak se píše v angličtině) nebo s exponentem za písmenem e. Základ výrazu v šabloně Val. Příklad -12.12345e9	Řetězec	povinný
Odchylka	2	prázdné	Řetězec	nepovinný
Asymetrická odchylka -	3	prázdné	Řetězec	nepovinný
Format	fmt	Implicitně jsou čísla vypisována s mezerami, které oddělují trojice číslic nalevo i napravo od desetinné čárky. Čtyřciferná čísla se s mezerou nevypisují; hodnota "gaps" (bez uvozovek) vynutí použití mezer. Hodnota "commas" (bez uvozovek) způsobí, že trojice číslic vlevo o řádové čárky se budou oddělovat čárkou (což je pro češtinu nepoužitelné, protože se čárky pletou s řádovou čárkou). Hodnota "none" (bez uvozovek) zajistí, že čísla budou vypisována bez mezer i čárek na oddělování trojic číslic. Doporučené hodnoty gaps commas none Příklad commas	Řetězec	nepovinný
End	end	Přidá zadaný řetězec za základní číslo (před vše ostatní, co bude následovat).	Řetězec	nepovinný
Jednotka	u	Kód fyzikální jednotky; pokud jednotka není definována s NOSPACE, vloží se mezi hodnotu a jednotku nezlomitelná mezera. Příklad m	Řetězec	nepovinný
Jednotka s wikiodkazem	ul	Kód jednotky s wikiodkazem na stránku s informací o jednotce. Mezi hodnotou a jednotkou bude nezlomitelná mezera (pokud není NOSPACE). Příklad m	Řetězec	nepovinný
Jednotka, před kterou bude lomítko (/)	up	Kód jednotky, před jejímž výpisem bude místo mezery lomítko pro vytvoření zlomku. Příklad s	Řetězec	nepovinný
Jednotka, před kterou bude lomítko (/) – s wikiodkazem	upl	Kód jednotky s wikiodkazem na stránku s informací o jednotce; před jménem jednotky bude lomítko. Příklad s	Řetězec	nepovinný
Prefix	p	Prefix celého výrazu vytvořeného pomocí šablony Val. Bez meze, ale může obsahovat HTML značky.	Obsah	nepovinný
Suffix	s	Sufix celého výrazu vytvořeného pomocí šablony Val. Bez meze, ale může obsahovat HTML značky.	Obsah	nepovinný
Exponent	e	Val umožňuje zápis hodnoty se znakem e pro exponentem. Příklad 9	Číslo	nepovinný
errend	errend	prázdné	Neznámý	nepovinný
4	4	prázdné	Neznámý	nepovinný
5	5	prázdné	Neznámý	nepovinný

Přesměrování

• Template:Units

Související stránky

• Modul:Val
• Modul:Val/units
• Modul:Convert/data
• Šablona:Převod
• Šablona:Zaokrouhlit

Šablona:Basepage subpage