모듈:Fallback: 두 판 사이의 차이
Revi HQ
내용 추가됨 내용 삭제됨
편집 요약 없음 |
잔글 (safety check for the "message=ID" (which may not exist or could be disabled) ; add more precise comments to describe some parts.) |
||
1번째 줄: | 1번째 줄: | ||
local p = {} |
local p = {} |
||
-- List the full fallback chain from a language to default (usually English) |
|||
function p.fblist(lang) |
|||
local fbtable = mw.language.getFallbacksFor(lang) |
local fbtable = mw.language.getFallbacksFor(lang) |
||
table.insert(fbtable, 1, lang) |
table.insert(fbtable, 1, lang) |
||
--[[ |
|||
Take a translation from "Mediawiki:<Message-ID>/<language-code>" namespace |
|||
or from a loaded i18 resource bundle in MediaWiki for its UI messages (also |
|||
used by the "{{Int:<Message-ID>}}" parser function), before using the |
|||
provided default value. Requires args.message = 'Message-ID', instead of |
|||
args.message = 'actual translated message'. |
|||
--]] |
|||
table.insert(fbtable, 'message') |
table.insert(fbtable, 'message') |
||
table.insert(fbtable, 'default') |
table.insert(fbtable, 'default') |
||
9번째 줄: | 17번째 줄: | ||
end |
end |
||
--[==[ |
|||
⚫ | |||
Return an error if there is not default and no English version, otherwise |
|||
return the message in the most appropriate, plus the lang code as a second value. |
|||
--]==] |
|||
⚫ | |||
-- args: table of translations |
|||
if not args.en and not args.default and not args.message and args.nocat ~= '1' then |
if not args.en and not args.default and not args.message and args.nocat ~= '1' then |
||
return error("langSwitch error: no default") |
return error("langSwitch error: no default") |
||
end |
end |
||
-- |
-- Get language (either stated one or user's default language). |
||
if not lang then |
if not lang then |
||
return '<strong class="error">LangSwitch Error: no lang</strong>' -- must become proper error |
return '<strong class="error">LangSwitch Error: no lang</strong>' -- must become proper error |
||
end |
end |
||
-- |
-- Get the list of acceptable language (lang + those in lang's fallback chain) and check their content. |
||
for |
for _, code in ipairs(p.fblist(lang)) do |
||
local msg = args[code] |
|||
if msg then |
|||
-- Trim the assigned message value before testing it. |
|||
if j == 'message' then return tostring(mw.message.new(args[j]):inLanguage(lang)) end -- if this is an interface message |
|||
msg = msg:gsub('^%s*(.-)%s*$') |
|||
if args[j] ~= '' then return args[j], j end |
|||
if msg ~= '' then |
|||
if code == 'message' then |
|||
-- If this is an UI message. See [[mw:Manual:Messages API]]. |
|||
msg = mw.message.new(args.message):inLanguage(lang) |
|||
--[==[ If this message name does not exist, converting it to |
|||
a string would not return an actual message, but this name |
|||
within curved angle brackets U+29FC/U+29FD '⧼/⧽', |
|||
part of mathematical symbols). The UI message may also be |
|||
disabled administratively if it causes problems. |
|||
--]==] |
|||
if msg:exists() and not msg:isDisabled() then |
|||
--[==[FIXME: In which language is this message? |
|||
This may be in some fallback language and not lang. |
|||
Note that some UI messages may have placeholders like '%s' |
|||
but there's no way to replace them here by actual values. |
|||
--]==] |
|||
return tostring(msg), lang |
|||
end |
|||
elseif msg == '~' then |
|||
return nil, code |
|||
elseif msg ~= '' then |
|||
return msg, code |
|||
end |
|||
end |
|||
end |
end |
||
end |
end |
||
30번째 줄: | 65번째 줄: | ||
end |
end |
||
--[==[ |
|||
⚫ | |||
Version to be used from wikitext. |
|||
--]==] |
|||
⚫ | |||
local args = frame.args |
local args = frame.args |
||
-- |
-- If no expected args provided than check parent template/module args. |
||
if not args.en and not args.default and not args.nocat then |
if not args.en and not args.default and not args.nocat then |
||
args = frame:getParent().args |
args = frame:getParent().args |
||
40번째 줄: | 78번째 줄: | ||
lang = args.lang |
lang = args.lang |
||
args.lang = nil |
args.lang = nil |
||
else -- |
else -- Get user's chosen language. |
||
lang = frame:preprocess( |
lang = frame:preprocess("{{Int:Lang}}") |
||
end |
end |
||
--[==[ |
|||
if args.zh ~= '' and args['zh-hans'] == '' and args['zh-hant'] == '' then |
if args.zh ~= '' and args['zh-hans'] == '' and args['zh-hant'] == '' then |
||
else |
else |
||
end |
end |
||
--]==] |
|||
local str, language = p._langSwitch(args, lang) |
local str, language = p._langSwitch(args, lang) |
||
return str -- |
return str -- Get the first value of the langSwitch, (the text) not the second (the language). |
||
end |
end |
||
59번째 줄: | 95번째 줄: | ||
if mw.title.new(base .. '/' .. lng).exists then |
if mw.title.new(base .. '/' .. lng).exists then |
||
if formatting == 'table' then |
if formatting == 'table' then |
||
return {base .. '/' .. lng, lng} -- |
return {base .. '/' .. lng, lng} -- Returns name of the page + name of the language. |
||
else |
else |
||
return base .. '/' .. lng -- |
return base .. '/' .. lng -- Returns only the page. |
||
end |
end |
||
end |
end |
||
68번째 줄: | 104번째 줄: | ||
end |
end |
||
--[==[ |
|||
⚫ | |||
Logic for [[Template:Autotranslate]]. |
|||
]==] |
|||
⚫ | |||
local args = frame.args |
local args = frame.args |
||
if not args.lang or args.lang == '' then |
if not args.lang or args.lang == '' then |
||
args.lang = frame:preprocess( |
args.lang = frame:preprocess("{{Int:Lang}}") -- Get user's chosen language. |
||
end |
end |
||
⚫ | |||
⚫ | |||
local base = args.base |
local base = args.base |
||
if not base or base == '' then |
if not base or base == '' then |
||
80번째 줄: | 118번째 줄: | ||
end |
end |
||
if string.sub(base, 2, 9) ~= 'emplate:' then |
if string.sub(base, 2, 9) ~= 'emplate:' then |
||
base = 'Template:' .. base |
base = 'Template:' .. base -- Base provided without 'Template:' part. |
||
end |
end |
||
⚫ | |||
⚫ | |||
local page = p.fallbackpage(base, args.lang) -- |
local page = p.fallbackpage(base, args.lang) -- |
||
if (not page and base ~= args.base) then |
if (not page and base ~= args.base) then |
||
-- |
-- Try the original args.base string. This case is only needed if base is not in template namespace. |
||
page = p.fallbackpage(args.base, args.lang) |
page = p.fallbackpage(args.base, args.lang) |
||
end |
end |
||
92번째 줄: | 129번째 줄: | ||
return string.format('<strong class="error">no fallback page found for autotranslate (base=[[%s]], lang=%s)</strong>', args.base, args.lang) |
return string.format('<strong class="error">no fallback page found for autotranslate (base=[[%s]], lang=%s)</strong>', args.base, args.lang) |
||
end |
end |
||
⚫ | |||
⚫ | |||
local newargs = {} |
local newargs = {} |
||
for field, value in pairs(args) do |
for field, value in pairs(args) do |
||
100번째 줄: | 136번째 줄: | ||
end |
end |
||
end |
end |
||
-- Transclude {{page |....}} with template arguments the same as the ones passed to {{autotranslate}} template. |
-- Transclude {{page |....}} with template arguments the same as the ones passed to {{autotranslate}} template. |
||
return frame:expandTemplate{ title = page, args = newargs } |
return frame:expandTemplate{ title = page, args = newargs } |
||
end |
end |
||
--[==[ |
|||
⚫ | |||
Translate data stored in a module. |
|||
⚫ | |||
]==] |
|||
⚫ | |||
⚫ | |||
page = require('Module:' .. page) |
page = require('Module:' .. page) |
||
end |
end |
||
local val |
local val |
||
if page[key] then |
if page[key] then |
||
val = page[key] |
val = page[key] |
||
elseif page.keys and page.keys[key] then-- |
elseif page.keys and page.keys[key] then -- Key 'keys" is an index of all keys, including redirects, see [[Module:i18n/datatype]]. |
||
val = page.keys[key] |
val = page.keys[key] |
||
end |
end |
||
124번째 줄: | 161번째 줄: | ||
function p.translatelua(frame) |
function p.translatelua(frame) |
||
local lang = frame.args.lang |
local lang = frame.args.lang |
||
local page = require('Module:' .. mw.text.trim(frame.args[1])) -- |
local page = require('Module:' .. mw.text.trim(frame.args[1])) -- Page should only contain a simple of translations. |
||
if not lang or mw.text.trim(lang) == '' then |
if not lang or mw.text.trim(lang) == '' then |
||
lang = frame:preprocess( |
lang = frame:preprocess("{{Int:Lang}}") |
||
end |
end |
||
if frame.args[2] then |
if frame.args[2] then |
||
134번째 줄: | 171번째 줄: | ||
end |
end |
||
-- This test does not work ('Module:Fallback/tests/fallbacks' is missing) |
|||
function p.runTests() |
function p.runTests() |
||
local toFallbackTest = require('Module:Fallback/tests/fallbacks') |
local toFallbackTest = require('Module:Fallback/tests/fallbacks') |
||
local result = true |
local result = true |
||
mw.log('Testing fallback chains') |
mw.log('Testing fallback chains') |
||
for i, t in ipairs(toFallbackTest) do |
for i, t in ipairs(toFallbackTest) do |
||
146번째 줄: | 183번째 줄: | ||
result = result and ret |
result = result and ret |
||
end |
end |
||
return result |
return result |
||
end |
end |
||
--[==[ |
|||
⚫ | |||
]==] |
|||
function p.showTemplateArguments(frame) |
function p.showTemplateArguments(frame) |
||
⚫ | |||
local str = '' |
local str = '' |
||
for name, value in pairs( frame:getParent().args ) do |
for name, value in pairs( frame:getParent().args ) do |
2020년 5월 7일 (목) 04:22 판
이 모듈에 대한 설명문서는 모듈:Fallback/설명문서에서 만들 수 있습니다
local p = {}
-- List the full fallback chain from a language to default (usually English)
function p.fblist(lang)
local fbtable = mw.language.getFallbacksFor(lang)
table.insert(fbtable, 1, lang)
--[[
Take a translation from "Mediawiki:<Message-ID>/<language-code>" namespace
or from a loaded i18 resource bundle in MediaWiki for its UI messages (also
used by the "{{Int:<Message-ID>}}" parser function), before using the
provided default value. Requires args.message = 'Message-ID', instead of
args.message = 'actual translated message'.
--]]
table.insert(fbtable, 'message')
table.insert(fbtable, 'default')
return fbtable
end
--[==[
Return an error if there is not default and no English version, otherwise
return the message in the most appropriate, plus the lang code as a second value.
--]==]
function p._langSwitch(args, lang)
-- args: table of translations
if not args.en and not args.default and not args.message and args.nocat ~= '1' then
return error("langSwitch error: no default")
end
-- Get language (either stated one or user's default language).
if not lang then
return '<strong class="error">LangSwitch Error: no lang</strong>' -- must become proper error
end
-- Get the list of acceptable language (lang + those in lang's fallback chain) and check their content.
for _, code in ipairs(p.fblist(lang)) do
local msg = args[code]
if msg then
-- Trim the assigned message value before testing it.
msg = msg:gsub('^%s*(.-)%s*$')
if msg ~= '' then
if code == 'message' then
-- If this is an UI message. See [[mw:Manual:Messages API]].
msg = mw.message.new(args.message):inLanguage(lang)
--[==[ If this message name does not exist, converting it to
a string would not return an actual message, but this name
within curved angle brackets U+29FC/U+29FD '⧼/⧽',
part of mathematical symbols). The UI message may also be
disabled administratively if it causes problems.
--]==]
if msg:exists() and not msg:isDisabled() then
--[==[FIXME: In which language is this message?
This may be in some fallback language and not lang.
Note that some UI messages may have placeholders like '%s'
but there's no way to replace them here by actual values.
--]==]
return tostring(msg), lang
end
elseif msg == '~' then
return nil, code
elseif msg ~= '' then
return msg, code
end
end
end
end
return nil
end
--[==[
Version to be used from wikitext.
--]==]
function p.langSwitch(frame)
local args = frame.args
-- If no expected args provided than check parent template/module args.
if not args.en and not args.default and not args.nocat then
args = frame:getParent().args
end
local lang
if args.lang and args.lang ~= '' then
lang = args.lang
args.lang = nil
else -- Get user's chosen language.
lang = frame:preprocess("{{Int:Lang}}")
end
--[==[
if args.zh ~= '' and args['zh-hans'] == '' and args['zh-hant'] == '' then
else
end
--]==]
local str, language = p._langSwitch(args, lang)
return str -- Get the first value of the langSwitch, (the text) not the second (the language).
end
function p.fallbackpage(base, lang, formatting)
local languages = p.fblist(lang)
for i, lng in ipairs(languages) do
if mw.title.new(base .. '/' .. lng).exists then
if formatting == 'table' then
return {base .. '/' .. lng, lng} -- Returns name of the page + name of the language.
else
return base .. '/' .. lng -- Returns only the page.
end
end
end
return base
end
--[==[
Logic for [[Template:Autotranslate]].
]==]
function p.autotranslate(frame)
local args = frame.args
if not args.lang or args.lang == '' then
args.lang = frame:preprocess("{{Int:Lang}}") -- Get user's chosen language.
end
-- Find base page.
local base = args.base
if not base or base == '' then
return '<strong class="error">Base page not provided for autotranslate</strong>'
end
if string.sub(base, 2, 9) ~= 'emplate:' then
base = 'Template:' .. base -- Base provided without 'Template:' part.
end
-- Find base template language subpage.
local page = p.fallbackpage(base, args.lang) --
if (not page and base ~= args.base) then
-- Try the original args.base string. This case is only needed if base is not in template namespace.
page = p.fallbackpage(args.base, args.lang)
end
if not page then
return string.format('<strong class="error">no fallback page found for autotranslate (base=[[%s]], lang=%s)</strong>', args.base, args.lang)
end
-- Repack args in a standard table.
local newargs = {}
for field, value in pairs(args) do
if field ~= 'base' then
newargs[field] = value
end
end
-- Transclude {{page |....}} with template arguments the same as the ones passed to {{autotranslate}} template.
return frame:expandTemplate{ title = page, args = newargs }
end
--[==[
Translate data stored in a module.
]==]
function p.translate(page, key, lang)
if type(page) == 'string' then -- If the requested translation table is not yet loaded.
page = require('Module:' .. page)
end
local val
if page[key] then
val = page[key]
elseif page.keys and page.keys[key] then -- Key 'keys" is an index of all keys, including redirects, see [[Module:i18n/datatype]].
val = page.keys[key]
end
if not val then
return '<' .. key .. '>'
end
return p._langSwitch(val, lang)
end
function p.translatelua(frame)
local lang = frame.args.lang
local page = require('Module:' .. mw.text.trim(frame.args[1])) -- Page should only contain a simple of translations.
if not lang or mw.text.trim(lang) == '' then
lang = frame:preprocess("{{Int:Lang}}")
end
if frame.args[2] then
page = page[mw.text.trim(frame.args[2])]
end
return p._langSwitch(page, lang)
end
-- This test does not work ('Module:Fallback/tests/fallbacks' is missing)
function p.runTests()
local toFallbackTest = require('Module:Fallback/tests/fallbacks')
local result = true
mw.log('Testing fallback chains')
for i, t in ipairs(toFallbackTest) do
local fbtbl = table.concat(p.fblist(t.initial), ', ')
local expected = table.concat(t.expected, ', ')
local ret = (fbtbl == expected)
mw.log(i, ret and 'passed' or 'FAILED', t.initial, (not ret) and ('FAILED\nis >>' .. fbtbl .. '<<\nbut should be >>' .. expected .. '<<\n') or '')
result = result and ret
end
return result
end
--[==[
List all input arguments of the template that calls "{{#invoke:Fallback|showTemplateArguments}}"
]==]
function p.showTemplateArguments(frame)
local str = ''
for name, value in pairs( frame:getParent().args ) do
if str == '' then
str = string.format('%s=%s', name, value) -- argument #1
else
str = string.format('%s, %s=%s', str, name, value) -- the rest
end
end
return str
end
return p