Módulo:TNTTools

De ProleWiki, la enciclopedia proletaria

Llamadas y funciones ligadas al Módulo:TNT, que a la vez hacen llamadas a tablas multilingües, situadas en Commons, para la creación de módulos y plantillas multilingües. El Módulo:SimpleArgs, pensado para crear módulos multilingües, utiliza estas tablas para los mensajes de error.

TNTTools dispone de:

  • Funciones de interrogación: con retorno booleano o numérico indexado. Para ser llamadas desde otros módulos o desde plantillas. con:
    • Opción de discriminar o no mayúsculas y minúsculas.
    • Posibilidad de más de un valor traducido (donde cada valor es separado por "|").
  • Para ahorrar escritura, en el nombre de las tablas añade "I18n/" como prefijo y la extensión ".tab" como sufijo.

Un ejemplo es Módulo:YesnoTNT y la plantilla {{YesnoTNT}}.

Por ejemplo, con un parámetro que tiene dos o más acepciones:

local p = {}
local SA = require "Module:SimpleArgs"
local TNTT = require "Module:TNTTools"
local function I18nStrTab (S)
  return TNTT.TabTransMT ('TableName',S)
  --en este caso 'P_Title' de 'II18n/TableName.tab' contiene 'title' y 'título' así 'title|título'
end
function p.main (frame)
  args = SA.GetArgs (frame)
  local title = SA.SArgs.StrFromArgs (args, I18nStrTab('P_Title'))
  --title tomará el valor del parámetro |title= o |título=
  ...
end
return p

El Módulo:ArgsTNT', pensado para crear plantillas multilingües, permite obtener valores de parámetros (pasados por frame) con varias claves para el mismo parámetro.


local p = {}

local TNT = require('Module:TNT')
local SD = require('Module:SimpleDebug')

function p.TNTTabFull (TNTTab)
	if (string.sub(TNTTab, 1, 5)) ~= 'I18n/' then
		TNTTab = 'I18n/'..TNTTab
	end	
	if (string.sub(TNTTab, string.len(TNTTab)-3)) ~= '.tab' then
		TNTTab = TNTTab..'.tab'
	end	
	return TNTTab
end --TNTTabFull

function p.TNTTabCommons (TNTTab)
	return 'Commons:Data:'..p.TNTTabFull(TNTTab)
end	

function p.LnkTNTTab (TNTTab)
	return '[['..p.TNTTabCommons(TNTTab)..']]'
end

function I18nStr (TNTTab, S, IsMsg, params)
	TNTTab = p.TNTTabFull (TNTTab)
	local SEnd = TNT.format(TNTTab, S, unpack(params)) or ''
	if SEnd == '' then
		SEnd = TNT.formatInLanguage('en',TNTTab, S, unpack(params))
		if IsMsg then
			local icon = '[[File:Arbcom ru editing.svg|12px|Not found "'..S..'" in current language. Click here for to edit it.|link='..p.TNTTabCommons(TNTTab)..']]'
			SEnd = SEnd..icon	
		end	
	end	
	return SEnd
end --I18nStr

function p.GetMsgP (TNTTab, S, ...)
	return I18nStr (TNTTab, S, true, {...})
end

function p.GetStrP (TNTTab, S, ...)
	return I18nStr (TNTTab, S, false, {...})
end

function p.TabTransCS (TNTTab, S, CaseSensitive)
	CaseSensitive = ((CaseSensitive ~= nil) and (CaseSensitive == true)) or true
	local Wds = TNT.format (p.TNTTabFull(TNTTab), S)
	if not CaseSensitive then
		Wds = string.lower (Wds)
	end	
    return mw.text.split (Wds, '|')
end --TabTransCS

function p.TabTransMT (TNTTab, S, MaxTrans)
	local FN = p.TNTTabFull(TNTTab)
	local tab = mw.text.split (TNT.format (FN, S), '|')
	if #tab > MaxTrans then
		error (string.format('Found %s translations for "%s". Search in [[:commons:data:%s]]',#tab,S,FN)) 
							-- Translation not required
	end
	return tab
end --TabTransMT

function p.SFoundInTNTArr (TNTTab, val, CaseSensitive, S)
	if (S == nil) or (S == '') then
		error('Not arguments trying to find "'..val..'"') --It doesn't require translation, only for degug
	end	
	local Arr = p.TabTransCS (TNTTab, S, CaseSensitive)
	if not CaseSensitive then
		val = string.lower (val)
	end	
	for I, W in ipairs(Arr) do
		if W == val then
			return true
		end	
	end	
	return false
end --SFoundInTNTArr

function p.IdxFromTabTrans (TNTTab, val, CaseSensitive, ...)
	local Arr = unpack(arg)
	if Arr == nil then
		error('Not arguments trying to find "'..val..'"') --It doesn't require translation, only for degug
	end	
	local Idx = 0
	for I, W in ipairs(Arr) do
		if p.SFoundInTNTArr (TNTTab, val, CaseSensitive, W) then
			Idx = I
			break
		end	
	end	
	return Idx
end	--IdxFromTabTrans

return p