Template:Languages/doc: Difference between revisions

Content deleted Content added

Inline

Latest revision as of 21:38, 26 March 2024

This is a documentation subpage for Template:Languages.
It contains usage information, categories, and other content that is not part of the original template page.

This template has a duplicate on Meta-Wiki.

Please visit its documentation on Meta-Wiki for usage details and any additional information.

Please keep the content and translations synchronized as much as possible. Thank you!

@@ Line 1: / Line 1: @@
 {{Documentation subpage}}
+{{Meta-Wiki duplicate content|documentation=true}}
-{{Languages|Template:Languages/doc}}
+<includeonly>
+[[Category:Templates]]
-{{ombox |type=content |text=This template is mostly '''obsolete''' and should be replaced with <syntaxHighlight lang="html" inline><languages/></syntaxHighlight> when possible (i.e. for [[Meta:Internationalization guidelines|translatable]] pages).}}
+</includeonly>
-== Syntax ==
- <nowiki>{{Languages|PageName}}</nowiki>
-* '''PageName''' (optional)&nbsp;– the name of the page to display language links for.  If omitted then the English version of the current page is used.  This parameter can normally be omitted, as it is only required if you want to link to a page other than the one you place the template on, which is very uncommon.  If this parameter is used on a sub-page make sure you supply the root name, not the full page name (e.g. on [[MediaWiki/fr]] you would need to use <code><nowiki>{{Languages|MediaWiki}}</nowiki></code> and not <code><nowiki>{{Languages|MediaWiki/fr}}</nowiki></code>).
-== Usage ==
-The template should only be placed on pages that exist in more than one language, and it should be placed in the same location on each translation of the page.
-The English version of a page is always the main version, with all other languages as sub-pages, named using the appropriate language code (see below).
-For example, on the Main Page you would include the text <code><nowiki>{{Languages}}</nowiki></code>, both on [[Main Page]] itself, and on each of its language sub-pages.  The template automatically creates links to any language sub-pages that exist, e.g. <code>Main Page/ja</code>, <code>Main Page/fr</code>, and ignores non-existant languages.
-See [[Meta:Translate extension]] for further details about translating pages.
-== Supported languages ==
-[[Special:SiteMatrix]] shows you the code and name of each supported language. Other languages may be added easily to the template as necessary.
-'''If no Wikimedia project in your language exists, do not add pages in that language to Meta-Wiki!'''
-== Example ==
-See [[Wikimedia maintenance notice]].
-== Known issues ==
-* The template uses [[Mw:Help:Extension:ParserFunctions##ifexist|<code>#ifexist</code> parser function]] to check whether each translation page exists. Unfortunately, <code>#ifexist</code> [[phab:T14019|unexpectedly populates WhatLinksHere]]: so all missing translation pages are wrongly listed at [[Special:WhatLinksHere]].
-* <code>#ifexist</code> is also an [[mw:Manual:Parser_functions#Expensive_parser_functions|expensive parser function]]; so using this template increases the chance the page exceeds the limit.