Module:TNT: Difference between revisions
From the Croc Wiki, the Croc encyclopedia
Jump to navigationJump to search
Content added Content deleted
No edit summary |
No edit summary |
||
Line 9: | Line 9: | ||
-- This module allows templates to use translations from the shared Datasets on Commons |
-- This module allows templates to use translations from the shared Datasets on Commons |
||
-- |
-- |
||
-- The "msg" function uses a Commons dataset to translate a message |
|||
-- For example, this will use dataset https://commons.wikimedia.org/wiki/Data:Original/Template:Graphs.tab |
|||
-- |
-- 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 | |
-- {{#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 p = {} |
||
local i18nDataset = 'I18n/Module:TNT.tab' |
|||
function p.msg( |
function p.msg(frame) |
||
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 |
||
dataset = v |
dataset = v |
||
Line 27: | 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, lang) |
|||
for _, row in pairs(mw.ext.data.get(dataset).data) do |
|||
local id2, msg = unpack(row) |
|||
if id2 == id then |
|||
local result = mw.message.newRawMessage(msg, unpack(params)) |
|||
return result:plain() |
|||
end |
|||
end |
|||
end |
end |
||
-- Converts first parameter to a interwiki-ready link. For example, it converts |
-- Converts first parameter to a interwiki-ready link. For example, it converts |
||
-- "Sandbox/Sample.tab" -> 'commons:Data:Sandbox/Sample.tab' |
-- "Sandbox/Sample.tab" -> 'commons:Data:Sandbox/Sample.tab' |
||
function p.link( |
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 |
if mw.site.siteName == 'Wikimedia Commons' then |
||
return dataset |
return dataset |
||
Line 48: | Line 61: | ||
return 'commons:' .. dataset |
return 'commons:' .. dataset |
||
end |
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 |
end |
||