Módulo:Convert/text
 | Este módulo pode ter sua documentação deficiente. Por favor, documente-o ou melhore suas explicações caso o saiba usar ou tenha conhecimentos para tal. |
Descrição
Este Módulo implementa a predefinição {{Convert}}. Por favor consulte a predefinição para mais instruções.
Uso
Outra documentação:
-- 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.
['Q'] = { exponent = 30, name = 'quetta', },
['R'] = { exponent = 27, name = 'ronna', },
['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 = 'centí', },
['m'] = { exponent = -3, name = 'milli', },
['μ'] = { exponent = -6, name = 'micro', }, -- 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' , },
['f'] = { exponent =-15, name = 'femto', },
['a'] = { exponent =-18, name = 'atto' , },
['z'] = { exponent =-21, name = 'zepto', },
['y'] = { exponent =-24, name = 'yocto', },
['r'] = { exponent =-27, name = 'ronto', },
['q'] = { exponent =-30, name = 'quecto', },
}
-- Some units can be qualified with one of the following prefixes, when linked.
local customary_units = {
{ "US", link = "Unidades usuais nos Estados Unidos" },
{ "U.S.", link = "Unidades usuais nos Estados Unidos" },
{ "imperial", link = "Unidades imperiais" },
{ "imp", link = "Unidades imperiais" },
}
-- 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"] = { "mil", exponent = 3 },
["6"] = { "milhão", exponent = 6 },
["9"] = { "bilhão", link = "1000000000", exponent = 9 },
["12"] = { "trilhão", link = "1000000000000", exponent = 12 },
["15"] = { "quatrilhão", link = "1000000000000000", exponent = 15 },
}
local all_categories = {
unit = "[[Categoria:!Erros em parâmetros de predefinições]]",
option = "[[Categoria:!Erros em parâmetros de predefinições]]",
warning = '[[Categoria:!Parâmetros desconhecidos]]',
tracking = '[[Categoria:!Categorias de monitoramento]]',
}
-- 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>[[Help:Convert messages#$4|<span title="Convert: $1">convert: $2</span>]]</i>]</sup>$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
-- [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 = { 'entrada "$1" deve ser um número e uma unidade', 'entrada inválida', 'option', 'entrada_invalida' },
cvt_bad_num = { 'Valor "$1" deve ser um número', 'número inválido', 'option', 'numero_invalido' },
cvt_big_prec = { 'Precisão "$1" é muito grande', 'precisão muito grande', 'option', 'precisao_muito_grande' },
cvt_invalid_num = { 'O número estourou o limite', 'estouro de número', 'option', 'estouro_de_numero' },
cvt_no_num = { 'É necessário o número a ser convertido', 'número necessário', 'option', 'numero_necessario' },
cvt_no_num2 = { 'É necessário outro número para um intervalo', 'outro número necessário', 'option', 'outro_numero_necessario' },
cvt_bad_altitude = { '"$1" precisa ser um número inteiro', 'altitude inválida', 'option', 'altitude_invalida' },
cvt_bad_frac = { '"$1" precisa ser um número inteiro acima de 1', 'fração inválida', 'option', 'fracao_invalida' },
cvt_bad_prec = { 'Precisão "$1" deve ser um número inteiro', 'precisão inválida', 'option', 'precisao_invalida' },
cvt_bad_sigfig = { '"$1" precisa ser um número inteiro positivo', 'sigfig inválido', 'option', 'sigfig_invalido' },
cvt_empty_option = { 'Opção vazia "$1" ignorada', 'opção vazia', 'option', 'opcao_vazia' },
cvt_deprecated = { 'A opção "$1" está obsoleta', '*', 'option', 'opcao_obsoleta', format = 'cvt_format2', nowarn = true },
cvt_no_spell = { 'Escrita por extenso não está disponível', 'erro, peça ajuda', 'option', 'pedir_ajuda' },
cvt_unknown_option = { 'Opção inválida "$1" ignorada', 'opção inválida', 'option', 'opcao_invalida' },
cvt_wd_fail = { 'Não foi possível acessar o Wikidata', 'problema no Wikidata', 'option', 'problema_wikidata' },
cvt_bad_default = { 'A unidade "$1" tem um padrão inválido', 'erro, peça ajuda', 'unit', 'pedir_ajuda' },
cvt_bad_unit = { 'A unidade "$1" é inválida aqui', 'unidade inválida aqui', 'unit', 'unidade_invalida_aqui' },
cvt_no_default = { 'A unidade "$1" não tem unidade de saída padrão', 'erro, peça ajuda', 'unit', 'pedir_ajuda' },
cvt_no_unit = { 'É necessário o nome da unidade', 'nome da unidade necessário', 'unit', 'nome_unidade_necessario' },
cvt_unknown = { 'O nome da unidade "$1" não é conhecido', 'unidade desconhecida', 'unit', 'unidade_desconhecida' },
cvt_should_be = { '$1', 'unidade ambígua', 'unit', 'unidade_ambigua', regex = unitcode_regex, replace = unitcode_replace },
cvt_mismatch = { 'Não é possível converter "$1" para "$2"', 'incompatibilidade de unidades', 'unit', 'incompatibilidade_unidades' },
cvt_bug_convert = { 'Erro: Não é possível converter entre as unidades especificadas', 'erro, peça ajuda', 'unit', 'pedir_ajuda' },
cvt_lookup = { 'A unidade "$1" está definida incorretamente', 'erro, peça ajuda', 'unit', 'pedir_ajuda' },
}
-- 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"] = { " ou " , "" , " ou ", wantname = true },
["sqbr-sp"] = { " [" , "]" },
["sqbr-nbsp"] = { " [" , "]" },
["comma"] = { ", " , "" , ", " },
["semicolon"] = { "; " , "" },
["slash-sp"] = { " / " , "" , wantname = true },
["slash-nbsp"] = { " / ", "" , wantname = true },
["slash-nosp"] = { "/" , "" , wantname = true },
["b"] = { " (" , ")" },
["(or)"] = { " (" , ")", " ou " },
["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"] = ", e ",
[", or"] = ", ou ",
["by"] = " por ",
["-"] = "–",
["to about"] = " a cerca de ",
["and"] = { off = " e ", on = " e ", exception = true },
["and(-)"] = { input = " e ", output = "–" },
["or"] = { off = " ou " , on = " ou " , exception = true },
["to"] = { off = " a " , on = " a " , exception = true },
["to(-)"] = { input = " a ", output = "–" },
["+/-"] = { off = " ± ", on = " ± ", adj = " ± ", is_range_change = true },
["by(x)"] = { input = " por ", output = " × ", out_range_x = true },
["x"] = { off = " por ", on = " × ", abbr_range_x = true },
["xx"] = " × ",
["*"] = "×",
["/"] = " / ", -- 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"
["–"] = "-",
["–"] = "-",
["×"] = "x",
["×"] = "x",
["±"] = "+/-",
["±"] = "+/-",
["até"] = "to",
["ate"] = "to",
["ou"] = "or",
["e"] = "and",
["por"] = "by",
}
-- 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",
["abrev"] = "abbr",
["adj"] = "adj",
["altitude_ft"] = "altitude_ft",
["altitude_m"] = "altitude_m",
["comma"] = "comma",
["debug"] = "debug",
["disp"] = "disp",
["error"] = "error",
["frac"] = "frac",
["input"] = "input",
["lang"] = "lang",
["link"] = "lk",
["lk"] = "lk",
["order"] = "order",
["qid"] = "qid",
["qual"] = "qual",
["qualifier"] = "qual",
["round"] = "round",
["sigfig"] = "sigfig",
["sing"] = "adj", -- "sing" is an old alias for "adj"
["sortable"] = "sortable",
["sp"] = "sp",
["spell"] = "spell",
["extenso"] = "spell",
["stylein"] = "stylein",
["styleout"] = "styleout",
["tracking"] = "tracking",
}
-- 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:
-- ["values"] = "opt_values"
-- As a result, if the template uses abbr=values, Module:Convert sets:
-- parms["opt_values"] = 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.
-- Options removed in January 2018 with remnants still in Module:Convert:
-- abbr=mos (in a range, repeat the input unit)
-- adj=1 (set opt_singular to make the unit name singular when 0 < abs(value) <= 1)
local en_option_value = {
["$"] = 'TEXT', -- TEXT 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")
["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
["entrada"] = "in",
["none"] = "off", -- old name for "off"
["não"] = "off",
["nao"] = "off",
["off"] = "off", -- use name for all units
["sim"] = "on",
["on"] = "on", -- use symbol for all units
["out"] = "out", -- use symbol for RHS unit (default)
["saída"] = "out",
["saida"] = "out",
["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)
["não"] = "",
["nao"] = "",
["off"] = "", -- ignored (off is the default)
["sim"] = "opt_adjectival",
["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
["~"] = "opt_also_symbol", -- same as abbr=~ so can have {{convert|1|C|K|abbr=off|adj=~}}
},
["altitude_ft"] = 'INTEGER',
["altitude_m"] = 'INTEGER',
["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"] = "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
["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
["semicolon"] = "semicolon", -- 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"
["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)
["saída"] = "opt_output_only",
["apenas_saida"] = "opt_output_only",
["apenas_saída"] = "opt_output_only",
["numero"] = "opt_output_number_only",
["número"] = "opt_output_number_only",
["apenas_numero"] = "opt_output_number_only",
["apenas_número"] = "opt_output_number_only",
["inverter"] = "opt_flip",
["ou"] = "or",
["virgula"] = "comma",
["vírgula"] = "comma",
["ponto_e_virgula"] = "semicolon",
["ponto_e_vírgula"] = "semicolon",
["quebrar"] = "br",
["tabela"] = "opt_table",
["tabelacentro"] = "opt_tablecen",
["unidade"] = "opt_input_unit_only",
},
["error"] = 'TEXT', -- TEXT is any text that will be returned if the conversion fails, instead of an error occurring
["frac"] = 'INTEGER',
["input"] = 'TEXT', -- TEXT 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
["entrada"] = "in",
["não"] = "off",
["nao"] = "off",
["off"] = "off", -- do not link: same as default except for hand unit
["sim"] = "on",
["on"] = "on", -- link all unit names or symbols (but not twice for the same unit)
["out"] = "out", -- link RHS unit name or symbol
["saída"] = "out",
["saida"] = "out",
},
["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"] = 'TEXT', -- TEXT should be a Wikidata Q item identifier
["qual"] = 'TEXT', -- TEXT 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"] = 'INTEGER',
["sortable"] = {
["off"] = "", -- ignored (off is the default)
["on"] = "opt_sortable_on", -- output sort key for use in a sortable table, based on value from converting to a standard base unit
["debug"] = "opt_sortable_on, opt_sortable_debug", -- |sortable=debug is the same as |sortable=on|debug=yes
},
["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
["entrada"] = "opt_spell_in",
["Entrada"] = "opt_spell_in, opt_spell_upper",
["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
["sim"] = "opt_spell_in, opt_spell_out",
["Sim"] = "opt_spell_in, opt_spell_out, opt_spell_upper",
["us"] = "opt_sp_us", -- use U.S. spelling; same as sp=us so spell=us also works
["nao"] = "",
["não"] = "",
},
["stylein"] = 'TEXT',
["styleout"] = 'TEXT',
["tracking"] = 'TEXT',
}
local titles = {
["frac"] = "Fraction/styles.css",
["sfrac"] = "Frac-2/styles.css",
}
return {
SIprefixes = SIprefixes,
all_categories = all_categories,
all_messages = all_messages,
currency = { ['$'] = true, ['£'] = true, ['€'] = true, ['₱'] = true, ['₽'] = 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,
titles = titles,
}