Difference between revisions of "Module:TNT"
Jump to navigation
Jump to search
>Yurik |
>Yurik (add language param) |
||
Line 12: | Line 12: | ||
-- with a given key (e.g. source-table), plus optional arguments | -- with a given key (e.g. source-table), plus optional arguments | ||
-- to the wiki markup in the current content language. | -- to the wiki markup in the current content language. | ||
-- Use lang=xx to set language. | |||
-- | -- | ||
-- {{#invoke:TNT | msg | Original/Template:Graphs.tab | source-table | param1 }} | -- {{#invoke:TNT | msg | Original/Template:Graphs.tab | source-table | param1 }} | ||
-- uses https://commons.wikimedia.org/wiki/Data:Original/Template:Graphs.tab | -- uses https://commons.wikimedia.org/wiki/Data:Original/Template:Graphs.tab | ||
-- | -- | ||
-- The "doc" function will generate the <templatedata> parameter documentation for templates. | -- The "doc" function will generate the <templatedata> parameter documentation for templates. | ||
-- This way all template parameters can be stored and localized in a single Commons dataset. | -- This way all template parameters can be stored and localized in a single Commons dataset. | ||
-- NOTE: "doc" assumes that all documentation is located in Data:Templatedata/* on Commons. | -- NOTE: "doc" assumes that all documentation is located in Data:Templatedata/* on Commons. | ||
Line 31: | Line 32: | ||
local dataset, id | local dataset, id | ||
local params = {} | local params = {} | ||
local lang = nil | |||
for k, v in pairs(frame.args) do | for k, v in pairs(frame.args) do | ||
if k == 1 then | if k == 1 then | ||
Line 38: | Line 40: | ||
elseif type(k) == 'number' then | elseif type(k) == 'number' then | ||
table.insert(params, v) | table.insert(params, v) | ||
elseif k == 'lang' and v ~= '_' then | |||
lang = v | |||
end | end | ||
end | end | ||
return formatMessage(dataset, id, params) | return formatMessage(dataset, id, params, lang) | ||
end | end | ||
Line 61: | Line 65: | ||
function p.doc(frame) | function p.doc(frame) | ||
dataset = 'Templatedata/' .. normalizeDataset(frame.args[1]) | dataset = 'Templatedata/' .. normalizeDataset(frame.args[1]) | ||
-- TODO: add '_' parameter once lua starts reindexing properly for "all" languages | |||
local data = loadData(dataset) | local data = loadData(dataset) | ||
local names = {} | local names = {} | ||
Line 97: | Line 102: | ||
end | end | ||
function formatMessage(dataset, key, params) | function formatMessage(dataset, key, params, lang) | ||
for _, row in pairs(loadData(dataset).data) do | for _, row in pairs(loadData(dataset, lang).data) do | ||
local id, msg = unpack(row) | local id, msg = unpack(row) | ||
if id == key then | if id == key then | ||
Line 127: | Line 132: | ||
end | end | ||
function loadData(dataset) | function loadData(dataset, lang) | ||
local data = mw.ext.data.get(dataset) | local data = mw.ext.data.get(dataset, lang) | ||
if data == false then | if data == false then | ||
if dataset == i18nDataset then | if dataset == i18nDataset then |
Revision as of 04:10, 15 January 2017
Documentation for this module may be created at Module:TNT/doc
--
-- ATTENTION:
-- Please do NOT rename this module - it has to be identical on all wikis.
-- This code is maintained at https://www.mediawiki.org/wiki/Module:TNT
-- Please do not modify it anywhere else, as it may get copied and override your changes.
-- Suggestions can be made at https://www.mediawiki.org/wiki/Module_talk:TNT
--
-- DESCRIPTION:
-- This module allows templates to use translations from the shared Datasets on Commons
--
-- The "msg" function uses a Commons dataset to translate a message
-- with a given key (e.g. source-table), plus optional arguments
-- to the wiki markup in the current content language.
-- Use lang=xx to set language.
--
-- {{#invoke:TNT | msg | Original/Template:Graphs.tab | source-table | param1 }}
-- uses https://commons.wikimedia.org/wiki/Data:Original/Template:Graphs.tab
--
-- The "doc" function will generate the <templatedata> parameter documentation for templates.
-- This way all template parameters can be stored and localized in a single Commons dataset.
-- NOTE: "doc" assumes that all documentation is located in Data:Templatedata/* on Commons.
--
-- {{#invoke:TNT | doc | Graph:Lines }}
-- uses https://commons.wikimedia.org/wiki/Data:Templatedata/Graph:Lines.tab
-- if the current page is Template:Graph:Lines/doc
--
local p = {}
local i18nDataset = 'I18n/Module:TNT.tab'
function p.msg(frame)
local dataset, id
local params = {}
local lang = nil
for k, v in pairs(frame.args) do
if k == 1 then
dataset = v
elseif k == 2 then
id = v
elseif type(k) == 'number' then
table.insert(params, v)
elseif k == 'lang' and v ~= '_' then
lang = v
end
end
return formatMessage(dataset, id, params, lang)
end
-- Converts first parameter to a interwiki-ready link. For example, it converts
-- "Sandbox/Sample.tab" -> 'commons:Data:Sandbox/Sample.tab'
function p.link(frame)
return link(frame.args[1])
end
-- Given a dataset name, convert it to a title with the 'commons:data:' prefix
function link(dataset)
dataset = 'Data:' .. (dataset or '')
if mw.site.siteName == 'Wikimedia Commons' then
return dataset
else
return 'commons:' .. dataset
end
end
function p.doc(frame)
dataset = 'Templatedata/' .. normalizeDataset(frame.args[1])
-- TODO: add '_' parameter once lua starts reindexing properly for "all" languages
local data = loadData(dataset)
local names = {}
for _, field in pairs(data.schema.fields) do
table.insert(names, field.name)
end
local params = {}
local paramOrder = {}
for _, row in pairs(data.data) do
local newVal = {}
local name = nil
for pos, val in pairs(row) do
local columnName = names[pos]
if columnName == 'name' then
name = val
else
newVal[columnName] = val
end
end
if name then
params[name] = newVal
table.insert(paramOrder, name)
end
end
local templateData = {
params=params,
paramOrder=paramOrder,
description=data.description
}
templateData = mw.text.jsonEncode(templateData)
return frame:extensionTag('templatedata', templateData) .. tntMessage('edit_doc', {link(dataset)})
end
function formatMessage(dataset, key, params, lang)
for _, row in pairs(loadData(dataset, lang).data) do
local id, msg = unpack(row)
if id == key then
local result = mw.message.newRawMessage(msg, unpack(params))
return result:plain()
end
end
if dataset == i18nDataset then
-- Prevent cyclical calls
error('Invalid message key "' .. key .. '"')
else
error(tntMessage('error_bad_msgkey', {key, link(dataset)}))
end
end
function tntMessage(key, params)
return formatMessage(i18nDataset, key, params)
end
function normalizeDataset(dataset)
if not dataset or dataset == '' then
error(tntMessage('error_no_dataset', {}))
end
if string.sub(dataset,-4) ~= '.tab' then
dataset = dataset .. '.tab'
end
return dataset
end
function loadData(dataset, lang)
local data = mw.ext.data.get(dataset, lang)
if data == false then
if dataset == i18nDataset then
-- Prevent cyclical calls
error('Missing Commons dataset ' .. i18nDataset)
else
error(tntMessage('error_bad_dataset', {link(dataset)}))
end
end
return data
end
return p