Шаблон: Val

Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Этот шаблон используется примерно на 25 000 страницах, и изменения могут быть широко заметны. Протестируйте изменения на подстраницах / sandbox или / testcases шаблона или на подстраницах вашего собственного пользователя . Обсудите изменения на странице обсуждения, прежде чем внедрять их. Счетчик включений обновляется автоматически ( см. Документацию ).

Этот шаблон не следует использовать в шаблонах цитирования, таких как Citation Style 1 и Citation Style 2 , поскольку он включает разметку, которая загрязняет создаваемые ими метаданные COinS ; см. Википедию: МОНЕТЫ .

Этот шаблон использует Lua : Модуль: Val ( песочница )

Этот шаблон используется для простого представления значений в научном представлении , включая неопределенность и / или единицы, как предписано Руководством по стилю Википедии .

Вступление

Val специализируется на числовых значениях , особенно с научными обозначениями , обозначениями неопределенности и значениями измерений с физическими единицами. Поскольку эти выражения охватываются Руководством по стилю, Val предоставляет вам стилизованный вывод и предотвращает их перенос по строкам.

Выразите цифру:

• {{val|123456.78901}}→ значение , отформатированное с пробелами:123 456 .789 01 , или с помощью |fmt=commas→123 456,78901
• {{val|number|number}}→ значение ± неопределенность , например123 478 ± 56
• {{val|number|(number)}}→ значение ( неопределенность ), например12 345 (56)
• {{val|number|number|number}}→ значение ^{+ неопределенность}
  _-uncertainty подобно 1 234+56
  −78

Выразите значение измерения: {{val|4|ul=m2}}→4  м ² . Это m2«код объекта», который Вэл использует для поиска ссылки на статью объекта и форматирования символа объекта. Val связывает единицы со страницей, которую он имеет для них. См. {{ Val / list }}.

Существует большое количество кодов единиц, которые Вэл понимает и поддерживает «в соответствии с кодом». Код единицы измерения - это просто сокращенное название единицы, но они могут быть весьма задействованы для составной или составной единицы с «множителями» или «делителями». См. Модуль: Val / units .

Некоторая гибкость единичного кода обеспечивается наличием четырех параметров для работы системы единичных кодов: связывать один или нет (см. Пересвязка ), и нужно ли отдельно связывать числитель или знаменатель отношения единиц.

• {{val|number|ul=unit code}}→ числовой символ , например9.8  км ²
• {{val|number|u=unit code}}→ числовой символ , например9.8 км ²
• {{val|number|u=unit code|upl=unit code}}→ цифровой  символ / символ , например9,8 гал / мин
• {{val|number|ul=unit code|up=unit code}}→ цифровой  символ / символ , например9,8  шт / год

Чтобы обойти систему кодов модулей, если |u=они не распознают код вашего устройства, он примет любой викитекст и отобразит его как обычно.

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

См. Модуль: Val / units для получения информации о том, как добавить единицы в систему кодов единиц.

Иногда числа и кода единицы измерения недостаточно. Также доступны префикс или суффикс, |p=и |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 С}

См. {{ Val / testcases }}, чтобы изучить параметры val на примере. Он всеобъемлющий и насчитывает более 100 примеров.

Аргументы

Val принимает три безымянных параметра. Первое всегда числовое значение. Когда второе и третье числа - это числа, они становятся различными обозначениями неопределенности, но второй безымянный параметр также может служить для грамматического соединения первого и третьего чисел.

Val очищает окружающие пространства в своих безымянных параметрах.

Ошибки

Существует строгая проверка обоснованности аргументов; любое неправильное использование приведет к ошибке, которая отображается с помощью {{ FormattingError }}. Страницы, которые содержат неправильное использование этого шаблона, будут отображаться в Категория: Страницы с неправильным использованием шаблонов форматирования .

Val проверяет наличие неподдерживаемых параметров и при обнаружении выдает относительно тонкое предупреждение. См. Категорию отслеживания, чтобы отслеживать любое из этих неправомерных действий, существующих на вики. Чтобы увидеть подробности, наведите курсор мыши на «предупреждение». Вот как выглядят предупреждения:

• {{val|1.23|exp=6|u=m/s}} → 1,23 м / сОшибка в {{ val }}: параметр Val "exp = 6" не поддерживается
• {{val|1.23|us=kbit/s}} → 1,23Ошибка в {{ val }}: параметр Val "us = kbit / s" не поддерживается
• {{val|1.23|.05|.04|.03|u=m/s}} → 1,23+0,05
  -0,04 РСОшибка в {{ val }}: параметр Val 4 проигнорирован

Формат чисел

{{ Val }} производит форматирование в соответствии с Руководством по стилю Википедии .

МОП рекомендует числа либо быть разделена с помощью тонких пробелов обе стороны от десятичного или запятые влево и никаких разделителей вправо. Статьи должны соответствовать стилю разграничения. По умолчанию в шаблоне используется прежний стиль, это можно изменить с помощью |fmt=(см. Выше ).

Сортировка

Ключ сортировки для каждой сортируемой единицы отображается в Template: Val / list .

Вот живой пример, показывающий минимальную разметку для сортируемой таблицы:

{| class = "сортируемый"! Val sort test! В базовом блоке| -| {{val | 3 | ul = Mm}}| {{val | 3000000 | u = m}}| -| {{val | 4e6 | ul = m}}| {{val | 4000000 | u = m}}| -| {{val | 1 | ul = km}}| {{val | 1000 | u = m}}| -| {{val | 5e3 | u = m}}| {{val | 5000 | u = m}}| -| {{val | 2 | u = m}}| {{val | 2 | u = m}}|}

Значение сортировки относится к выражению Val следующим образом.

1. Числовое значение является отправной точкой.
2. Если у единицы есть префикс SI, применяется этот порядок величины.
3. Применяется стоимость единицы из собственной системы единиц .
4. Если единица составная, каждая единица умножается или делится по их размеру .
5. Результат передается в {{ ntsh }}, который применяет формулу нормализации.
6. Выходные данные {{ntsh}} добавляются (только поведенчески, т.е. «скрыты») в таблицу, как обычно, через атрибут data-sort-value таблицы.

Еще примеры выражений

Число

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

Неопределенность

{{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)

Единицы

{{val|1.234|u=m}} → 1.234 м
{{val|1.234|u=m2}} →1,234 м ²
{{val|1.234|ul=m}} →1.234  м
{{val|123.4|ul=USgal}} →123,4  галлона США
{{val|12.34|ul=mpgimp}} →12,34  миль на галлон _{- чертенок}

{{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  м / с

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

Экспоненты

{{val|e=5}} → 10 ⁵
{{val|e=5|ul=m}} →10 ⁵  месяцев

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

{{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,234 56+0,000 07
−0,000 08× 10 ⁻⁹  м / с
{{val|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}} →1,234 56+0,000 07
−0,000 08× 10 ⁻⁹  м / с

{{val|1.234e7|0.056|ul=psi}} → (1,234 ± 0,056) × 10 ⁷  фунтов на кв. Дюйм
{{val|1.234|0.056|e=7|ul=psi}} →(1,234 ± 0,056) × 10 ⁷  фунтов на кв. Дюйм

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

Префикс Суффикс

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

Числитель / знаменатель

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

Повторяющиеся цифры

{{val|1.2|end={{overline|34}}|e=7|ul=W|up=m2}} → 1,2 34 × 10 ⁷  Вт / м ²

Еще больше примеров

См. Тестовые примеры на странице {{ val / testcases }}.

FAQ и комментарии

В. Почему я должен использовать Val?

А1. Val форматирует числа:

• вставляет пробелы между группами цифр в соответствии со стандартами MoS ,
• форматирует стандартные погрешности измерений , обеспечивая символ ±, правильный интервал и правильное выравнивание,
• форматирует показатель степени 10 и экспоненциальную запись ,
• заменяет «-» (дефис) на «-» (знак минус).

A2. Val сохраняет интервал:

• Он следит за тем, чтобы значение не переносилось в конец строки, чтобы его всегда можно было прочитать как одно значение в одной строке текста.
• Он разделяет различные части значения там, где они должны быть.

A3. Настройка Val дает вам собственный код для автоматизации разметки и ссылки на любые единицы во всей Энциклопедии.

A4. Val помогает сделать Википедию более последовательной. Он придерживается Руководства по стилю для чисел из Википедии . Обновления MoS могут быть применены к этому шаблону и привести к автоматическому изменению значений, которые его используют. Все это гарантирует, что все значения на всех страницах будут иметь одинаковый внешний вид, потому что все они будут использовать одинаковые интервалы , размер шрифта , позиционирование и т. Д., А также упрощает обновление и проверку ботами, поскольку они могут распознать значение для того, что это такое. .

В. Почему бы не использовать <math>?

A. По тем же причинам HTML может быть предпочтительнее TeX :

• Потому что шрифт в математических тегах отличается как по начертанию, так и по размеру от прозы, что может нарушить макет страницы при использовании в тексте.
• Вы не можете вырезать и вставлять растровое изображение, созданное LaTeX.
• Изображения загружаются медленнее и используют большую пропускную способность, что особенно плохо для мобильной версии Википедии.
• <math> нелегко автоматически согласовать с Руководством по стилю для чисел.

В. Есть ли какие-нибудь известные проблемы с Val?

A1: Этот шаблон теперь является новым модулем Lua по состоянию на 6 августа 2015 года. Технически нет веских причин не пробовать Val.

A2. Проблемы решаются быстро с помощью активного набора адаптивных кодировщиков шаблонов. См. Страницу обсуждения.

В. Как мне использовать Val?

А1. Ваш отряд, вероятно, уже есть в текущем списке Вэл . Если нет, добавьте туда свой собственный блок.

A2. Чтобы избежать наложения ссылок , переключайтесь с |ul=на |u=и с |upl=на |up=.

A3. Каждый раз, когда у вас есть объект, который нужно связать, или таблица для сортировки, Val уже настроен со ссылкой на этот объект и значением сортировки.

A3. Используйте Val вместе с {{ Convert }}. Посмотрите, как добавить единицы в Convert .

A4. Там, где требуется согласованный стиль статей с длинными списками, состоящими из многих сотен или тысяч чисел или единиц.

Смотрите также

• Модуль: Val
• Модуль: Val / единицы
• Модуль: Convert / data
• Шаблон: Пробелы
• Шаблон: Круглый
• Шаблон: Scinote для отображения значения в научном представлении
• Шаблон: 10 ^ для отображения степени десяти

TemplateData