Ogled vira Modul:Convert/dok

{{Transwiki guide|text=See [[:en:Template:Convert/Transwiki guide|'''how to copy the convert template''']] for information on copying this module and modifying it for use on another wiki.}}
{{High-risk}}

This module converts a value from one unit of measurement to another. For example:
* <code><nowiki>{{convert|123|lb|kg}}</nowiki></code> → 123 lb (56 kg)

The module is called using a template—parameters passed to the template are used by this module to control how a conversion is performed. For example, units can be abbreviated (like <code>kg</code>), or displayed as names (like <code>kilogram</code>), and the output value can be rounded to a specified precision. For usage information, see [[Pomoč:Convert]].

== Templates and modules ==
Templates that invoke this module are:
* [[Predloga:Convert]]
* [[Predloga:Cvt]] {{green|1=(convert with abbr=on)}}

The following modules are required:
* [[Modul:Convert]] – ''(this module)'' code to convert units
* [[Modul:Convert/data]] – unit definitions
* [[Modul:Convert/text]] – text messages, and parameter names and values

The following modules are optional and are used only if required and if the module exists:
* [[Modul:Convert/extra]] – extra (temporary) unit definitions; used if a unit is not found in [[Modul:Convert/data]]
* [[Modul:ConvertNumeric]] – code to spell an input value in words (only English is supported; however, see [[:vi:Modul:ConvertNumeric]])

For Wikidata support the following modules are required:
* [[Modul:Convert/wikidata]]
* [[Modul:Convert/wikidata/data]]

The following help pages are available:
* [[Pomoč:Convert]] – overview
* [[Pomoč:Convert sporočila]] – describes error and warning messages; messages link to this page so it is required when the module is copied to another wiki
* [[Pomoč:Convert units]] – overview of units

A page containing a convert error is added to the following hidden category, providing the page is in a specified [[WP:Namespace|namespace]] (articles, by default):
* {{clc|Convert napake}}

Units are defined in the wikitext of the master list of units.
* [[Modul:Convert/documentation/conversion data/dok]] – master list of unit definitions
* [[Modul:Convert/makeunits]] – translates wikitext from the master list to Lua
* [[Module talk:Convert/makeunits]] – makeunits results; copy the text to [[Modul:Convert/data]]

[[Modul:Convert/data]] is transcluded into every page using the convert module, so experimenting with a new unit in that module would involve a significant overhead. The [[Modul:Convert/extra]] module is an alternative which is only transcluded on pages with a unit that is not defined in the main data module.

[[Module talk:Convert/show]] lists all unit links so they can be checked.

== Peskovnik ==
When making a change, copy the current modules to the sandbox pages, then edit the sandbox copies:
{{#invoke:convert/tester|compare}}

Use the following template to test the results (example <code><nowiki>{{convert/peskovnik|123|lb|kg}}</nowiki></code>):
* [[Predloga:Convert/peskovnik]]

[[Predloga:Convert/peskovnik]] invokes [[Modul:Convert/peskovnik]] with parameter {{para|sandbox|peskovnik}} which causes convert to use the sandbox modules rather than the normal modules.

The following should be used to test the results of editing the convert modules.
* [[Predloga:Convert/peskovnik#Sandbox testcases]] – links to testcases
* [[Modul:Convert/tester]] – module to run tests by comparing template output with fixed text

It is not necessary to save a testcases page before viewing test results. For example, [[Predloga:Convert/testniprimeri/peskovnik4]] could be edited to change the tests. While still editing that page, paste {{nowrap|"<code>Template talk:Convert/testniprimeri/peskovnik4</code>"}} (without quotes) into the page title box under "Preview page with this template", then click "Show preview".

== Configuration ==
The template that invokes this module can define options to configure the module. For example:
* <code><nowiki>{{#invoke:convert|convert|numdot=,|numsep=.}}</nowiki></code>
:Sets the [[decimal mark]] to be a comma, and the thousands separator to be a dot.

Other options, with default values, are:
* <code>|maxsigfig=14</code> – maximum number of significant figures
* <code>|nscat=0</code> – [[WP:Namespace|namespaces]] (comma separated) in which an error or warning adds a category to the page
* <code>|warnings=0</code> – 0 (zero) disables warnings; 1 shows important warnings; 2 shows all warnings

An option in the template can specify that the sandbox versions of the modules be used. If specified, the text on the right-hand side of the equals sign must be the name of the subpage for each sandbox module.
* <code>|sandbox=peskovnik</code> – omit for normal operation

All text used for input parameters and for output messages and categories can be customized. For example, at enwiki the option <code>|lk=on</code> can be used to link each displayed unit to its article. The "<code>lk</code>" and "<code>on</code>" can be replaced with any desired text. In addition, input and output numbers can be formatted and can use digits in the local language. See the [[Predloga:Convert/Transwiki guide/translate|translation guide]] for more information.

== To do ==
Document the modules to access Wikidata!

<includeonly>{{#ifeq:{{SUBPAGENAME}}|peskovnik||
[[Kategorija:Moduli, ki dodajajo sledilno kategorijo‏‎]]
}}</includeonly>