සැකිල්ල:Lang links/doc

මෙම සැකිල්ල Lua භාවිතා කරයි:

Module:Lang links

<translate> No description yet available.</translate>

<translate> Usage</translate>

This template shows which language versions of a page exist (based on the naming scheme ../xx, with xx the language code), and provides links to them. For example:

සැකිල්ල:Xpdoc

Compare:

සැකිල්ල:Xpdoc

(based on Special:Prefixindex), which does not distinguish between a postfix for a language and other postfixes such as /doc and /layout. Another difference is that the language code is shown, rather than the local name.

This template should not be used on templates to avoid hitting the "expensive parser function" or the "LUA execution time" limit on pages with other expensive templates. If your template needs language links, create a /lang subpage, transclude it to the template and regularly update it using සැකිල්ල:Tls. Never use this template directly or indirectly on templates intended for the file namespace that will likely stay there for a long time.

Template:Ll will generate the same results but must be substituted.

Template parameters

Parameter	Description		Default	Status
`1`	Page name of the page that's subpages provide the translation		{{NAMESPACE}}:{{BASEPAGENAME}}	optional
`num_lang`	Maximum number of languages to test. In order to prevent page using the template from landing in Category:Pages with too many expensive parser function calls or showing Lua errors one can only search through top 20, 50, 70, 100, etc. languages. in 2024 a language ranking study analyzed subpages of 2400 templates and counted language subtemplates for each language. Than about 120 languages were ranked based on number of subpages. This option allows you to only test for most likely languages.		70	optional

Template data

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. <nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw <templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

Discussion
There is an ongoing discussion about that matter. Feel invited to comment if you are experienced in either way, your time permits and if you like to share your opinion or to make a suggestion.

Wikipedia's help about TemplateData • Commons-specific information

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
	`1`	Page name of the page that's subpages provide the translation Default {{NAMESPACE}}:{{BASEPAGENAME}}	Unknown	optional
	`num_lang`	Maximum number of languages to test. In order to prevent page using the template from landing in [[:Category:Pages with too many expensive parser function calls]] or showing Lua errors one can only search through top 20, 50, 70, 100, etc. languages. in 2024 a language ranking study analyzed subpages of 2400 templates and counted language subtemplates for each language. Than about 120 languages were ranked based on number of subpages. This option allows you to only test for most likely languages. Default 70	Unknown	optional

<translate> Additional information</translate>

<translate> The template is intended to be used in the following namespaces:</translate> <translate> the Template namespace</translate>

<translate> The template is intended to be used by the following user groups:</translate> <translate> all users</translate>

<translate> Relies on:</translate>
Module:Lang links

<translate> ⧼Seealso⧽</translate>

{{Ll}}, {{Lle}}, {{lang links cheap}}

<translate> Localization</translate>

<translate> This template is not intended to be localized.</translate>