Module:Convert/text: Difference between revisions

m
1 revision imported
(new style: 4-column tabs)
m (1 revision imported)
 
(24 intermediate revisions by 5 users not shown)
Line 1:
--[[ Text used by Module:Convert, for en.wikipedia.org (English)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.
This is a separate module to simplify translation for use on another wiki.
Module:Convert responds to text parameters, and can display text.
Nearly all that text is defined in:
* Module:Convert/data (unit definitions)
* Module:Convert/text (parameter and message definitions)
]]
 
-- Some units accept an SI prefix before the unit code, such as "kg" for kilogram.
Line 24 ⟶ 19:
['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', prefix = 'μ' }, -- 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' , },
Line 39 ⟶ 34:
{ "US", link = "United States customary units" },
{ "U.S.", link = "United States customary units" },
{ "imperial", link = "Imperial unitunits" },
{ "imp", link = "Imperial unitunits" },
}
 
Line 54 ⟶ 49:
}
 
-- One of the following categories is included in the text of each message.
local all_categories = {
unit = "[[Category:Convert invalid unitserrors]]",
option = "[[Category:Convert invalid optionserrors]]",
warning = '[[Category:Convert invalid options]]',
tracking = '[[Category:Convert tracking]]',
}
 
Line 67 ⟶ 63:
-- All messages that may be displayed if a problem occurs.
local all_messages = {
-- Message format string, %s parameters: anchor, $1=title, $2=text, $3=category, $4=anchor.
-- Each displayed message starts with "Convert:" so can easily locate by searching article.
cvt_format = '<sup class="noprint Inline-Template" style="white-space:nowrap;">[<i>[[Help:Convert messages#%s$4|<span title="Convert: %s$1">Convertconvert: %s$2</span>]]</i>]</sup>%s$3<span class="error"></span>',
cvt_format2 = '<sup class="noprint Inline-Template" style="white-space:nowrap;">[[Help:Convert messages#$4|<span title="Convert: $1">$2</span>]]</sup>$3<span class="error"></span>',
cvt_format_preview = '<strong class="error">Error in convert: $1 [[Help:Convert messages#$4|(help)]]</strong>$3',
-- Each of following messages is a table:
-- { [1] = 'title', -- mouseover title text
Line 78 ⟶ 76:
-- replace = gsub_table,
-- } Mouseover title text Link text CatKey Anchor
cvt_bad_num cvt_bad_input = { 'Valueinput "%s$1" must be a number' and unit' , 'Invalidinvalid numberinput' , 'option', 'invalid_numberinvalid_input' },
cvt_big_preccvt_bad_num = { 'PrecisionValue "%s$1" ismust toobe largea number' , 'Precisioninvalid too largenumber' , 'option', 'precision_too_largeinvalid_number' },
cvt_invalid_numcvt_big_prec = { 'Number has overflowed' Precision "$1" is too large' , 'Numberprecision too overflowlarge' , 'option', 'number_overflowprecision_too_large' },
cvt_no_numcvt_invalid_num = { 'Number has overflowed' = { 'Needs the number to be converted' , 'Needsnumber a numberoverflow' , 'option', 'needs_numbernumber_overflow' },
cvt_no_num2cvt_no_num = { 'Needs anotherthe number forto abe rangeconverted' , 'Needsneeds anothera number' , 'option', 'needs_another_numberneeds_number' },
cvt_bad_preccvt_no_num2 = { 'PrecisionNeeds "%s"another mustnumber befor ana integerrange' , 'Invalidneeds precisionanother number' , 'option', 'invalid_precisionneeds_another_number' },
cvt_bad_sigfigcvt_bad_frac = { 'sigfig "%s$1" mustneeds bean ainteger positiveabove integer1' , 'Invalidinvalid sigfigfraction' , 'option', 'invalid_sigfiginvalid_fraction' },
cvt_empty_optioncvt_bad_prec = { 'Ignored empty optionPrecision "%s$1"' must be an integer' , 'Emptyinvalid optionprecision' , 'option', 'empty_optioninvalid_precision' },
cvt_no_spell cvt_bad_sigfig = { 'Spelling"$1" isneeds nota availablepositive integer' , 'Bug,invalid sigfig' ask for help' , 'option', 'ask_for_helpinvalid_sigfig' },
cvt_unknown_optioncvt_empty_option = { 'Ignored invalidempty option "%s$1"' , 'Invalidempty option' , 'option', 'invalid_optionempty_option' },
cvt_bad_defaultcvt_deprecated = { 'UnitOption "%s$1" hasis deprecated' an invalid default' , 'Bug,*' ask for help' , 'unitoption' , 'ask_for_helpdeprecated_option', format = 'cvt_format2', nowarn = true },
cvt_bad_unitcvt_no_spell = { 'Unit "%s"Spelling is invalidnot hereavailable' , 'Unitbug, invalidask herefor help' , 'unitoption' , 'unit_invalid_hereask_for_help' },
cvt_no_default cvt_unknown_option = { 'UnitIgnored invalid option "%s$1"' has no default output unit' , 'Bug,invalid option' ask for help' , 'unitoption' , 'ask_for_helpinvalid_option' },
cvt_no_unitcvt_wd_fail = { 'NeedsUnable nameto ofaccess unitWikidata' , 'Needswikidata unit nameproblem' , 'unitoption' , 'needs_unit_namewikidata_problem' },
cvt_unknown cvt_bad_default = { 'Unit name "%s$1" ishas notan knowninvalid default' , 'Unknown unit' bug, ask for help' , 'unit' , 'unknown_unitask_for_help' },
cvt_should_becvt_bad_unit = { '%s' Unit "$1" is invalid here' , 'Ambiguous unit' invalid here' , 'unit' , 'ambiguous_unitunit_invalid_here', regex = unitcode_regex, replace = unitcode_replace },
cvt_mismatch cvt_no_default = { 'Cannot convertUnit "%s$1" to "%s"' has no default output unit' , 'Unit mismatch' bug, ask for help' , 'unit' , 'unit_mismatchask_for_help' },
cvt_bug_convertcvt_no_unit = { 'Bug:Needs name of unit' Cannot convert between specified units', 'Bug, ask for help' , 'needs unit name' , , 'ask_for_helpunit' , 'needs_unit_name' },
cvt_lookup cvt_unknown = { 'Unit name "%s$1" is incorrectlynot definedknown' , 'Bug,unknown unit' ask for help' , 'unit' , 'ask_for_helpunknown_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 "; "
["or"] = { " or " , "" },
-- [wantname] gives default abbr=off
["or"] = { " or " , "" , " or ", wantname = true },
["sqbr-sp"] = { " [" , "]" },
["sqbr-nbsp"] = { "&nbsp;[" , "]" },
["comma"] = { ", " , "" , ", " },
["slash-sp"] = { " / " , "" , wantname = true },
["slash-nbsp"] = { "&nbsp;/ ", "" , wantname = true },
["slash-nosp"] = { "/" , "" , wantname = true },
["b"] = { " (" , ")" },
["br(or)"] = { "<br/> (" , ")", " or " },
["br"] = { "<br />" , "" , wantname = true },
["br()"] = { "<br />(" , ")", wantname = true },
}
 
-- Text to separate values in a range.
local range_types = {
-- Specifying a table requires "off" and "on" values (for "abbr=off" and "abbr=on");either:
-- * "off" and "on" values (for "abbr=off" and "abbr=on"), or
-- * "input" and "output" values (for LHS and RHS);
-- other fields are optional.
-- Normally,When "adj=on|abbr=off" usesapplies, hyphensspaces within unabbreviatedrange unitstext (names,are notreplaced symbols)with hyphens.
-- However,With "exception = true", means hyphens arethat also usedoccurs with "adj=on|abbr=on".
-- If "adj" is defined here, that text (unchanged) is used with "adj=on" (without hyphens).
["+"] = " + ",
[","] = ",&nbsp;",
Line 127 ⟶ 135:
["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(-)"] = { offinput = "&nbsp;to ", onoutput = "–" },
["+/-"] = { off = "&nbsp;±&nbsp;", on = "&nbsp;±&nbsp;", adj = "&nbsp;±&nbsp;", is_range_change = true },
["by(x)"] = { offinput = " by ", onoutput = " ×&nbsp;", is_range_xout_range_x = true },
["x"] = { off = " by ", on = " ×&nbsp;", abbr_range_x = true },
["xx"] = "&nbsp;×&nbsp;",
["*"] = "×",
["*"] = "×", -- use "*" to replace "x" in {{convert/2}} which is different from "x" in old {{convert}}
["/"] = "&thinsp;/&thinsp;", -- for a table of high/low temperatures with {{convert|83|/|63|F|disp=br()|abbr=values}}
}
 
local range_aliases = {
-- ["alternative name for a range"] = "standard range name"
["and(-)"] = "and-",
["&ndash;"] = "and-",
["×"] = "-x",
["&ndashtimes;"] = "-x",
["to-±"] = "to(+/-)",
["×&plusmn;"] = "x+/-",
}
["±"] = "+/-",
 
-- Convert accepts range text delimited with whitespace, for example, {{convert|1 to 2|ft}}.
-- In addition, the following "words" are accepted without spaces, for example, {{convert|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,
}
 
Line 150 ⟶ 171:
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",
["commafrac"] = "commafrac",
["langinput"] = "langinput",
["lklang"] = "lklang",
["nearlk"] = "nearlk",
["order"] = "order",
["qid"] = "qid",
["qual"] = "qual",
["qualifier"] = "qual",
["round"] = "round",
["sigfig"] = "sigfig",
["sing"] = "adj", -- "sing" is an old alias for "adj"
Line 164 ⟶ 191:
["sp"] = "sp",
["spell"] = "spell",
["stylein"] = "stylein",
["styleout"] = "styleout",
["tracking"] = "tracking",
}
 
Line 169 ⟶ 199:
-- 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 en.wikienwiki, "abbr" includes:
-- ["comma"] = "opt_nocomma"
-- As a result, if the template uses abbr=comma, this scriptModule: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"
["def"] = "", -- ignored (some wrapper templates call convert with "abbr=def" to mean "default abbreviation")
["comma"] = "opt_nocomma", -- no numsep in input or output numbers
["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)
["unit"] = "unit", -- abbr=on but abbreviate units only: e6km → million km (not ×10⁶ km)
["values"] = "opt_values", -- show only input and output numbers, not units
["~"] = "opt_also_symbol", -- show input unit symbol as well as name
},
["adj"] = {
["mid"] = "opt_adjectival, opt_adj_mid", -- adj=on with user-specified text after input unit (between input and output)
["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 "&nbsp;" instead of " " between value and unit name
["mid"] = "opt_adj_mid", -- adj=on with user-specified text before input unit
["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
["ri1ri0"] = "ri1opt_ri=0", -- round input with precision = 10
["ri2ri1"] = "ri2opt_ri=1", -- round input with precision = 21
["ri3ri2"] = "ri3opt_ri=2", -- round input with precision = 32
["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
["off"] = "opt_nocomma", -- no numsep in input or output numbers
},
["debug"] = {
["yes"] = "opt_sortable_debug", -- make the normally hidden sort key visible
},
["disp"] = {
["/5"] = "slashopt_round=5?", -- round output value to nearest -- join: '/'5
["2"] = "opt_output_only", -- display only output value and symbol/name (not input)
["5"] = "opt_round5", -- round output value to nearest 5
["b"] = "b", -- join: '(...)'
["br(or)"] = "br(or)", -- join: '<br/>(...)' with 'or' between outputs in a combination
["br"] = "br", -- join: '<br />'
["br()"] = "br()", -- join: '<br />(...)'
["comma"] = "comma", -- join: ','
["flip"] = "opt_flip", -- reverse order of input/output
["flip5"] = "opt_flip, opt_round5", -- 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'
Line 218 ⟶ 256:
["output only"] = "opt_output_only",
["preunit"] = "opt_two_preunits", -- user-specified text before input and output units
["s"] = "slash", -- join: '/'
["slash"] = "slash", -- join: '/'
["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: <first>...<second> (user-specified text)
},
-- frac=x is handled as a special case: x must be an integer (possibly in local language) = 2 or more
["near"] = {
-- input=x is handled as a special case: x should be <value><space><unitcode> or <wikidata-property-id>
["5"] = "opt_round5", -- round output value to nearest 5
["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
["order"] = {
["fliplocal"] = "opt_flipopt_lang_local", -- use local digits for numbers (default, --although config can reversechange orderdefault ofto input/outputen)
},
["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
["gaps5"] = "opt_gaps, opt_comma5", -- opt_gaps + opt_comma5
},
["debug"] = {
["yes"] = "opt_sortable_debug", -- make the normally hidden sort key visible
},
["lang"] = {
["en"] = "opt_lang_en", -- use en digits for output, regardless of local language
},
["lk"] = {
["in"] = "in", -- link LHS unit name or symbol
["off"] = "off", -- ignoreddo (offnot islink: thesame 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
},
["order"] = {
["flip"] = "opt_flip", -- reverse order of input/output
["out"] = "opt_order_out", -- do not show input; instead, use order in output combination, with the first output shown as the input
},
-- qid=x is handled as a special case: x should be a Wikidata Q item identifier.
-- qual=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)
["on"] = "opt_sortableopt_sortable_on", -- output numeric hidden sort fieldkey for use in a sortable table, based on value from converting to a standard base unit
},
["sp"] = {
["us"] = "opt_sp_us", -- use U.S. spelling (like "meter" instead of default "metre")
},
["spell"] = { -- only English spelling is supported; only for input; 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
-- tracking=x is handled as a special case: x can be any text
}
 
Line 269 ⟶ 313:
all_categories = all_categories,
all_messages = all_messages,
currency = { ['$'] = true, ['£'] = true, ['€'] = true, ['₱'] = true, ['₽'] = true, ['¥'] = true },
customary_units = customary_units,
disp_joins = disp_joins,
Line 274 ⟶ 319:
en_option_value = en_option_value,
eng_scales = eng_scales,
ranges = ranges,
range_aliases = range_aliases,
range_types = range_types,
}