Модуль:Convert/doc

Модуль конвертирует значение из одних единиц измерения в другие. Например:

• {{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 — этот модуль — код преобразования единиц измерения
• Модуль: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/песочница • различается (diff)
• Module:Convert/data • Module:Convert/data/песочница • не существует
• Module:Convert/text • Module:Convert/text/песочница • различается (diff)
• 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/песочница

Если добавить в Шаблон: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 можно переопределить как угодно. Кроме того, вид и форматы чисел также можно локализовать. Подробнее смотри руководство по переводу.