Module:TNT: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
meta>Yurik
No edit summary
meta>Yurik
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
--
--
--    For example, this will use dataset https://commons.wikimedia.org/wiki/Data:Original/Template:Graphs.tab
--    The "msg" function uses a Commons dataset to translate a message
--    to translate message with ID "source-table" with an argument $1 = "tablename" to a wikitext
--    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 | tablename}}
--      {{#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( frame )
function p.msg(frame)
local dataset, id
local dataset, id
local params = {}
local params = {}
for k, v in pairs( frame.args ) do
local lang = nil
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( frame )
function p.link(frame)
local dataset = 'Data:' .. (frame.args[1] or '')
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


return p
return p

Revision as of 04:28, 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