Template:Format TemplateData/doc - Revision history

Cellan3 at 18:39, 9 April 2025

2025-04-09T18:39:36Z

← Older revision		Revision as of 12:39, 9 April 2025
Line 6:		Line 6:
	<templatedata>		<templatedata>
	{		{
	"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.",		"description": "This template formats [https://en.wikipedia.org/wiki/Wikipedia:TemplateData 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",		"format": "block",
	"params": {		"params": {

Cellan3 at 18:37, 9 April 2025

2025-04-09T18:37:41Z

← Older revision		Revision as of 12:37, 9 April 2025
Line 17:		Line 17:
	"JSON": {		"JSON": {
	"label": "JSON template information",		"label": "JSON template information",
	"description": "The code that would normally be wrapped in [~~[WP~~:TemplateData\|<templatedata>]] tags (not including the <templatedata> 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 <>. <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 [https://en.wikipedia.org Wikipedia], this will appear as [https://en.wikipedia.org Wikipedia] in the table and https://en.wikipedia.org in VisualEditor.\n'''[https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references HTML entities]''': you may specify &lt; &gt; &amp; &quot; &nbsp; and any numeric entity.'''HTML tags''' may be used; they won't appear in VisualEditor.\n'''<noexport></noexport>''' 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>",		"description": "The code that would normally be wrapped in [https://en.wikipedia.org/wiki/Wikipedia:TemplateData <templatedata>] tags (not including the <templatedata> 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 <>. <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 [https://en.wikipedia.org Wikipedia], this will appear as [https://en.wikipedia.org Wikipedia] in the table and https://en.wikipedia.org in VisualEditor.\n'''[https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references HTML entities]''': you may specify &lt; &gt; &amp; &quot; &nbsp; and any numeric entity.'''HTML tags''' may be used; they won't appear in VisualEditor.\n'''<noexport></noexport>''' 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",		"type": "string",
	"default": "If neither {{{1}}} nor {{{JSON}}} is given, the page's source code is scanned for a <templatedata> tag.",		"default": "If neither {{{1}}} nor {{{JSON}}} is given, the page's source code is scanned for a <templatedata> tag.",

Cellan3 at 18:34, 9 April 2025

2025-04-09T18:34:15Z

← Older revision		Revision as of 12:34, 9 April 2025
Line 17:		Line 17:
	"JSON": {		"JSON": {
	"label": "JSON template information",		"label": "JSON template information",
	"description": "The code that would normally be wrapped in [[WP:TemplateData\|<templatedata>]] tags (not including the <templatedata> 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 <>. <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 [https://en.wikipedia.org Wikipedia], this will appear as [https://en.wikipedia.org Wikipedia] in the table and https://en.wikipedia.org in VisualEditor.\n'''[[HTML entities]]''': you may specify &lt; &gt; &amp; &quot; &nbsp; and any numeric entity.'''HTML tags''' may be used; they won't appear in VisualEditor.\n'''<noexport></noexport>''' 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>",		"description": "The code that would normally be wrapped in [[WP:TemplateData\|<templatedata>]] tags (not including the <templatedata> 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 <>. <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 [https://en.wikipedia.org Wikipedia], this will appear as [https://en.wikipedia.org Wikipedia] in the table and https://en.wikipedia.org in VisualEditor.\n'''[https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references HTML entities]''': you may specify &lt; &gt; &amp; &quot; &nbsp; and any numeric entity.'''HTML tags''' may be used; they won't appear in VisualEditor.\n'''<noexport></noexport>''' 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",		"type": "string",
	"default": "If neither {{{1}}} nor {{{JSON}}} is given, the page's source code is scanned for a <templatedata> tag.",		"default": "If neither {{{1}}} nor {{{JSON}}} is given, the page's source code is scanned for a <templatedata> tag.",

Cellan3: Created page with "{{Documentation subpage}} {{Lua|Module:Format TemplateData}} 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 == {{Format TemplateData|1= { "description": "This template formats TemplateData nicely on doc pages. It hides irrelevant information such as \"Default: empty\", and allows the use of formatting. Remember that the users of Visu..."

2025-04-09T18:15:10Z

Created page with "{{Documentation subpage}} {{Lua|Module:Format TemplateData}} 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 == {{Format TemplateData|1= <templatedata> { "description": "This template formats TemplateData nicely on doc pages. It hides irrelevant information such as \"Default: empty\", and allows the use of formatting. Remember that the users of Visu..."

New page

{{Documentation subpage}}
{{Lua|Module:Format TemplateData}}
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 ==
{{Format TemplateData|1=
<templatedata>
{
"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 parameter is 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|<templatedata>]] tags (not including the <templatedata> 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 <>. <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 [https://en.wikipedia.org Wikipedia], this will appear as [https://en.wikipedia.org Wikipedia] in the table and https://en.wikipedia.org in VisualEditor.\n*'''[[HTML entities]]''': you may specify &lt; &gt; &amp; &quot; &nbsp; and any numeric entity.*'''HTML tags''' may be used; they won't appear in VisualEditor.\n*'''<noexport></noexport>''' 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}}} nor {{{JSON}}} is given, the page's source code is scanned for a <templatedata> tag.",
"suggested": true
},
"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 <code><templatedata></code> as usual, and then enclose it in a template call like <code><nowiki>{{Format TemplateData|1=<templatedata>...</templatedata>}}</nowiki></code>.

==Maintenance categories==
* {{clc|Templates with TemplateData errors}} – the template adds this category to template documentation pages with malformed TemplateData code.

<includeonly>{{sandbox other||

[[Category:TemplateData]]
}}</includeonly>