模組: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.

local translation_table = {
	omitsep = true,      -- omit separator before local symbol/name
	per_word = '每',     -- for units like "liters per kilometer"
	plural_suffix = '',  -- disable plural unit names
	specials = {         -- for special processing by makeunits
		-- The text here must be the same as that in the unit definitions.
		utype = {
			-- ["unit type in local language"] = "name_used_in_this_script"
			["油耗"] = "type_fuel_efficiency",
			["長度"] = "type_length",
			["溫度"] = "type_temperature",
			["容量"] = "type_volume",
		},
		ucode = {
			exception = {
				-- ["unit code in local language"] = "name_used_in_module_convert"
				["ft"] = "integer_more_precision",
				["in"] = "subunit_more_precision",
				["lb"] = "integer_more_precision",
			},
			istemperature = {
				-- Common temperature scales (not keVT or MK).
				-- ["unit code in local language"] = 1
				["C"] = true,
				["F"] = true,
				["K"] = true,
				["R"] = true,
			},
			usesymbol = {
				-- Use unit symbol not name if abbr not specified.
				-- ["unit code in local language"] = 1
				["C"] = 1,
				["F"] = 1,
				["K"] = 1,
				["R"] = 1,
				["C-change"] = 1,
				["F-change"] = 1,
				["K-change"] = 1,
			},
			alttype = {
				-- Unit has an alternate type that is a valid conversion.
				-- ["unit code in local language"] = "alternate type in local language"
				["Nm"] = "能量",
				["ftlb"] = "力矩",
				["ftlb-f"] = "力矩",
				["ftlbf"] = "力矩",
				["inlb"] = "力矩",
				["inlb-f"] = "力矩",
				["inlbf"] = "力矩",
				["inoz-f"] = "力矩",
				["inozf"] = "力矩",
			},
		},
	},
	mtext = {
		section_names = {
			-- name_used_in_this_script = 'Section title used in conversion data'
			overrides    = '覆蓋單位',
			conversions  = '換算',
			outmultiples = '多重輸出單位',
			combinations = '組合單位',
			inmultiples  = '多重輸入單位',
			defaults     = '預設輸出單位',
			links        = '單位鏈接',
			varnames     = 'Variable names',  -- (for slwiki)
		},
	},
}

-- 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 = '-{zh:堯;zh-cn:尧;zh-tw:佑;zh-hk:堯}-', name_long = '堯它', name_en = 'yotta'},
	['Z'] = { exponent = 21, name = '-{zh:澤;zh-cn:泽;zh-tw:皆;zh-hk:澤}-', name_long = '澤它', name_en = 'zetta'},
	['E'] = { exponent = 18, name = '-{zh:艾;zh-cn:艾;zh-tw:艾;zh-hk:穰}-', name_long = '艾可薩', name_en = 'exa'},
	['P'] = { exponent = 15, name = '-{zh:拍;zh-cn:拍;zh-tw:拍;zh-hk:秭}-', name_long = '拍它', name_en = 'peta'},
	['T'] = { exponent = 12, name = '-{zh:太;zh-cn:太;zh-tw:兆;zh-hk:垓}-', name_long = '太拉', name_en = 'tera'},
	['G'] = { exponent =  9, name = '-{zh:吉;zh-cn:吉;zh-tw:吉;zh-hk:京}-', name_long = '吉咖', name_en = 'giga'},
	['M'] = { exponent =  6, name = '-{zh:百萬;zh-cn:兆;zh-tw:百萬;zh-hk:百萬}-', name_long = '百萬', name_en = 'mega'},
	['k'] = { exponent =  3, name = '千', name_en = 'kilo'},
	['h'] = { exponent =  2, name = '百', name_en = 'hecto'},
	['da']= { exponent =  1, name = '十', name_en = 'deca'},
	['d'] = { exponent = -1, name = '分', name_en = 'deci'},
	['c'] = { exponent = -2, name = '厘', name_en = 'centi'},
	['m'] = { exponent = -3, name = '毫', name_en = 'milli'},
	['μ'] = { exponent = -6, name = '微', name_en = 'micro', prefix = 'µ'},  -- key = 'GREEK SMALL LETTER MU' (U+03BC) utf-8 CE BC
	['µ'] = { exponent = -6, name = '微', name_en = 'micro'},  -- key = 'MICRO SIGN' (U+00B5) utf-8 C2 B5
	['u'] = { exponent = -6, name = '微', name_en = 'micro', prefix = 'µ'},  -- not an SI prefix, but allow for people typing this
	['n'] = { exponent = -9, name = '-{zh:納;zh-cn:纳;zh-tw:奈;zh-hk:納}-', name_long = '納諾', name_en = 'nano'},
	['p'] = { exponent =-12, name = '皮', name_long = '皮可', name_en = 'pico'},
	['f'] = { exponent =-15, name = '飛', name_long = '飛母托', name_en = 'femto'},
	['a'] = { exponent =-18, name = '阿', name_long = '阿托', name_en = 'atto'},
	['z'] = { exponent =-21, name = '-{zh:仄;zh-cn:仄;zh-tw:介;zh-hk:仄}-', name_long = '仄普托', name_en = 'zepto'},
	['y'] = { exponent =-24, name = '-{zh:幺;zh-cn:幺;zh-tw:攸;zh-hk:幺}-', name_long = '幺科托', name_en = 'yocto'},
}

-- Some units can be qualified with one of the following prefixes, when linked.
local customary_units = {
	{ "US", link = "美制單位" },
	{ "U.S.", link = "美制單位" },
	{ "imperial", link = "英制單位" },
	{ "imp", link = "英制單位" },
}

-- 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"]  = { "× 10<sup>3</sup>", exponent = 3 },
	["4"]  = { "× 10<sup>4</sup>", exponent = 4 },
	["5"]  = { "× 10<sup>5</sup>", exponent = 5 },
	["6"]  = { "× 10<sup>6</sup>", exponent = 6 },
	["7"]  = { "× 10<sup>7</sup>", exponent = 7 },
	["8"]  = { "× 10<sup>8</sup>", exponent = 8 },
	["9"]  = { "× 10<sup>9</sup>", exponent = 9 },
	["10"] = { "× 10<sup>10</sup>", exponent = 10 },
	["11"] = { "× 10<sup>11</sup>", exponent = 11 },
	["12"] = { "× 10<sup>12</sup>", exponent = 12 },
	["13"] = { "× 10<sup>13</sup>", exponent = 13 },
	["14"] = { "× 10<sup>14</sup>", exponent = 14 },
	["15"] = { "× 10<sup>15</sup>", link = "数量级 (数)#1015", 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 = "[[Category:未獲Convert模塊承認的單位或選項]]",
	option = "[[Category:未獲Convert模塊承認的單位或選項]]",
}

-- 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 = '<sup class="noprint Inline-Template" style="white-space:nowrap;">[<i>[[:en:Help:Convert messages#$4|<span title="Convert: $1">convert: $2</span>]]</i>]</sup>$3',
	cvt_format2 = '<sup class="noprint Inline-Template" style="white-space:nowrap;">[[:en:Help:Convert messages#$4|<span title="Convert: $1">$2</span>]]</sup>$3',
	cvt_format_preview = '<strong class="error">Error in convert: $1 [[:en:Help:Convert messages#$4|(help)]]</strong>$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      = { '参数值“$1”必须是个数字和单位'               , '无效输入'            , 'option',  'invalid_input'        },
	cvt_bad_num        = { '參數值「$1」必須是個數字'                   , '無效數字'            , 'option',  'invalid_number'       },
	cvt_big_prec       = { '「$1」的精確度過高'                         , '精確度過高'          , 'option',  'precision_too_large'  },
	cvt_invalid_num    = { '數字溢出產生錯誤'                           , '數字溢出'            , 'option',  'number_overflow'      },
	cvt_no_num         = { '需要一個數字進行轉換'                       , '需要數字'            , 'option',  'needs_number'         },
	cvt_no_num2        = { '需要另一個數字定義範圍'                     , '需要另一個數字'      , 'option',  'needs_another_number' },
	cvt_bad_frac       = { '分母或分子「$1」必須是大過1的整數'          , '無效分數'            , 'option',  'invalid_fraction'     },
	cvt_bad_prec       = { '精確度「$1」必須是整數'                     , '無效精確度'          , 'option',  'invalid_precision'    },
	cvt_bad_sigfig     = { '精準度參數sigfig「$1」必須是正整數'         , '無效的sigfig'        , 'option',  'invalid_sigfig'       },
	cvt_empty_option   = { '留空的參數值「$1」已被忽視'                 , '留空的選項'          , 'option',  'empty_option'         },
	cvt_deprecated     = { '选项“$1"已被废弃'                           , '*'                   , 'option',  'deprecated_option', format = 'cvt_format2' },
	cvt_no_spell       = { '參數值無效'                                 , '錯誤:請尋求協助'    , 'option',  'ask_for_help'         },
	cvt_unknown_option = { '無效參數值「$1」已被忽視'                   , '無效的選項'          , 'option',  'invalid_option'       },
	cvt_wd_fail        = { '未能访问维基数据'                           , '维基数据问题'        , 'option',  'wikidata_problem'     },
	cvt_bad_default    = { '單位「$1」存在無效預設值'                   , '錯誤:請尋求協助'    , 'unit'  ,  'ask_for_help'         },
	cvt_bad_unit       = { '單位「$1」無效'                             , '單位於次無效'        , 'unit'  ,  'unit_invalid_here'    },
	cvt_no_default     = { '單位「$1」 沒有預設輸出值'                  , '錯誤:請尋求協助'    , 'unit'  ,  'ask_for_help'         },
	cvt_no_unit        = { '須要單位名字'                               , '缺失單位名'          , 'unit'  ,  'needs_unit_name'      },
	cvt_unknown        = { '不明單位「$1」'                             , '不明單位'            , 'unit'  ,  'unknown_unit'         },
	cvt_should_be      = { '$1'                                         , '單位名有歧義'        , 'unit'  ,  'ambiguous_unit', regex = unitcode_regex, replace = unitcode_replace },
	cvt_mismatch       = { '無法將「$1」轉換成「$2」'                   , '單位不匹配'          , 'unit'  ,  'unit_mismatch'        },
	cvt_bug_convert    = { '錯誤:無法轉換制定的單位'                   , '錯誤:請尋求協助'    , 'unit'  ,  'ask_for_help'         },
	cvt_lookup         = { '單位「$1」的定義不正確'                     , '錯誤:請尋求協助'    , '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"]         = { "或"    , "" , "或", wantname = true },
	["sqbr-sp"]    = { " ["      , "]" },
	["sqbr-nbsp"]  = { "&nbsp;[" , "]" },
	["comma"]      = { ", "      , "" , "" },
	["slash-sp"]   = { "/"     , "" , wantname = true },
	["slash-nbsp"] = { "/", "" , wantname = true },
	["slash-nosp"] = { "/"       , "" , wantname = true },
	["b"]          = { "("      , ")", ";" },
	["(or)"]       = { "("      , ")", "或" },
	["br"]         = { "<br/>"  , "" , wantname = true },
	["br()"]       = { "<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"]  = "和",
	[", or"]   = "或",
	["by"]     = "乘",
	["-"]      = "—",
	["to about"] = "至大約",
	["and"]    = { off = "和", on = "、", exception = true },
	["and(-)"] = { input = "和", output = "—" },
	["or"]     = { off = "或" , on = "或" , exception = true },
	["to"]     = { off = "至" , on = "至" , exception = true },
	["to(-)"]  = { input = "至", output = "—" },
	["+/-"]    = { off = "正負", on = " ± ", adj = "正負", is_range_change = true },
	["by(x)"]  = { input = "乘", output = " ×&nbsp;", out_range_x = true },
	["x"]      = { off = "乘", on = " ×&nbsp;", abbr_range_x = true },
	["xx"]     = "乘",
	["*"]      = "×",  -- use "*" to replace "x" in {{convert/2}} which is different from "x" in old {{convert}}
	["/"]      = "/",  -- 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",
	["–"]        = "-",
	["&ndash;"]  = "-",
	["to-"]      = "to(-)",
	["×"]        = "x",
	["&times;"]  = "x",
	["±"]        = "+/-",
	["&plusmn;"] = "+/-",
	["和"]       = "and",
	["或"]       = "or",
	["至"]       = "to",
}

-- 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,
}

-- 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)
		["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"] = {
		["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_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()"] = "br()",              -- join: '<br />(...)'
		["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: <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
	-- input=x is handled as a special case: x should be <value><space><unitcode> or <wikidata-property-id>
	["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
		["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.
	["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,
	translation_table = translation_table,
}