Цей модуль позначений як К:реліз, готовий до загального вжитку (138). Він досягнув стадії готовності й вважається, що вільний від помилок і може використовуватись всюди, де знадобиться. Його можна вживати на допоміжних сторінках та інших сторінках Вікіпедії як можливість для навчання новачків. Аби зменшити навантаження на сервери та некоректний показ сторінок, його можна вдосконалювати в рамцях чернеткового тестування[en], а не з застосуванням спроб і помилок.
Цей модуль призначений для тимчасового швидкого додавання нових одиниць вимірювання у модуль {{Convert}}. Коли нові одиниці запрацюють правильно, їх слід перенести до постійного списку одиниць вимірювання. Для цього призначено Обговорення модуля:Convert/data, куди слід написати прохання про перенесення.
Нижче наведено приклади визначення нових одиниць вимірювання, взяті з Модуль:Convert/data. Кількість прогалин (там, де вони проставлені) можна змінювати для наочності.
Приклади для додавання до модуля Модуль:Convert/extra(Для справжнього коду модуля, див. нижче)
-- These are EXAMPLES on the documentation page. Scroll down to see the module content.localextra_units={-- Similar to a redirect: "sqm" is an alias for "m2".-- {{convert|1.5|m2|sp=us}} → 1.5 square meters (16 sq ft)-- {{convert|1.5|sqm|sp=us}} → 1.5 square meters (16 sq ft)["sqm"]={target="m2",},-- A simple unit, showing the minimum that is required.-- The "ha" is the unit code used to identify the unit:-- {{convert|1.5|ha}} → 1.5 hectares (3.7 acres)["ha"]={name1="hectare",symbol="ha",utype="area",scale=10000,default="acre",},-- A unit which accepts an SI prefix. There is no "name1" field because it-- has to be constructed (mJ gives "millijoule"; MJ gives "megajoule").-- {{convert|125|kJ}} → 125 kilojoules (30,000 cal)["J"]={_name1="joule",_symbol="J",utype="energy",scale=1,prefixes=1,default="cal",link="Joule",},-- A unit where US and plural names are required.-- {{convert|125|cm/s2}} → 125 centimetres per second squared (4.1 ft/s²)["cm/s2"]={name1="centimetre per second squared",name1_us="centimeter per second squared",name2="centimetres per second squared",name2_us="centimeters per second squared",symbol="cm/s<sup>2</sup>",utype="acceleration",scale=0.01,default="ft/s2",link="Gal (unit)",},-- A "per" unit is defined as the ratio of two other units.-- {{convert|125|g/cm3}} → 125 grams per cubic centimetre (4.5 lb/cu in)["g/cm3"]={per={"g","cm3"},utype="density",default="lb/cuin",},-- If the automatic "per" link is not wanted, a link can be specified.-- {{convert|125|g/cm3|lk=on|disp=unit}} → [[gram]]s per [[cubic centimetre]]-- {{convert|125|g/m3|lk=on|disp=unit}} → [[density|grams per cubic metre]]["g/m3"]={per={"g","m3"},utype="density",default="lb/cuyd",link="density",},-- Characters "$" and "£" are recognized as currency symbols.-- {{convert|125|$/acre}} → $125 per acre ($310/ha)["$/acre"]={per={"$","acre"},utype="cost $ per unit area",default="$/ha",},-- An output unit can be defined as a combination of existing units.-- {{convert|2|ha|ft2 m2}} → 2 hectares (220,000 sq ft; 20,000 m²)-- Any number of output units can be specified.-- NOTE: There may be no need to define a combination because a convert-- can specify the output by joining unit codes with "+":-- {{convert|1.2|acre|ft2+yd2+m2}} → 1.2 acres (52,000 sq ft; 5,800 sq yd; 4,900 m²)["ft2 m2"]={combination={"ft2","m2"},utype="area",},-- An output unit can be defined using subunits (from least to most significant).-- {{convert|90|in|ydftin}} → 90 inches (2 yd 1 ft 6 in)["ydftin"]={combination={"in","ft","yd"},multiple={12,3},utype="length",},}
Поле
Опис
symbol
Ідентифікатор одиниці вимірювання. Застосовується, коли задано скорочені позначення (abbr=on).
name1
Повна назва одиниці в однині. Застосовується, коли скорочення вимкнено (abbr=off).
name2
Повна назва одиниці в множині. Не обов'язково, якщо множина утворюється додаванням закінчення "s" до назви в однині (name1); так зазвичай в англійській. В українському модулі утворення множини через "s" вимкнено. Для української мови цей параметр не має сенсу, тому варто використовувати varname, що формує множину. Детальніше, див. рядок varname, що нижче.
name1_us
Американська назва одиниці (в однині). Для української локалізації взагалі не має сенсу. В оригіналі застосовується для позначень на американському діалекті англійської (коли задано параметр sp=us ); не обов'язково, якщо не відрізняється від name1;
name2_us
Американська назва одиниці в множині. Як і попередній параметр, призначено виключно для американського діалекту (sp=us) та не має сенсу в українській локалізації.
pername
Назва для одиниць після прийменника «на», використовується, якщо одиниця після «на» має відмінок, що відрізняється від називного в однині. Наприклад, «миля» має форму «милю» після «на».
varname
Змінювальна назва одиниці в множині, використовується лише в локалізаціях, наприклад в українській. Назви одиниць задаються у форматі «метри!метрів!метра», де перша значення — одиниця в називному відмінку множині (для чисел, що закінчуються на 2-4, окрім 12-14), друге значення — одиниця в родовому відмінку множині (для чисел вище 4), третє значення — одиниця в родовому відмінку однини (для звичайних і десяткових дробів).
utype
Тип вимірюваної величини (маса, довжина, площа тощо); має бути таким же, як у базової одиниці.
scale
Кількість базових одиниць в одиниці, яка визначається.
default
Код одиниці, в яку відбуватиметься перетворення за замовчуванням (якщо не задано, в яку одиницю перетворювати).
target
Код уже визначеної одиниці, на яку нове визначення перенаправлятиметься.
для одиниць довжини буде 1 (у кілометрі 10001 метрів);
для одиниць площі — 2 (у квадратному кілометрі 10002 =1000 000 квадратних метрів);
для одиниць об'єму — 3 (у кубічному кілометрі 10003 кубічних метрів).
link
Назва вікіпедійної статті, на яку буде посилання (коли ввімкнено формування посилань; lk=on чи lk=in або lk=out); не обов'язкове, якщо назва статті не відрізняється від повної назви одиниці (name1).
-- Extra conversion data used by Module:Convert.---- [[Module:Convert/data]] defines all units and is transcluded in all pages-- where [[Module:Convert]] is used. Testing new units by editing that module-- would invalidate the cache for all affected pages.---- For quick changes and experiments with new units, this module can be edited.-- Since this module is transcluded in only a small number of pages, changes-- should cause little server overhead and should propagate quickly.---- If a unit is defined in the data module, any definition here is ignored,-- so defining the same unit in both modules is not an error.-- A unit defined here can refer to units that are also defined here, and-- can refer to units defined in the data module.---- Periodically, those extra units that are wanted permanently can be removed-- from here after being added to [[Module:Convert/data]].localextra_units={["bit"]={_name1="біт",_symbol="біт",varname="біти!бітів!біта",utype="інформація",scale=0.125,prefixes=1,default="B",link="Біт",},["біт"]={_name1="біт",_symbol="біт",varname="біти!бітів!біта",utype="інформація",scale=0.125,prefixes=1,default="B",link="Біт",},}return{extra_units=extra_units}