Module:Convert/text

-- Text used by Module:Convert for enwiki. -- This is a separate module to simplify translation for use on another wiki. -- See en:Template:Convert/Transwiki guide if copying to another wiki.

-- Some units accept an SI prefix before the unit code, such as "kg" for kilogram. local SIprefixes = { -- The prefix field is what the prefix should be, if different from the prefix used. ['Y'] = { exponent = 24, name = 'yotta',                 }, ['Z'] = { exponent = 21, name = 'zetta',                 }, ['E'] = { exponent = 18, name = 'exa',                  }, ['P'] = { exponent = 15, name = 'peta',                 }, ['T'] = { exponent = 12, name = 'tera',                 }, ['G'] = { exponent = 9, name = 'giga',                  }, ['M'] = { exponent = 6, name = 'mega',                  }, ['k'] = { exponent = 3, name = 'kilo',                  }, ['h'] = { exponent = 2, name = 'hecto',                  }, ['da']= { exponent = 1, name = 'deca', name_us = 'deka' }, ['d'] = { exponent = -1, name = 'deci',                 }, ['c'] = { exponent = -2, name = 'centi',                 }, ['m'] = { exponent = -3, name = 'milli',                 }, ['μ'] = { exponent = -6, name = 'micro', prefix = 'µ'    },  -- key = 'GREEK SMALL LETTER MU' (U+03BC) utf-8 CE BC	['µ'] = { exponent = -6, name = 'micro',                  },  -- key = 'MICRO SIGN' (U+00B5) utf-8 C2 B5	['u'] = { exponent = -6, name = 'micro', prefix = 'µ'     },  -- not an SI prefix, but allow for people typing this ['n'] = { exponent = -9, name = 'nano',                 }, ['p'] = { exponent =-12, name = 'pico',                 }, ['f'] = { exponent =-15, name = 'femto',                 }, ['a'] = { exponent =-18, name = 'atto',                 }, ['z'] = { exponent =-21, name = 'zepto',                 }, ['y'] = { exponent =-24, name = 'yocto',                 }, }

-- Some units can be qualified with one of the following prefixes, when linked. local customary_units = { { "US", link = "United States customary units" }, { "U.S.", link = "United States customary units" }, { "imperial", link = "Imperial units" }, { "imp", link = "Imperial units" }, }

-- Names when using engineering notation (a prefix of "eN" where N is a number; example "e6km"). -- key = { "name", link = "article title", exponent = numeric_key_value } -- If lk=on and link is defined, the name of the number will appear as a link. local eng_scales = { ["3"] = { "thousand", exponent = 3 }, ["6"] = { "million", exponent = 6 }, ["9"] = { "billion", link = "1000000000 (number)", exponent = 9 }, ["12"] = { "trillion", link = "1000000000000 (number)", exponent = 12 }, ["15"] = { "quadrillion", link = "1000000000000000 (number)", exponent = 15 }, }

-- One of the following categories is included in the text of each message. -- Using the same category for each is simplest. local all_categories = { unit = "", option = "", }

-- For some error messages, the following puts the wanted style around -- each unit code marked like '...%{ft%}...'. local unitcode_regex = '%%([{}])' local unitcode_replace = { ['{'] = '"', ['}'] = '"' } -- no longer need the more elaborate substitute used before 2013-09-28

-- All messages that may be displayed if a problem occurs. local all_messages = { -- Message format string: $1=title, $2=text, $3=category, $4=anchor. -- Each displayed message starts with "Convert:" so can easily locate by searching article. cvt_format = '[convert: $2 ] $3', cvt_format2 = '$2 $3', cvt_format_preview = ' Error in convert: $1 (help) $3', -- Each of following messages is a table: -- { [1] = 'title',        -- mouseover title text --  [2] = 'text',          -- link text displayed in article --  [3] = 'category key',  -- key to lookup category in all_categories --  [4] = 'anchor',        -- anchor for link to relevant section on help page --  regex = gsub_regex, --  replace = gsub_table, -- }                   Mouseover title text                           Link text               CatKey     Anchor cvt_bad_input     = { 'input "$1" must be a number and unit'      , 'invalid input'       , 'option',  'invalid_input'        }, cvt_bad_num       = { 'Value "$1" must be a number'               , 'invalid number'      , 'option',  'invalid_number'       }, cvt_big_prec      = { 'Precision "$1" is too large'               , 'precision too large' , 'option',  'precision_too_large'  }, cvt_invalid_num   = { 'Number has overflowed'                     , 'number overflow'     , 'option',  'number_overflow'      }, cvt_no_num        = { 'Needs the number to be converted'          , 'needs a number'      , 'option',  'needs_number'         }, cvt_no_num2       = { 'Needs another number for a range'          , 'needs another number', 'option',  'needs_another_number' }, cvt_bad_frac      = { 'frac "$1" must be an integer above 1'      , 'invalid fraction'    , 'option',  'invalid_fraction'     }, cvt_bad_prec      = { 'Precision "$1" must be an integer'         , 'invalid precision'   , 'option',  'invalid_precision'    }, cvt_bad_sigfig    = { 'sigfig "$1" must be a positive integer'    , 'invalid sigfig'      , 'option',  'invalid_sigfig'       }, cvt_empty_option  = { 'Ignored empty option "$1"'                 , 'empty option'        , 'option',  'empty_option'         }, cvt_deprecated    = { 'Option "$1" is deprecated'                 , '*'                   , 'option',  'deprecated_option', format = 'cvt_format2' }, cvt_no_spell      = { 'Spelling is not available'                 , 'bug, ask for help'   , 'option',  'ask_for_help'         }, cvt_unknown_option = { 'Ignored invalid option "$1"'              , 'invalid option'      , 'option',  'invalid_option'       }, cvt_wd_fail       = { 'Unable to access Wikidata'                 , 'wikidata problem'    , 'option',  'wikidata_problem'     }, cvt_bad_default   = { 'Unit "$1" has an invalid default'          , 'bug, ask for help'   , 'unit'  ,  'ask_for_help'         }, cvt_bad_unit      = { 'Unit "$1" is invalid here'                 , 'unit invalid here'   , 'unit'  ,  'unit_invalid_here'    }, cvt_no_default    = { 'Unit "$1" has no default output unit'      , 'bug, ask for help'   , 'unit'  ,  'ask_for_help'         }, cvt_no_unit       = { 'Needs name of unit'                        , 'needs unit name'     , 'unit'  ,  'needs_unit_name'      }, cvt_unknown       = { 'Unit name "$1" is not known'               , 'unknown unit'        , 'unit'  ,  'unknown_unit'         }, cvt_should_be     = { '$1'                                        , 'ambiguous unit'      , 'unit'  ,  'ambiguous_unit', regex = unitcode_regex, replace = unitcode_replace }, cvt_mismatch      = { 'Cannot convert "$1" to "$2"'               , 'unit mismatch'       , 'unit'  ,  'unit_mismatch'        }, cvt_bug_convert   = { 'Bug: Cannot convert between specified units', 'bug, ask for help'  , 'unit'  ,  'ask_for_help'         }, cvt_lookup        = { 'Unit "$1" is incorrectly defined'          , 'bug, ask for help'   , 'unit'  ,  'ask_for_help'         }, }

-- Text to join input value/unit with output value/unit. local disp_joins = { -- [1]=before output, [2]=after output, [3]=between outputs in a combination; default "; " -- [wantname] gives default abbr=off ["or"]        = { " or "   , "" , " or ", wantname = true }, ["sqbr-sp"]   = { " ["     , "]" }, ["sqbr-nbsp"] = { " [", "]" }, ["comma"]     = { ", "     , "" , ", " }, ["slash-sp"]  = { " / "    , "" , wantname = true }, ["slash-nbsp"] = { " / ", "", wantname = true }, ["slash-nosp"] = { "/"     , "" , wantname = true }, ["b"]         = { " ("     , ")" }, ["(or)"]      = { " ("     , ")", " or " }, ["br"]        = { " " , "" , wantname = true }, ["br"]      = { " (", ")", wantname = true }, }

-- Text to separate values in a range. local range_types = { -- Specifying a table requires either: -- * "off" and "on" values (for "abbr=off" and "abbr=on"), or	-- * "input" and "output" values (for LHS and RHS); -- other fields are optional. -- When "adj=on|abbr=off" applies, spaces in range text are replaced with hyphens. -- With "exception = true", that also occurs with "adj=on|abbr=on". -- If "adj" is defined here, that text (unchanged) is used with "adj=on". ["+"]     = " + ",	[","]      = ", ",	[", and"]  = ", and ", [", or"]  = ", or ", ["by"]    = " by ", ["-"]     = "–",	["to about"] = " to about ", ["and"]   = { off = " and ", on = " and ", exception = true }, ["and(-)"] = { input = " and ", output = "–" }, ["or"]    = { off = " or ", on = " or " , exception = true }, ["to"]    = { off = " to ", on = " to " , exception = true }, ["to(-)"] = { input = " to ", output = "–" }, ["+/-"]   = { off = " ± ", on = " ± ", adj = " ± ", is_range_change = true }, ["by(x)"] = { input = " by ", output = " × ", out_range_x = true }, ["x"]     = { off = " by ", on = " × ", abbr_range_x = true }, ["X"]     = { off = " by ", on = " × " },  -- TEMPORARY and undocumented option for experiments to compare with new abbr_range_x ["xx"]    = " × ", ["*"]     = "×",  -- use "*" to replace "x" in  which is different from "x" in old undefined undefined }

local range_aliases = { -- ["alternative name for a range"] = "standard range name" ["&"]       = "and", ["–"]       = "-",	["–"]  = "-",	["to-"]      = "to(-)", ["×"]       = "x", ["&times;"] = "x", ["±"]       = "+/-",	["&plusmn;"] = "+/-", }

-- Convert accepts range text delimited with whitespace, for example, 1 to 2 ft. -- In addition, the following "words" are accepted without spaces, for example, 1-2 ft. -- Words must be in correct order for searching, for example, 'x' after 'xx'. local range_words = { '-', '–', 'xx', 'x', '*' }

local ranges = { types = range_types, aliases = range_aliases, words = range_words, }

-- Valid option names. local en_option_name = { -- ["local text for option name"] = "en name used in this module" ["$"] = "$",	["abbr"] = "abbr", ["adj"] = "adj", ["comma"] = "comma", ["debug"] = "debug", ["disp"] = "disp", ["frac"] = "frac", ["input"] = "input", ["lang"] = "lang", ["lk"] = "lk", ["near"] = "near", ["order"] = "order", ["qid"] = "qid", ["round"] = "round", ["sigfig"] = "sigfig", ["sing"] = "adj",                  -- "sing" is an old alias for "adj" ["sortable"] = "sortable", ["sp"] = "sp", ["spell"] = "spell", ["stylein"] = "stylein", ["styleout"] = "styleout", }

-- Valid option values. -- Convention: parms.opt_xxx refers to an option that is set here -- (not intended to be set by the template which invokes this module). -- Example: At enwiki, "abbr" includes: --    ["comma"] = "opt_nocomma" -- As a result, if the template uses abbr=comma, Module:Convert sets: --    parms["opt_nocomma"] = true --    parms["abbr"] = nil -- Therefore parms.abbr will be nil, or will have one of the listed values -- that do not start with "opt_". -- An option value of form "xxx?" is the same as "xxx" but shows the input as deprecated. local en_option_value = { -- $=x is handled as a special case: x should be a currency symbol that will be used instead of "$" ["abbr"] = { -- ["local text for option value"] = "en value used in this module" ["comma"] = "opt_nocomma?",    -- no numsep in input or output numbers ["def"] = "",                  -- ignored (some wrapper templates call convert with "abbr=def" to mean "default abbreviation") ["h"] = "on",                  -- abbr=on + use "h" for hand unit (default) ["hh"] = "opt_hand_hh",        -- abbr=on + use "hh" for hand unit ["in"] = "in",                 -- use symbol for LHS unit ["mos"] = "mos",               -- in a range, repeat the input unit (no longer used) ["none"] = "off",              -- old name for "off" ["off"] = "off",               -- use name for all units ["on"] = "on",                 -- use symbol for all units ["out"] = "out",               -- use symbol for RHS unit (default) ["values"] = "opt_values",     -- show only input and output numbers, not units ["~"] = "opt_also_symbol",     -- show input unit symbol as well as name },	["adj"] = { ["1"] = "opt_singular",        -- unit name is singular when value satisfies: (-1 <= v and v < 0) or (0 < v and v <= 1) ["flip"] = "opt_flip?",        -- reverse order of input/output ["j"] = "opt_use_nbsp",        -- "join": use " " instead of " " between value and unit name ["mid"] = "opt_adjectival, opt_adj_mid", -- adj=on with user-specified text after input unit (between input and output) ["nocomma"] = "opt_nocomma?",  -- no numsep in input or output numbers ["off"] = "",                  -- ignored (off is the default) ["on"] = "opt_adjectival",     -- unit name is singular and hyphenated ["pre"] = "opt_one_preunit",   -- user-specified text before input unit ["ri0"] = "opt_ri=0",          -- round input with precision = 0 ["ri1"] = "opt_ri=1",          -- round input with precision = 1 ["ri2"] = "opt_ri=2",          -- round input with precision = 2 ["ri3"] = "opt_ri=3",          -- round input with precision = 3 },	["comma"] = { ["5"] = "opt_comma5",          -- only use numsep grouping if 5 or more digits ["gaps"] = "opt_gaps",         -- use gaps, not numsep, to separate groups of digits ["gaps3"] = "opt_gaps, opt_gaps3", -- group only in threes rather than default of no gap before a single digit after decimal mark ["gaps5"] = "opt_gaps?",       -- deprecated 2015-05-29, was: opt_gaps + opt_comma5 ["off"] = "opt_nocomma",       -- no numsep in input or output numbers },	["debug"] = { ["yes"] = "opt_sortable_debug", -- make the normally hidden sort key visible },	["disp"] = { ["/"] = "or?",                 -- see "slash" ["2"] = "opt_output_only?",    -- display only output value and symbol/name (not input) ["5"] = "opt_round=5",         -- round output value to nearest 5 ["b"] = "b",                   -- join: '(...)' ["(or)"] = "(or)",             -- join: '(...)' with 'or' between outputs in a combination ["br"] = "br",                 -- join: ' '		["br"] = "br",             -- join: ' (...)'		["comma"] = "comma",           -- join: ',' ["flip"] = "opt_flip",         -- reverse order of input/output ["flip5"] = "opt_flip, opt_round=5?", -- disp=flip + disp=5 ["nocomma"] = "opt_nocomma?",  -- no numsep in input or output numbers ["number"] = "opt_output_number_only", -- display output value (not input, and not output symbol/name) ["or"] = "or",                 -- join: 'or' ["out"] = "opt_output_only", ["output number only"] = "opt_output_number_only", ["output only"] = "opt_output_only", ["preunit"] = "opt_two_preunits",   -- user-specified text before input and output units ["s"] = "or?",                 -- see "slash" ["slash"] = "or?",             -- 2014-11-03: "disp=slash" is now equivalent to "disp=or" as slash is unhelpful ["sqbr"] = "sqbr",             -- join: '[...]' ["table"] = "opt_table",       -- output is suitable for a table cell with align="right" ["tablecen"] = "opt_tablecen", -- output is suitable for a table cell with align="center" ["u2"] = "opt_output_unit_only?", -- display output symbol/name (not input, and not output value) ["unit"] = "opt_input_unit_only", -- display input symbol/name (not output, and not input value) ["unit or text"] = "opt_input_unit_only, opt_ignore_error", -- display input symbol/name, or given unit code if not known ["unit2"] = "opt_output_unit_only", ["x"] = "x",                   -- join: ... (user-specified text) },	-- frac=x is handled as a special case: x must be an integer (possibly in local language) = 2 or more -- input=x is handled as a special case: x should be  or  ["lang"] = {                       -- language for output digits (both en and local digits are always accepted for input) ["en"] = "opt_lang_en",        -- use en digits for numbers, regardless of local language ["local"] = "opt_lang_local",  -- use local digits for numbers (default, although config can change default to en) },	["lk"] = { ["in"] = "in",                 -- link LHS unit name or symbol ["off"] = "off",               -- do not link: same as default except for hand unit ["on"] = "on",                 -- link all unit names or symbols (but not twice for the same unit) ["out"] = "out",               -- link RHS unit name or symbol },	["near"] = { ["5"] = "opt_round=5?",        -- round output value to nearest 5 },	["order"] = { ["flip"] = "opt_flip",         -- reverse order of input/output },	-- qid=x is handled as a special case: x should be a Wikidata Q item identifier. ["round"] = { ["0.5"] = "opt_round=0.5",     -- round output value to nearest 0.5 ["5"] = "opt_round=5",         -- round output value to nearest 5 ["10"] = "opt_round=10",       -- round output value to nearest 10 (same as but clearer than "|-1") ["25"] = "opt_round=25",       -- round output value to nearest 25 ["50"] = "opt_round=50",       -- round output value to nearest 50 ["each"] = "opt_round_each",   -- using default precision in a range, round each output separately (default uses highest precision of each item in range) },	-- sigfig=x is handled as a special case: x must be an integer (possibly in local language) = 1 or more ["sortable"] = { ["off"] = "",                  -- ignored (off is the default) ["in"] = "opt_sortable_on?",   -- same as "on" ["on"] = "opt_sortable_on",    -- output sort key for use in a sortable table, based on value from converting to a standard base unit ["out"] = "opt_sortable_on?",  -- same as "on" },	["sp"] = { ["us"] = "opt_sp_us",          -- use U.S. spelling (like "meter" instead of default "metre") },	["spell"] = {                      -- only English spelling is supported; not scientific notation; only some fractions ["in"] = "opt_spell_in",       -- spell input value in words ["In"] = "opt_spell_in, opt_spell_upper",               -- spell input value in words with first letter uppercase ["on"] = "opt_spell_in, opt_spell_out",                 -- spell input and output values in words ["On"] = "opt_spell_in, opt_spell_out, opt_spell_upper", -- same, with first letter of first word in result uppercase },	-- stylein=x is handled as a special case: x can be any text -- styleout=x is handled as a special case: x can be any text }

return { SIprefixes = SIprefixes, all_categories = all_categories, all_messages = all_messages, currency = { ['$'] = true, ['£'] = true }, customary_units = customary_units, disp_joins = disp_joins, en_option_name = en_option_name, en_option_value = en_option_value, eng_scales = eng_scales, ranges = ranges, }