PrivacyWiki

Module:TNT: Difference between revisions

Module Discussion

Module:TNT (edit)

Revision as of 09:03, 16 June 2021

3,701 bytes added ,  2 years ago
m
16 revisions imported from wikipedia:Module:TNT
No edit summary
m (16 revisions imported from wikipedia:Module:TNT)
 
(38 intermediate revisions by 11 users not shown)
Line 1:
--
-- INTRO: (!!! DO NOT RENAME THIS PAGE !!!)
-- This module allows any template or module to be copy/pasted between
-- wikis without any translation changes. All translation text is stored
-- in the global Data:*.tab pages on Commons, and used everywhere.
--
-- SEE: https://www.mediawiki.org/wiki/Multilingual_Templates_and_Modules
--
-- ATTENTION:
Line 7 ⟶ 14:
--
-- DESCRIPTION:
-- The "msg" function uses a Commons dataset to translate a message
-- This module allows templates to use translations from the shared Datasets on Commons
-- 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. Example:
--
-- {{#invoke:TNT | msg
-- For example, this will use dataset https://commons.wikimedia.org/wiki/Data:Original/Template:Graphs.tab
-- | I18n/Template:Graphs.tab <!-- https://commons.wikimedia.org/wiki/Data:I18n/Template:Graphs.tab -->
-- to translate message with ID "source-table" with an argument $1 = "tablename" to a wikitext
-- | source-table <!-- uses a translation message with id = "source-table" -->
-- | param1 }} <!-- optional parameter -->
--
--
-- 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
--
-- {{#invoke:TNT | msg | Original/Template:Graphs.tab | source-table | tablename}}
--
 
local p = {}
local i18nDataset = 'I18n/Module:TNT.tab'
 
-- Forward declaration of the local functions
function p.msg( frame )
local sanitizeDataset, loadData, link, formatMessage
 
function p.msg(frame)
local dataset, id
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
dataset = mw.text.trim(v)
elseif k == 2 then
id = mw.text.trim(v)
elseif type(k) == 'number' then
table.insert(params,[k - 2] = mw.text.trim(v)
elseif k == 'lang' and v ~= '_' then
lang = mw.text.trim(v)
end
end
return formatMessage(dataset, id, params, lang)
end
 
-- Identical to p.msg() above, but used from other lua modules
for _, row in pairs(mw.ext.data.get(dataset).data) do
-- Parameters: name of dataset, message key, optional arguments
local id2, msg = unpack(row)
-- Example with 2 params: format('I18n/Module:TNT', 'error_bad_msgkey', 'my-key', 'my-dataset')
if id2 == id then
function p.format(dataset, key, ...)
local result = mw.message.newRawMessage(msg, unpack(params))
local checkType = require('libraryUtil').checkType
return result:plain()
checkType('format', 1, dataset, 'string')
end
checkType('format', 2, key, 'string')
end
return formatMessage(dataset, key, {...})
end
 
 
-- Converts first parameter to a interwiki-ready link. For example, it converts
-- Identical to p.msg() above, but used from other lua modules with the language param
-- "Sandbox/Sample.tab" -> 'commons:Data:Sandbox/Sample.tab'
-- Parameters: language code, name of dataset, message key, optional arguments
function p.link( frame )
-- Example with 2 params: formatInLanguage('es', I18n/Module:TNT', 'error_bad_msgkey', 'my-key', 'my-dataset')
local dataset = 'Data:' .. (frame.args[1] or '')
function p.formatInLanguage(lang, dataset, key, ...)
if mw.site.siteName == 'Wikimedia Commons' then
local checkType = require('libraryUtil').checkType
return dataset
checkType('formatInLanguage', 1, lang, 'string')
else
return checkType('commons:formatInLanguage', ..2, dataset, 'string')
checkType('formatInLanguage', 3, key, 'string')
end
return formatMessage(dataset, key, {...}, lang)
end
 
-- Obsolete function that adds a 'c:' prefix to the first param.
function p.doc( frame )
-- "Sandbox/Sample.tab" -> 'c:Data:Sandbox/Sample.tab'
local dataset, id
function p.link(frame)
dataset = 'TemplateParams/Graph:Lines.tab'
forreturn k, v in pairslink( frame.args [1]) do
end
if k == 1 then
dataset = v
end
end
 
function p.doc(frame)
local data = mw.ext.data.get(dataset)
local dataset = 'Templatedata/' .. sanitizeDataset(frame.args[1])
return frame:extensionTag('templatedata', p.getTemplateData(dataset)) ..
formatMessage(i18nDataset, 'edit_doc', {link(dataset)})
end
 
function p.getTemplateData(dataset)
-- TODO: add '_' parameter once lua starts reindexing properly for "all" languages
local data = loadData(dataset)
local names = {}
for _, field in pairsipairs(data.schema.fields) do
table.insert(names, field.name)
end
Line 67 ⟶ 102:
local params = {}
local paramOrder = {}
for _, row in pairsipairs(data.data) do
local newVal = {}
local name = nil
for pos, val in pairsipairs(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
 
-- Work around json encoding treating {"1":{...}} as an [{...}]
local templateData = {
params['zzz123']=''
 
local json = mw.text.jsonEncode({
params=params,
paramOrder=paramOrder,
description=data.description
})
templateData = mw.text.jsonEncode(templateData)
 
json = string.gsub(json,'"zzz123":"",?', "")
return frame:extensionTag('templatedata', templateData)
 
return json
end
 
-- Local functions
 
sanitizeDataset = function(dataset)
if not dataset then
return nil
end
dataset = mw.text.trim(dataset)
if dataset == '' then
return nil
elseif string.sub(dataset,-4) ~= '.tab' then
return dataset .. '.tab'
else
return dataset
end
end
 
loadData = function(dataset, lang)
dataset = sanitizeDataset(dataset)
if not dataset then
error(formatMessage(i18nDataset, 'error_no_dataset', {}))
end
 
-- Give helpful error to thirdparties who try and copy this module.
if not mw.ext or not mw.ext.data or not mw.ext.data.get then
error('Missing JsonConfig extension; Cannot load https://commons.wikimedia.org/wiki/Data:' .. dataset)
end
 
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(formatMessage(i18nDataset, 'error_bad_dataset', {link(dataset)}))
end
end
return data
end
 
-- Given a dataset name, convert it to a title with the 'commons:data:' prefix
link = function(dataset)
return 'c:Data:' .. mw.text.trim(dataset or '')
end
 
formatMessage = function(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 or {}))
return result:plain()
end
end
if dataset == i18nDataset then
-- Prevent cyclical calls
error('Invalid message key "' .. key .. '"')
else
error(formatMessage(i18nDataset, 'error_bad_msgkey', {key, link(dataset)}))
end
end
 
Retrieved from ‘https://privacywiki.xyz/wiki/Special:MobileDiff/13010...14008’