Модуль:Convert/doc
Это страница документации Модуль:Convert.
Модуль конвертирует значение из одних единиц измерения в другие. Например:
{{convert/sandbox|123|lb|kg}}
→ 123 фунтов (56 кг){{convert/sandbox|6|ft|4|in|adj=on}}
→ 6-фут-4-дюйм (1,93 м)
Передаваемые при вызове модуля параметры определяют что и куда будет сконвертировано. Например, единицы измерения могут быть указаны сокращённо (как kg
), или полностью (как kilogram
), а значение округлено по указанной точности. Подробнее см en:Help:Convert.
Модуль используется в шаблоне:
Следующие модули обязательны:
- Модуль:Convert — этот модуль — код преобразования единиц измерения
- Модуль:Convert/data — описание единиц измерения
- Модуль:Convert/text — текстовые сообщения, имена параметров и их значения
Следующие модули необязательны и используются только если существуют:
- Модуль:Convert/extra — добавочное (временно) описание единиц измерения; используется если единица измерения не найдена в модуле Модуль:Convert/data
- Модуль:ConvertNumeric — код описывающий численный результат словами (только по английски)
Следующие справочные страницы содержат :
- en:Help:Convert — описание пресчета единиц измерения
- en:Help:Convert messages — описание ошибок и предупреждений; сообщения ссылаются на эту страницу, поэтому её нужно создать при переносе в другие тептар разделы
- en:Help:Convert units — описание единиц измерения
Страницы с ошибками конвертации добавляются в отслеживающую категорию Категория:Convert invalid units
Следующие страницы используются для генерации списка единиц измерения из тептар-текста:
- Модуль:Convert/documentation/conversion data/doc — главный список единиц измерения
- Модуль:Convert/makeunits — модуль транслирующий главный список единиц измерения в Lua
- Обсуждение модуля:Convert/makeunits — результат трансляции; скопируйте текст в Модуль:Convert/data
Модуль:Convert/data подключается на всех страницах использующих конвертацию, поэтому экспериментирование с новой единицей измерения в этом модуле потребует значительных накладных расходов, в отличии от Модуль:Convert/extra, который подключается только в том случае, если единица измерения не найден в главном модуле.
Песочница[править код]
Чтобы внести изменения, скопируйте текущие модули на страницы песочницы, и редактируйте их копии:
- Module:Convert • Module:Convert/песочница • не существует
- Module:Convert/data • Module:Convert/data/песочница • не существует
- Module:Convert/text • Module:Convert/text/песочница • не существует
- Module:Convert/extra • Module:Convert/extra/песочница • не существует
- Module:Convert/wikidata • Module:Convert/wikidata/песочница • не существует
- Module:Convert/wikidata/data • Module:Convert/wikidata/data/песочница • не существует
Используйте указанный ниже шаблон для проверки результатов (Например {{convert/песочница|123|lb|kg}}
):
Если добавить в Шаблон:Convert/песочница параметр |sandbox=песочница
, это заставит Модуль:Convert/песочница использовать модули data, text и extra из песочницы взамен обычных.
Указанные ниже страницы используются для проверки модуля convert:
- Модуль:Convert/tester — модуль выполняющий тесты и сравнивающий результат конвертирования с указанным текстовым значением.
- Шаблон:Convert/песочница/тесты — модули теста и ожидаемые результаты (используемые модулем tester)
- Шаблон:Convert/тесты — страница результатов тестов
Не обязательно сохранять страницу содержащую тесты, чтобы посмотреть результат их исполнения. Например, редактируя Шаблон:Convert/песочница/тесты вы можете вставить "Шаблон:Convert/тесты
" (без кавычек) в поле «Название страницы» для «Предварительного просмотра страницы с использованием этого шаблона или модуля» и нажать «Предварительный просмотр».
Конфигурация[править код]
Шаблоны вызывающие этот модуль могут изменять его конфигурацию с помощью опции. Например:
{{#invoke:convert|convert|numdot=,|numsep=.}}
- Устанавливает в качестве десятичного разделителя запятую, а разделителя разрядов — точку.
Другие опции по умолчанию:
|maxsigfig=14
— максимальное количество значащих цифр|nscat=0
— пространства имён (через запятую), в которых страницы с ошибками и предупреждения будут добавляться в отслеживающую категорию.|warnings=0
— 0 (ноль) скрывает предупреждения; 1 показывает важные предупреждения; 2 показывает все предупреждения
Дополнительно можно указать какая версия песочницы будет использоваться. В параметре sandbox указывается заголовок подстраницы для всех песочница модулей.
|sandbox=песочница
— не указывайте для нормальной работы
Все текстовые значения, используемые в качестве входных параметров, а также выходные сообщения и категории можно переопределить. Например, в английском разделе опция |lk=on
используется для связи каждой единицы измерения с описывающий её статьей. И название параметра lk
и его значение on
можно переопределить как угодно. Кроме того, вид и форматы чисел также можно локализовать. Подробнее смотри руководство по переводу.