Wikipedia:Modulo

Un modulo Lua es un programma scribite in le linguage de programmation Lua.
Il es collocate in iste wiki sub le spatio de nomines Modulo:NomineDeModulo.
Un tal programma servi de extender le functionalitate de paginas wiki.

Salute Mundo! in Lua

Effectivemente se tracta de un forma avantiate e extendite de patrono.
Le forma de appellar un modulo es un poco differente.
In loco de scriber:

{{NomineDePatrono|parametro}}

In pagina de Usator, on debe scriber le nomine sin le prefixo Modulo:

{{#invoke:NomineDeModulo|function|parametro}}

Tu pote executar le function denominate salute in minusculas in Modulo:Exemplo.
Il non es necessari installar o salvar alcun cosa.

1. Modifica tu pagina de usator.
2. Colla le sequente appello al initio de un nove linea in tu pagina de usator:

# {{#invoke:Exemplo|salute}}
# {{#invoke:Exemplo|salute_a|Livvy}}

3. Clicca Monstrar previsualisation.
   Le appello del function salute in Modulo:Exemplo es reimplaciate per le sequente:

1. Salute Mundo!
2. Salute, Livvy!

4. Clicca Cancellar. Quando demandate, clicca Abandonar.
5. Tu pagina de usator remane inchangiate.

Apprender Lua

Le Consola de depuration de Lua Scribunto es un instrumento secur e interactive pro apprender Lua in Wikipedia.

1. Clicca Vider codice-fonte sur le pagina Modulo:String.
2. Scrolle verso le fundo del pagina usque al section Consola de debug.
3. Incolla le commento e le appel in le quadro de ingresso blau clar (supra le button Rader).

-- Tu prime programma Lua simile a [[Hello World]]--
print("Benvenite a " .. _VERSION .. "!") -- Concatena le version de Lua con `..`

4. Pulsa ↵ Enter un vice pro executar le duo commandos Lua.
5. Le resultato apparera sub le linea de commando Lua print:

Benvenite a Lua 5.1!

6. Pulsa ↑ flecha verso alto pro cyclar inter le commandos Lua precedente.
7. Optionalmente, clicca Rader pro vacuar solmente le Consola de depuration; le editor Lua supra remanera non modificate.

Generator HTML in le Consola de depuration

Appella le functiones salute e salute_a in Modulo:Exemplo:

local modHi = require('Modulo:Exemplo') -- carga le modulo in le Consola
print("1. " .. modHi.salute()) -- monstra "Salute Mundo!"

local frame = mw.getCurrentFrame() -- quadro
frame.args = {"Livvy"}
print("2. " .. modHi.salute_a(frame))

1. Salute Mundo!
2. Salute, Livvy!

Function de identitate

callParserFunction #if

-- #if yesno alora retorna su parametro de ingresso
local yesno = require('Modulo:Yesno')
print(mw.getCurrentFrame():callParserFunction("#if", yesno("Si"), "Si", 'no'))
print(mw.getCurrentFrame():callParserFunction("#if", yesno('no'), "Si", 'no'))

Si
no

1. Claude le Modulo:String protegite, que remane non modificate.

Usar argumentos

Le argumentos es transmittite al modulos del mesme maniera que illos es transmittite al patronos. Nota, tamen, que le texto post le prime signo de barra vertical es sempre le nomine del function; le prime argumento positional es le texto post le secunde signo de barra vertical (`|`).

Argumentos nominate |key=value

{{#invoke:NomineDeModulo|function|namedArgument1=value1|namedArgument2=value2}}

Un altere function in Modulo:Exemplo, nominate conta_fructos, usa le argumentos nominate |bananas= e |pomos= pro contar le numero de bananas e pomos que nos ha. Illo pote esser executate cambiando le ordine del argumentos.

Sur tu pagina de usator:

# {{#invoke:Exemplo|conta_fructos|pomos=3|bananas=4}}
# {{#invoke:Exemplo|conta_fructos|bananas=5|pomos=2}}

1. Io ha 4 bananas e 3 pomos
2. Io ha 5 bananas e 2 pomos

In le consola de depuration de Modulo:String:

local modFruit = require('Modulo:Exemplo')
local frame = mw.getCurrentFrame()
frame.args = {pomos="3", bananas="4"}
print("1. " .. modFruit.conta_fructos(frame))
frame.args = {bananas="5", pomos="2"}
print("2. " .. modFruit.conta_fructos(frame))

1. Io ha 4 bananas e 3 pomos
2. Io ha 5 bananas e 2 pomos

Le major parte del modulos ha un pagina de documentation que explica qual argumentos pote esser usate e qual effectos illos producera.

Testes Lua

Un framework de testage unitarie pro scripts Lua sur Wikipedia es disponibile a Modulo:ScribuntoUnit.
Illo permitte executar tu script con un certe insimul de valores de entrata e verificar que le resultatos expectate es producite.
Le testes unitari es particularmente utile pro relevar rapidemente regressiones, in le qual modificationes a un script introduce nove problemas.

Per convention, le testes unitari pro un modulo como Modulo:Exemplo es placiate in Modulo:Exemplo/testcases.
Illos es executate sur Discussion Modulo:Exemplo/testcases con {{#invoke:Exemplo/testcases|run}}.

Sur tu pagina de usator:

{{#invoke:Exemplo/testcases|run}}

Y Tote le tests ha succedite.

	Nomine	Expectate	Actual
Y	test_hi

Cata methodo de test debe comenciar con p:test_.

Un exemplo de Modulo:Exemplo/testcases es monstrate infra.

--[[Modulo:Exemplo/testcases]]--
local p = require('Modulo:ScribuntoUnit').new()
local modHi = require('Modulo:Exemplo') -- Visita le pagina de discussion pro executar le tests.
function p:test_hi() -- Tests unitari pro [[Modulo:Exemplo]].
    self:assertEquals('Salute Mundo!', modHi.salute())
end 
return p

Principio del testage unitarie

In le consola de depuration de Modulo:String:

local self = {
    assertEquals = function(_, wikitext, expected)
        local got = mw.getCurrentFrame():preprocess(wikitext)
        print('"' .. expected .. '": Expectate')
        print('"' .. got      .. '": Actual')
        return got == expected
    end
}
-- Separator `:` without `self`
print(self:assertEquals(      '{{#invoke:Exemplo|salute}}', 'Salute Mundo!'))
-- Separator `.` with `self`
print(self.assertEquals(self, '{{#invoke:Exemplo|salute}}', 'Salute Mundo!'))

"Salute Mundo!": Expectate
"Salute Mundo!": Actual
true
"Salute Mundo!": Expectate
"Salute Mundo!": Actual
true

Si le test ha successo, le valor expectate e le valor actual non es monstrate, assi que le tabella de resultatos es plus simple:

local modTest = require('Modulo:Exemplo/testcases')
print(modTest.run(mw.getCurrentFrame()))

[[File:Yes check.svg|20px|link=|alt=check]]<span style="display:none">Y</span> Tote le tests ha succedite.
{| class="wikitable scribunto-test-table"
!
! Nomine
! Expectate
! Actual
|-
| [[File:Yes check.svg|20px|link=|alt=check]]<span style="display:none">Y</span>
| test_hi
|
|
|}

Executa Modulo:ScribuntoUnit pro testar Modulo:Exemplo sin crear le pagina Modulo:Exemplo/testcases:

local modTest = require('Modulo:ScribuntoUnit').new()
local modHi  = require('Modulo:Exemplo')
function modTest:test_hi() self:assertEquals('Salute Mundo!', modHi.salute()) end
print(modTest.run(mw.getCurrentFrame()))

Le HTML generate es identic

Depuration de Lua

InfoBox (IB) Aristophanes

Sur tu pagina de usator: problema con le obsolete Modulo:Wikidata

# {{tick}} Nascentia: {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|ymd|qid=Q43353}}
# {{Xmark}} Decesso : {{#invoke:Wikidata|getDateValue|P570|FETCH_WIKIDATA|ymd|qid=Q43353}}

1. Y Nascentia: 448 BC, 444 BC, 450 BC, 446 BC, 445 BC
2. N Decesso :

Extension del defecto: Amedeo III, Zoroastre, Jesus Christo, Mohamet ibn Musa al-Khwarizmi, Friedrich Nietzsche

Patrono:infobox → Patrono:infobox/articulo → Patrono:infobox/articulo/persona → Patrono:Infobox generic → Modulo:Wikidata

Sur tu pagina de usator: solution con Modulo:WikidataIB

# {{tick}} Nascentia: {{#invoke:WikidataIB|getValue|P569|ps=3|qid=Q43353}}
# {{tick}} Decesso  : {{#invoke:WikidataIB|getValue|P570|ps=3|qid=Q43353}}

1. Y Nascentia: c. 445 BC
2. Y Decesso  : 385 BC

Instrumentar un modulo Lua pro le depuration

Modulo original obsolescente Modulo:Wikidata:

p.getDateValue = function(frame)
	local date_format = mw.text.trim(frame.args[3] or i18n["datetime"]["default-format"])
	local date_addon = mw.text.trim(frame.args[4] or i18n["datetime"]["default-addon"])
	local go, errorOrentity, claims = parseInput(frame)
	if not go then
		return errorOrentity
	end
	local entity = errorOrentity
	local out = {}
	for k, v in pairs(claims) do
		if v.mainsnak.datavalue.type == 'time' then
			local timestamp = v.mainsnak.datavalue.value.time

Instrumenta Modulo:Wikidata: NON publica le modificationes.

p.getDateValue = function(frame)
	local date_format = mw.text.trim(frame.args[3] or i18n["datetime"]["default-format"])
	local date_addon = mw.text.trim(frame.args[4] or i18n["datetime"]["default-addon"])
	local go, errorOrentity, claims, propertyID = parseInput(frame)

--                                   ^adder propertyID

	if not go then
		return errorOrentity
	end
	local entity = errorOrentity
	local out = {}
	for k, v in pairs(claims) do

		if v.mainsnak.datavalue == nil then
			local debugLog = {"propertyID: " .. propertyID}
			for key, val in pairs(v) do
				if key == "mainsnak" then
					debugLog[#debugLog + 1] = "key: mainsnak"
					if type(val) == "table" then
						for kVal, vVal in pairs(val) do
							debugLog[#debugLog + 1] = tostring(kVal) .. ": " .. tostring(vVal)
						end
					else
						debugLog[#debugLog + 1] = tostring(val)
					end
				end
			end
			error(table.concat(debugLog, ". "))
		end

		if v.mainsnak.datavalue.type == 'time' then
			local timestamp = v.mainsnak.datavalue.value.time

Pagina de previsualisation con iste patrono:

Aristophanes

1. Clicca Monstrar previsualisation.

Decesso Error de Lua in Modulo:Wikidata al linea 708: propertyID: P570. key: mainsnak. snaktype: somevalue. property: P570. datatype: time (Classical Athens)

datatype: time existe in Modulo:WikidataIB, ma non al position expectate in le obsolete Modulo:Wikidata.

1. Claude le obsolete Modulo:Wikidata, que remane non modificate.

Cite book

Sur tua pagina de usator, colla le sequente Patrono:Cite book:

# {{cite book |last1=Guyer |first1=Paul |last2=Wood |first2=Allen W. |year=1998 |title=Critique of pure reason |publisher=Cambridge University Press |publication-place=Cambridge |isbn=978-0-511-80464-9 |doi=10.1017/CBO9780511804649}}
# {{cite book |last=Guyer |first=Paul |coauthors=Wood, Allen W. |year=1998 |title=Critique of pure reason |publisher=Cambridge University Press |publication-place=Cambridge |isbn=978-0-511-80464-9 |doi=10.1017/CBO9780511804649}}
# {{cite book |last=Guyer |first=Paul |coauthors=Wood, Allen W. |year=1998 |title=Critique of pure reason |publisher=Cambridge University Press |publication-place=Cambridge |isbn=978-0-511-80464-9 |doi=10.1017/CBO9780511804649 |ref=CITEREFGuyerWood1998}}

1. (1998) Critique of pure reason. Cambridge University Press. doi:10.1017/CBO9780511804649. ISBN: 978-0-511-80464-9.
2. Guyer, Paul; Wood, Allen W. (1998). Critique of pure reason. Cambridge University Press. doi:10.1017/CBO9780511804649. ISBN: 978-0-511-80464-9.
3. Guyer, Paul; Wood, Allen W. (1998). Critique of pure reason. Cambridge University Press. doi:10.1017/CBO9780511804649. ISBN: 978-0-511-80464-9.

1. |last1=Guyer |first1=Paul |last2=Wood |first2=Allen W. non es recognoscite per Patrono:Cite book
2. |last=Guyer |first=Paul |coauthors=Wood, Allen W. non genera le ancóra HTML pro {{sfn|Guyer|Wood|1998|pp=4–13}}
3. |ref=CITEREFGuyerWood1998 resolve le problema pro Patrono:Sfn, sed le contributores non divinara iste syntaxe.

Cita libro in le consola de depuration

In le consola de depuration de Modulo:String:

print(mw.title.getCurrentTitle())
print(mw.getCurrentFrame():preprocess('{{PAGENAME}}'))
local wikitext = "{{cite book |last1=Guyer |first1=Paul |last2=Wood |first2=Allen W. |year=1998 |title=Critique of pure reason |publisher=Cambridge University Press |publication-place=Cambridge |isbn=978-0-511-80464-9 |doi=10.1017/CBO9780511804649}}"
print("1. " .. mw.getCurrentFrame():preprocess(wikitext))
local wikitext = "{{cite book |last=Guyer |first=Paul |coauthors=Wood, Allen W. |year=1998 |title=Critique of pure reason |publisher=Cambridge University Press |publication-place=Cambridge |isbn=978-0-511-80464-9 |doi=10.1017/CBO9780511804649}}"
print("2. " .. mw.getCurrentFrame():preprocess(wikitext))
local wikitext = "{{cite book |last=Guyer |first=Paul |coauthors=Wood, Allen W. |year=1998 |title=Critique of pure reason |publisher=Cambridge University Press |publication-place=Cambridge |isbn=978-0-511-80464-9 |doi=10.1017/CBO9780511804649 |ref=CITEREFGuyerWood1998}}"
print("3. " .. mw.getCurrentFrame():preprocess(wikitext))

Modulo:String
String
1. <cite class="book" style="font-style:normal" >&#32;(1998) <i>Critique of pure reason</i>.&#32;Cambridge University Press. [[Identificator de objecto digital|doi]]:[//dx.doi.org/10.1017/CBO9780511804649 10.1017/CBO9780511804649]. <span class="ISBN">[[ISBN]]: [[Special:Fontes de libros/978-0-511-80464-9|978-0-511-80464-9]]</span>.</cite>
2. <cite class="book" style="font-style:normal" id="CITEREFGuyer1998">Guyer, Paul<DEL>'"`UNIQ--nowiki-00000000-QINU`"'<DEL>&#32;Wood, Allen W.&#32;(1998). <i>Critique of pure reason</i>.&#32;Cambridge University Press. [[Identificator de objecto digital|doi]]:[//dx.doi.org/10.1017/CBO9780511804649 10.1017/CBO9780511804649]. <span class="ISBN">[[ISBN]]: [[Special:Fontes de libros/978-0-511-80464-9|978-0-511-80464-9]]</span>.</cite>
3. <cite class="book" style="font-style:normal" id="CITEREFGuyerWood1998">Guyer, Paul<DEL>'"`UNIQ--nowiki-00000001-QINU`"'<DEL>&#32;Wood, Allen W.&#32;(1998). <i>Critique of pure reason</i>.&#32;Cambridge University Press. [[Identificator de objecto digital|doi]]:[//dx.doi.org/10.1017/CBO9780511804649 10.1017/CBO9780511804649]. <span class="ISBN">[[ISBN]]: [[Special:Fontes de libros/978-0-511-80464-9|978-0-511-80464-9]]</span>.</cite>

Comparea Patrono:Cite book con en:Template:Cite book + Modulo:citation/CS1.

In le consola de depuration de Modulo:String:

print('Le reverso de "UNIQ" es "' .. string.reverse("UNIQ") .. '".')
local function buildFrame(templateTitle, parentArgs, moduleName, childArgs)
    local root = mw.getCurrentFrame()
    local parent = root:newChild{title=templateTitle, args=parentArgs or {}}
    return parent:newChild{title=moduleName, args=childArgs or {}}
end
local prm = {last1="Guyer", first1="Paul", last2="Wood", first2="Alan W.",
  year="1998",
  title="The Critique of Pure Reason", publisher="Cambridge University Press",
  ["publication-place"]="Cambridge", isbn="978-0-51-180464-9", language="en"
}
local moduleName = "Modulo:citation/CS1"
local childArg = {CitationClass = "book"}
local frame = buildFrame("Patrono:Cite book", prm, moduleName, childArg)
print(require(moduleName).citation(frame))

Le HTML generate comencia con:

Le reverso de "UNIQ" es "QINU".
<DEL>'"`UNIQ--templatestyles-00000000-QINU`"'<DEL><cite id="CITEREFGuyerWood1998" class="citation book cs1 cs1-prop-foreign-lang-source">Guyer, Paul; Wood, Alan W. (1998). ''The Critique of Pure Reason'' (in anglese). Cambridge: Cambridge University Press. [[ISBN (identifier)|ISBN]]&nbsp;[[Special:BookSources/978-0-51-180464-9|<bdi>978-0-51-180464-9</bdi>]].</cite>
<span title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=book&
rft.btitle=The+Critique+of+Pure+Reason&rft.place=Cambridge&rft.pub=Cambridge+University+Press&
rft.date=1998&rft.isbn=978-0-51-180464-9&rft.aulast=Guyer&rft.aufirst=Paul&
rft.au=Wood%2C+Alan+W.&rfr_id=info%3Asid%2Fia.wikipedia.org%3AModulo%3AString" class="Z3988"></span>
[[Category:CS1 anglese-language sources (en)]]

1. Hidden code "UNIQ--templatestyles.*-QINU" between non‑printing 0x7F DEL markers stripped out with "<DEL>".
2. <cite id="CITEREFGuyerWood1998" for Patrono:Sfn.

1. Clicca Immanuel_Kant#CITEREFGuyerWood1998 pro scrollar usque al libro sin le destacar.
2. Clicca en:Immanuel_Kant#CITEREFGuyerWood1998 pro destacar le libro con un fundo blau.

Info

• Discoperi tote le modulos Lua
• Le documentation pro le extension Scribunto, que permitte tote isto.