Template:$/doc: Difference between revisions

From RuneRealm Wiki
Jump to navigation Jump to search
Content added Content deleted
No edit summary
Tag: Reverted
No edit summary
Tag: Manual revert
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{Documentation}}
{{Documentation}}
A template link with a variable number of parameters.


This template converts all provided template params and template values into key/value pairs, which it then passes through as a single json-style string:
===Use===
To use this for templates, use
:{{T|T|<nowiki>parameter 1|parameter 2|parameter 3|...|parameter 20</nowiki>}}<!-- self-referential examples! -->
To use other namespaces, use the namespace as prefix, for example
:{{T|T|User:Example}}
And to show transclusions of mainspace mw.pages, use
:{{T|T|:Bucket}}


<pre>{{$|param1=value|foo=bar|example=great}}</pre>
===Example===
{{$|param1=value|foo=bar|example=great}}
<code><nowiki>{{T|Stub}}</nowiki></code>
:{{T|Stub}}


==Example==
<code><nowiki>{{T|Stub|Item1|Item2|Item3|Item4|Item5|...}}</nowiki></code>
As an example, imagine a "Template:BigTable" which calls an associated "Module:BigTable":
:{{T|Stub|Item1|Item2|Item3|Item4|Item5|...}}


<syntaxhighlight>
<includeonly>[[Category:Formatting templates|{{PAGENAME}}]]</includeonly>
{{BigTable
|{{$|metal1=bronze|metal2=iron|metal3=steel}}
|{{$|metal1=mithril|metal2=adamant|metal3=rune}}
}}
</syntaxhighlight>

Template:$ serializes the information inside of it into a string of key/value pairs, effectively converting the information to this style as it passes through into Template:BigTable:

<syntaxhighlight>
{{BigTable
|{"metal1":"bronze","metal2":"iron","metal3":"steel"}
|{"metal1":"mithril","metal2":"adamant","metal3":"rune"}
}}
</syntaxhighlight>

To access the information in the json params, the module uses the <code>deserialize</code> command from [[Module:$]] on the parameters. This converts the json strings into json objects with standard key/value pairs. The <code>deserialize</code> command leaves normal template params unchanged:

<syntaxhighlight lang="lua">
local ds = require('Module:$').deserialize
local p = {}

function p._main(args)
local secondmetalfromfirstparam = args[1]['metal2']
local thirdmetalfromsecondparam = args[2]['metal3']
end

function p.main(frame)
local args = ds(frame:getParent().args)
return p._main(args)
end

return p
</syntaxhighlight>

Latest revision as of 11:24, 17 October 2024

This is a documentation subpage for Template:$.
It contains usage information, categories, and other content that is not part of the original template page.
Template:$ invokes function serialize in Module:$ using Lua.

This template converts all provided template params and template values into key/value pairs, which it then passes through as a single json-style string:

{{$|param1=value|foo=bar|example=great}}

{"param1":"value","example":"great","foo":"bar"}

Example

As an example, imagine a "Template:BigTable" which calls an associated "Module:BigTable":

{{BigTable
|{{$|metal1=bronze|metal2=iron|metal3=steel}}
|{{$|metal1=mithril|metal2=adamant|metal3=rune}}
}}

Template:$ serializes the information inside of it into a string of key/value pairs, effectively converting the information to this style as it passes through into Template:BigTable:

{{BigTable
|{"metal1":"bronze","metal2":"iron","metal3":"steel"}
|{"metal1":"mithril","metal2":"adamant","metal3":"rune"}
}}

To access the information in the json params, the module uses the deserialize command from Module:$ on the parameters. This converts the json strings into json objects with standard key/value pairs. The deserialize command leaves normal template params unchanged:

local ds = require('Module:$').deserialize
local p = {}

function p._main(args)
	local secondmetalfromfirstparam = args[1]['metal2']
	local thirdmetalfromsecondparam = args[2]['metal3']
end

function p.main(frame)
	local args = ds(frame:getParent().args)
	return p._main(args)
end

return p