Шаблон:Val/doc: различия между версиями

Материал из Space Station 14 Вики
Интерактивная навигация по истории
ВизуальныйВики-текст
Новая страница: «{{docpage}} Шаблон '''{{t|val}}''' (от {{lang-en|value}} — значение) предназначен для облегчения записи значений физических величин с возможностью указания погрешностей измерения (о разных формах записи погрешности см. статью ВП:Погрешность измерения) и ВП:Единицы из...»
 
мНет описания правки
 
Строка 24: Строка 24:
|-
|-
| {{nobr|<code>u</code> <small>(от {{lang-en2|unit}})</small>}}
| {{nobr|<code>u</code> <small>(от {{lang-en2|unit}})</small>}}
| [[Единицы измерения|Единица измерения]] указываемой величины.
| [[ВП:Единицы измерения|Единица измерения]] указываемой величины.
|}
|}


Для упрощения вики-кода вместо параметра <code>v</code> можно пользоваться первым неименованным параметром, вместо <code>pm</code> — вторым, вместо пары <code>p</code>+<code>m</code> — вторым+третьим. При указании неименованных параметров соответствующие им именованные параметры игнорируются. Подробнее см. в разделе «Примеры использования» ниже.
Для упрощения вики-кода вместо параметра <code>v</code> можно пользоваться первым неименованным параметром, вместо <code>pm</code> — вторым, вместо пары <code>p</code>+<code>m</code> — вторым+третьим. При указании неименованных параметров соответствующие им именованные параметры игнорируются. Подробнее см. в разделе «Примеры использования» ниже.


{{начало скрытого блока |Рамка= |Фон_заголовка= |Заголовок=Описание параметров шаблона для [[Википедия:Визуальный редактор|Визуального редактора]]}}
{{начало скрытого блока |Рамка= |Фон_заголовка= |Заголовок=Описание параметров шаблона для [[ВП:Википедия:Визуальный редактор|Визуального редактора]]}}
  <templatedata>
  <templatedata>
  { "description": "Шаблон {{val}} (от англ. value — «значение») предназначен для облегчения записи значений физических величин с возможностью указания погрешностей измерения и единиц измерения",
  { "description": "Шаблон {{val}} (от англ. value — «значение») предназначен для облегчения записи значений физических величин с возможностью указания погрешностей измерения и единиц измерения",
Строка 102: Строка 102:
|-
|-
! 1
! 1
| Значение величины (в [[Экспоненциальная запись|экспоненциальной записи]]) с указанием погрешности, а также единицы измерения:
| Значение величины (в [[ВП:Экспоненциальная запись|экспоненциальной записи]]) с указанием погрешности, а также единицы измерения:
: {{nobrc|<nowiki>{{val|v=1.234|pm=0.002|e=6|u=[[Километр|км]]}}</nowiki>}}
: {{nobrc|<nowiki>{{val|v=1.234|pm=0.002|e=6|u=[[ВП:Километр|км]]}}</nowiki>}}
| {{val|v=1.234|pm=0.002|e=6|u=[[Километр|км]]}}
| {{val|v=1.234|pm=0.002|e=6|u=[[ВП:Километр|км]]}}
|-
|-
! 2
! 2
| То же, что в примере{{nbsp|1}}1, но с указанием различной погрешности «в{{nbsp|1}}плюс» и «в{{nbsp|1}}минус»:
| То же, что в примере{{nbsp|1}}1, но с указанием различной погрешности «в{{nbsp|1}}плюс» и «в{{nbsp|1}}минус»:
: {{nobrc|<nowiki>{{val|v=1.234|p=0.002|m=0.003|e=6|u=[[Километр|км]]}}</nowiki>}}
: {{nobrc|<nowiki>{{val|v=1.234|p=0.002|m=0.003|e=6|u=[[ВП:Километр|км]]}}</nowiki>}}
| {{val|v=1.234|p=0.002|m=0.003|e=6|u=[[Километр|км]]}}
| {{val|v=1.234|p=0.002|m=0.003|e=6|u=[[ВП:Километр|км]]}}
|-
|-
! 3
! 3
| То же, что в примере{{nbsp|1}}1, но с указанием погрешности «в{{nbsp|1}}скобках» (удобно, когда значение величины известно с высокой точностью):
| То же, что в примере{{nbsp|1}}1, но с указанием погрешности «в{{nbsp|1}}скобках» (удобно, когда значение величины известно с высокой точностью):
: {{nobrc|<nowiki>{{val|v=1.2345678|d=14|e=6|u=[[Километр|км]]}}</nowiki>}}
: {{nobrc|<nowiki>{{val|v=1.2345678|d=14|e=6|u=[[ВП:Километр|км]]}}</nowiki>}}
| {{val|v=1.2345678|d=14|e=6|u=[[Километр|км]]}}
| {{val|v=1.2345678|d=14|e=6|u=[[ВП:Километр|км]]}}
|-
|-
! 4
! 4
| То же, что в примере{{nbsp|1}}1, но не в экспоненциальной, а в обычной записи:
| То же, что в примере{{nbsp|1}}1, но не в экспоненциальной, а в обычной записи:
: {{nobrc|<nowiki>{{val|v=123450000|pm=10000|u=[[Километр|км]]}}</nowiki>}}
: {{nobrc|<nowiki>{{val|v=123450000|pm=10000|u=[[ВП:Километр|км]]}}</nowiki>}}
| {{val|v=123450000|pm=10000|u=[[Километр|км]]}}
| {{val|v=123450000|pm=10000|u=[[ВП:Километр|км]]}}
|-
|-
! 5
! 5
| C использованием неименованных параметров:
| C использованием неименованных параметров:
: {{nobrc|<nowiki>{{val|12345|6|u=[[Километр|км]]}}</nowiki>}}
: {{nobrc|<nowiki>{{val|12345|6|u=[[ВП:Километр|км]]}}</nowiki>}}
: {{nobrc|<nowiki>{{val|12345|7|9|u=[[Километр|км]]}}</nowiki>}}
: {{nobrc|<nowiki>{{val|12345|7|9|u=[[ВП:Километр|км]]}}</nowiki>}}
| {{val|12345|6|u=[[Километр|км]]}}<br />{{val|12345|7|9|u=[[Километр|км]]}}
| {{val|12345|6|u=[[ВП:Километр|км]]}}<br />{{val|12345|7|9|u=[[ВП:Километр|км]]}}
|}
|}


Строка 136: Строка 136:
: {{nobrc|<nowiki>{{val|12345}}</nowiki>}}
: {{nobrc|<nowiki>{{val|12345}}</nowiki>}}
| {{val|12345}}
| {{val|12345}}
| [[Википедия:Функции парсера|Функция парсера]] {{mwmw|formatnum|}} или шаблон {{tl|число}} (он же {{tl|num}})
| [[ВП:Википедия:Функции парсера|Функция парсера]] {{mwmw|formatnum|}} или шаблон {{tl|число}} (он же {{tl|num}})
: {{nobrc|<nowiki>{{formatnum: 12345}}</nowiki>}}{{nbsp|1}}→ {{formatnum: 12345}}
: {{nobrc|<nowiki>{{formatnum: 12345}}</nowiki>}}{{nbsp|1}}→ {{formatnum: 12345}}
: {{nobrc|<nowiki>{{num|12345}}</nowiki>}}{{nbsp|1}}→ {{num|12345}}
: {{nobrc|<nowiki>{{num|12345}}</nowiki>}}{{nbsp|1}}→ {{num|12345}}

Текущая версия от 23:04, 28 июня 2025

Шаблон {{val}} (от англ.  value — значение) предназначен для облегчения записи значений физических величин с возможностью указания погрешностей измерения (о разных формах записи погрешности см. статью ВП:Погрешность измерения) и единиц измерения. Шаблон запрещает ВП:перевод строки от начала и до конца выводимого шаблоном текста. Все численные значения, кроме указываемых в параметрах d и e (см. ниже), обрабатываются функцией парсера {{formatnum:}}.

Использование

Шаблон имеет следующие параметры (все — необязательные):

Параметр Описание
v (от value) Числовое значение величины или (при использовании параметра e) мантисса этого значения в экспоненциальной записи.
Замечание: если значение записывается с использованием десятичной дроби, следует обязательно использовать десятичную точку, а не запятую, так как оно обрабатывается функцией парсера {{formatnum:}}.
pm (от plus-minus) Значение погрешности измерения («плюс-минус»). Замечание выше (о десятичной точке) относится и к этому параметру.
p и m Раздельные значения погрешности измерения «в плюс» и «в минус»; выводятся как верхний и нижний индексы (со знаками «+» и «−», соответственно) после числового значения величины. Если задан параметр pm, то эти параметры игнорируются. При указании параметра p необходимо также указать и m, и наоборот. Замечание выше (о десятичной точке) относится и к этим параметрам.
d (от ??) Погрешность в форме записи, удобной для величин, известных с большой точностью; записывается как число в скобках после числового значения величины.
e (от exponent) Порядок для экспоненциальной записи значения величины.
u (от unit) Единица измерения указываемой величины.

Для упрощения вики-кода вместо параметра v можно пользоваться первым неименованным параметром, вместо pm — вторым, вместо пары p+m — вторым+третьим. При указании неименованных параметров соответствующие им именованные параметры игнорируются. Подробнее см. в разделе «Примеры использования» ниже.

Описание параметров шаблона для Визуального редактора

Шаблон {{val}} (от англ. value — «значение») предназначен для облегчения записи значений физических величин с возможностью указания погрешностей измерения и единиц измерения

Параметры шаблона

ПараметрОписаниеТипСтатус
Значение1

Числовое значение величины или (при использовании параметра «e») мантисса этого значения в экспоненциальной записи.

Числонеобязательный
Погрешность (± или +)2

Общее значение погрешности («плюс-минус») или погрешность «в плюс» (верхний индекс); в последнем случае обязательно задать и параметр 3.

Числонеобязательный
Погрешность (−)3

Погрешность «в минус» (нижний индекс); если этот параметр задан, то обязательно должен быть задан и параметр 2.

Числонеобязательный
Значениеv

Числовое значение величины или (при использовании параметра «e») мантисса этого значения в экспоненциальной записи; можно использовать вместо неименованного параметра 1.

Числонеобязательный
Погрешность (±)pm

Общее значение погрешности («плюс-минус»); можно использовать вместо неименованного параметра 2.

Числонеобязательный
Погрешность (+)p

Погрешность «в плюс»; можно использовать вместо неименованного параметра 2. Если задан параметр «pm», то параметры «p» и «m» игнорируются. Если параметр «p» задан, то обязательно должен быть задан и параметр «m».

Числонеобязательный
Погрешность (−)m

Погрешность «в минус»; можно использовать вместо неименованного параметра 3. Если параметр «m» задан, то обязательно должен быть задан и параметр «p».

Числонеобязательный
Погрешность (в скобках)d

Погрешность в форме записи, удобной для величин, известных с большой точностью; записывается как число в скобках после значения.

Числонеобязательный
Порядок величины (10^N)e

Порядок для экспоненциальной записи значения величины.

Числонеобязательный
Единица измеренияu

Единица измерения указываемой величины.

Строковый (без форматирования)необязательный

Примеры использования

Примеры случаев, в которых оправдано использование данного шаблона:

Код Результат
1 Значение величины (в экспоненциальной записи) с указанием погрешности, а также единицы измерения:
{{val|v=1.234|pm=0.002|e=6|u=[[ВП:Километр|км]]}}
 (1,234 ± 0,002)⋅106 км
2 То же, что в примере 1, но с указанием различной погрешности «в плюс» и «в минус»:
{{val|v=1.234|p=0.002|m=0.003|e=6|u=[[ВП:Километр|км]]}}
 (1,234+0,002
−0,003)⋅106 км
3 То же, что в примере 1, но с указанием погрешности «в скобках» (удобно, когда значение величины известно с высокой точностью):
{{val|v=1.2345678|d=14|e=6|u=[[ВП:Километр|км]]}}
 1,2345678(14)⋅106 км
4 То же, что в примере 1, но не в экспоненциальной, а в обычной записи:
{{val|v=123450000|pm=10000|u=[[ВП:Километр|км]]}}
 123 450 000 ± 10 000 км
5 C использованием неименованных параметров:
{{val|12345|6|u=[[ВП:Километр|км]]}}
{{val|12345|7|9|u=[[ВП:Километр|км]]}}
 12 345 ± 6 км
12 345+7
−9 км

Примеры простых случаев; этот шаблон поддерживает и их, хотя его использование может быть неоправданным, и лучше использовать вместо него более простые шаблоны:

Код Результат Альтернатива
1 Просто число:
{{val|12345}}
 12 345 Функция парсера {{formatnum:}} или шаблон {{число}} (он же {{num}})
{{formatnum: 12345}} → 12 345
{{num|12345}} → 12 345
2 Число с единицей измерения:
{{val|12345|u=м/с}}
 12 345 м/с Шаблон {{число}} (он же {{num}})
{{num|12345|м/с}} → 12 345 м/с
3 Число (четырёх- или менее значное) с указанием разброса и без указания единицы измерения:
{{val|123|7|13}}
 123+7
−13 		Шаблон {{sup sub}} или {{su}}
123{{sup sub|+7|−13}} → 123+7
−13
123{{su|p=+7|b=−13}} → 123+7
−13

См. также

  • Шаблон {{число}} (и записываемое латиницей перенаправление на него {{num}}) — более простой шаблон, реализующий часть функциональности данного шаблона.


Источник — https://station14.ru/index.php?title=Шаблон:Val/doc&oldid=102444