模板:Val/doc
 | 此页面是Template:Val的模板文档。 此页面可能包含了模板的使用说明、分类和其他内容。 |
 | 本模板不应在引文模板（如引文格式1和引文格式2）中使用，因为本模板所含的标记会破坏引文模板生成的 COinS 元数据，更多信息请见“Wikipedia:COinS”。 |
 | 此模板使用Lua语言： |
用法
[编辑]便于使用科学计数法（包括不确定性）显示数值。
| 参数 | 描述 | 类型 | 状态 | |
|---|---|---|---|---|
| 数值 | 1 | 无描述 | 未知 | 可选 |
| 不确定性（上界） | 2 | 无描述 | 未知 | 可选 |
| 不确定性下界 | 3 | 无描述 | 未知 | 可选 |
| 不加错误提示分类 | nocategory | 无描述 | 未知 | 可选 |
| 指数 | e | 无描述 | 未知 | 可选 |
| 单位 | u ul | 无描述 | 未知 | 可选 |
| 每 | up upl | 无描述 | 未知 | 可选 |
| 值前缀 | p | 无描述 | 未知 | 可选 |
| 主后缀 | end | 无描述 | 未知 | 可选 |
| 不确定性上界后缀 | +errend | 无描述 | 未知 | 可选 |
| 不确定性下界后缀 | -errend | 无描述 | 未知 | 可选 |
| 不确定性后缀 | errend | 无描述 | 未知 | 可选 |
| 值后缀 | s | 无描述 | 未知 | 可选 |
Purpose
[编辑]This template is used to easily present values in scientific notation, including uncertainty and/or units, in accordance with the wikipedia manual of style. It wraps the entire result in a {{nowrap}} block, so that it never gets broken into separate pieces at the end of a line. (See WP:NBSP for more information on the usage of non-breaking spaces.)
Arguments
[编辑]There are four ways this template can be used:
{{val|number}}- for displaying values without uncertainty/significance.{{val|number|uncertainty}}- for displaying values with uncertainty like so 1234±56.{{val|number|upper uncertainty|lower uncertainty}}- for displaying values with uncertainty like so 1234+56
−78.{{val|number|(significance)}}- for displaying values with significance like so 1234(56).
They all take roughly the same arguments
| 1 | The value (must be a valid number) |
| 2 | The (upper limit of) uncertainty (must be a valid number) or significance (must be a valid number in parenthesis) |
| 3 | The lower limit of uncertainty (must be a valid negative number) |
| e | The exponent for the power of 10 (optional). This will show up in the result as " × 10e ".
|
| u / ul | The units for the number (optional, with/without a link to the page about the unit respectively). |
| up / upl | The units per for the units (optional, requires u to be specified, with/without a link to the page about the unit respectively).
|
| p | A prefix for the value (such as ∆, ⌀, etc.; optional). |
| s | A suffix for the value (such as %, optional).
|
| end | Appends something after the main value. For example, {{val|123.24|end=...}} gives 123.24... |
| errend | Appends something after the uncertainty. For example, {{val|123.23|end=...|2.34|errend=...}} gives 123.23...±2.34... |
| +errend & -errend | Appends something after the positive/negative uncertainties. For example, {{val|123.23|end=...|+2.34|+errend=...|-1.23|-errend=...}} gives 123.23...+2.34... −1.23... |
| nocategory | If set to any value, errors in the use of this template will not cause the page to be added to the Pages with incorrect formatting templates use category. This is useful for documentation and test pages that do not need to be fixed. |
See {{val/test}} for a list of examples of the correct output of {{val}} and the errors it may return when incorrectly used.
Errors
[编辑]There is strict checking on the validity of arguments; any incorrect use will result in an error, which is displayed using {{FormattingError}}. Pages that contain incorrect use of this template will show up on Category:Pages with incorrect formatting templates use.
Format convention
[编辑]As mentioned before, {{val}} should produce formatting compliant with the wikipedia manual of style. It currently produces formatting compliant with the U.S. Government Printing Office Style Manual, in rules 12.9e and 12.14, which requires that the decimal separator be a full stop; i.e. “decimal point” (.), requires comma-delimiting to the left of the decimal point for numbers with four or more digits to the left (values of 1000 or more), and also requires space-delimiting to the right of the decimal point for numbers containing five or more digits to the right (e.g., 0.12345 and 5.12345 and 125.12345).
Note that if {{val}} is used on numbers simultaneously comprising four or more digits to the left of the decimal point and five or more digits to the right, the resultant expression will delimited with commas left and spaces (actually non-selectable, non-breaking, narrow gaps) right (see below).
Examples
[编辑]{{val|1234567890}}→ 1234567890 {{val|1.23456789}}→ 1.23456789 {{val|21563.252564425}}→ 21563.252564425 [1] Uncertainty/significance {{val|1.234|0.005}}→ 1.234±0.005 {{val|1.234|+0.005|-0.006}}→ 1.234+0.005
−0.006{{val|1.234|(5)}}→ 1.234(5) Exponents/units {{val|1.234|e=5|u=m}}→ 1.234×105 米 {{val|1.234|e=5|u=m2}}→ 1.234×105 m2 {{val|1.234|e=5|ul=m}}→ 1.234×105 米 {{val|1.234|0.056|e=7}}→ (1.234±0.056)×107 {{val|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}}→ 1.23456+0.00007
−0.00008×10−9 m/s{{val|1.234|0.056|e=7|ul=psi}}→ (1.234±0.056)×107 psi {{val|123.4|ul=USgal}}→ 123.4 US gal {{val|12.34|ul=mpgimp}}→ 12.34 mi/imp gal Prefix/suffix {{val|p=Δ |12.34|s=%}}→ Δ 12.34%
参见
[编辑]- {{Valid|有效}}：数字有效性检查（对于参数1、2、3，e值和不确定性，以10为底的指数）
- {{FormattingError}} : 格式错误：用于报告不一致的参数
- {{Su}}：用于格式化指数，或者一个或多个二值不确定度的格式（等宽：当前无法打印为PDF）