Difference between revisions of "Template:Format TemplateData"

From Second Life Wiki
Jump to navigation Jump to search
(Shamelessly copied from wikipedia.org (pre-Lua version))
 
(Attempt #2!)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
<onlyinclude><div class="TemplateData" {{#ifeq:{{NAMESPACENUMBER}}|10|id="TemplateData"}} style="border:2px solid #B3B7FF; margin:1em 0; padding:.5em 1em 0; position:relative;">
<!-- Everything below this will very likely never work
<onlyinclude><div class="TemplateData" {{#ifeq:{{NAMESPACENUMBER}}|10|id="TemplateData"}} style="border:2px solid #B3B7FF; margin:1em 0; padding:.5em 1em 0; position: relative;">
<div class="backgroundcolor2" style="left:2em; line-height:1; padding:0 .5em; position:absolute; top:-.6em;"><small>{{Wikipedia|Help:TemplateData|TemplateData}}</small></div>
<div class="backgroundcolor2" style="left:2em; line-height:1; padding:0 .5em; position:absolute; top:-.6em;"><small>{{Wikipedia|Help:TemplateData|TemplateData}}</small></div>
{{{1}}}
{{{1}}}
</div><includeonly>{{#ifeq:{{NAMESPACENUMBER}}|10|{{#ifeq:{{#titleparts:{{PAGENAME}}|1|-1}}|Doku||[[Kategorie:Vorlage:mit TemplateData|{{#if:{{{sort|}}}|{{{sort}}}|{{PAGENAME}}}}]]}}}}</includeonly></onlyinclude>
</div><includeonly>{{#ifeq:{{NAMESPACENUMBER}}|10|{{#ifeq:{{#titleparts:{{PAGENAME}}|1|-1}}|Doku||[[Category:Format:with TemplateData|{{#if:{{{sort|}}}|{{{sort}}}|{{PAGENAME}}}}]]}}}}</includeonly></onlyinclude>
{{Dokumentation}}
{{Documentation}}
--><!--
This is a more clever attempt at making it simpler
--><includeonly>{{#ifeq:{{yesno-yes|{{{header}}}}}|yes|{{TemplateData header}}}}
<div class="TemplateData" {{#ifeq:{{NAMESPACENUMBER}}|10|id="TemplateData"}} style="border:2px solid #B3B7FF; margin:1em 0; padding:.5em 1em 0; position: relative;">
<div class="backgroundcolor2" style="left:2em; line-height:1; padding:0 .5em; position:absolute; top:-.6em;"><small>{{Wikipedia|Help:TemplateData|TemplateData}}</small></div>
{{{JSON|<syntaxhighlight lang="json">}}}{{{1}}}{{{JSON|</syntaxhighlight>}}}
</div></includeonly><noinclude>
{{Documentation}}
</noinclude>

Latest revision as of 16:56, 15 February 2023

[Edit] [🔄Purge] Template-info.png Template documentation

Everything below this line is a demo of Format TemplateData: read the source code, and expand the raw TemplateData section, to see how it all works.

Usage

{
	"description": "This template formats [[WP:VE/TD|TemplateData]] nicely on doc pages. It hides irrelevant information such as \"Default: empty\", and allows the use of formatting. Remember that the users of VisualEditor '''will not see''' this formatting; it is important to test your new TemplateData in VisualEditor to check that it makes sense without. (For all details of formatting available, see the template's page.) By default, {{[[Template:TemplateData header|TemplateData header]]}} is automatically inserted before the table.",
	"format": "block",
	"params": {
		"1": {
			"label": "<templatedata> template information",
			"description": "If the JSON and TNT parameters are not specified, this will be processed to extract the JSON. This option allows you to use the GUI TemplateData Editor, but it's a bit wonkier than giving the actual JSON object directly.",
			"default": "See {{{JSON}}}.",
			"type": "string"
		},
		"JSON": {
			"label": "JSON template information",
			"description": "The code that would normally be wrapped in [[WP:TemplateData|&lt;templatedata&gt;]] tags (not including the &lt;templatedata&gt; tags themselves. Links and basic text formatting should just work in the displayed table; see this template's page for full details. You should use HTML entities for special characters such as &lt;&gt;. <noexport><h3>Formatting options</h3>\n*'''Wikilinks''' can be specified in the usual way. They will only work in the table; in VisualEditor, the title of the link will be displayed as plain text.\n*'''External links''' can be specified by just inserting the URL; this will be clickable in the table and viewable in VisualEditor. If the URL is specified as &#91;https:&#47;&#47;en.wikipedia.org Wikipedia&#93;, this will appear as [https://en.wikipedia.org Wikipedia] in the table and https:&#47;&#47;en.wikipedia.org in VisualEditor.\n*'''[[HTML entities]]''': you may specify &amp;lt; &amp;gt; &amp;amp; &amp;quot; &amp;nbsp; and any numeric entity.*'''HTML tags''' may be used; they won't appear in VisualEditor.\n*'''&lt;noexport&gt;&lt;/noexport&gt;''' Content wrapped in these tags will appear only in the table. It will not appear in VisualEditor at all; it is useful for detailed explanations of parameters, and for content that is only useful with formatting. Newline characters are respected here.\n*'''Templates''' may be transcluded. However some templates may output content that makes the JSON invalid.</noexport>",
			"type": "string",
			"default": "If neither {{{1}}}, {{{JSON}}}, nor {{{TNT}}} is given, the page's source code is scanned for a <templatedata> tag.",
			"suggested": true
		},
		"TNT": {
			"label": "Commons “Data:Templatedata” subpage",
			"description": "If the JSON parameter is not specified, this is the name of the tabular data file storing the [[mw:Special:MyLanguage/Help:TemplateData|TemplateData]] file on [[c:Special:MyLanguage|Wikimedia Commons]] in the '''Data:''' namespace as a subpage of [[c:Special:PrefixIndex/Data:Templatedata/|Data:Templatedata]]. This relies on [[Module:TNT]].",
			"autovalue": "{{subst:ROOTPAGENAME}}",
			"suggested": true,
			"type": "string"
		},
		"TOC": {
			"label": "Show table of contents",
			"description": "If set to 1, inserts a table of contents for the whole page just after the description and before any parameter table.",
			"type": "boolean",
			"default": "0",
			"suggested": true
		},
		"header": {
			"label": "Show TemplateDataHeader",
			"description": "If set to 0, hides the {{[[Template:TemplateData header|TemplateData header]]}} template. This is not generally recommended.",
			"type": "boolean",
			"default": "1"
		},
		"lazy": {
			"label": "Prevent TemplateData output",
			"description": "If set, other than to 0, prevents any real TemplateData being produced. Potentially useful if there are multiple instances of this template on a page but only one should be active. To clarify, this means that this template will ''not'' be understood by VisualEditor.",
			"type": "boolean",
			"default": "0"
		}
	}
}
<!--</templatedata>}}-->

Using the template

Add the <templatedata> as usual, and then enclose it in a template call like {{Format TemplateData|1=<templatedata>...</templatedata>}}.

Maintenance categories