Template:Interlanguage link: Difference between revisions

Revision as of 02:18, 10 August 2023

Template documentation[view] [edit] [history] [purge]

This template is used by one or more bots.

If you intend to change this template in any significant way, move or nominate it for deletion, please inform the bot operators. Thank you. The relevant bots are: cewbot.

This template is used on approximately 144,000 pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

Due to a server limit of 500 "expensive parser function" calls (#ifexist:, PAGESIZE:, and PAGESINCATEGORY:), this template or module will only work properly if the page using it has not already exceeded the limit. When the limit is exceeded, the page using this template or module is categorised Category:Pages with too many expensive parser function calls. (further information)

This template links conditionally to pages on non-English Wikipedias. If the specified article does not exist on the English Wikipedia, this template intentionally displays a red link to that anticipated but still-nonexistent article, followed by link(s) to the specified article(s) on the non-English Wikipedia(s), shown under the corresponding language code(s), in brackets. Hovering over a non-English link displays the name of the article on the non-English Wikipedia, as normal. Links to non-English Wikipedia articles are always blue; it is up to the editor to make sure they link to the intended article.

If the specified article exists (that is, after the anticipated article has been created) on the English Wikipedia, this template will only show the blue link to that article, and no longer to the non-English link(s).^[a]

Because {{ill}} normally produces a working link along with a redlink, it is appropriate for use in hatnotes, in spite of the general advice to avoid redlinks in hatnotes.^[b]

Please be aware Cewbot removes this template when it detects the target article has been created on English Wikipedia, converting {{ill}} links to regular (blue) links.^[a]

Usage

There are several ways of using this template. It can produce links to one or more specific languages, Magnus Manske's Reasonator, or to the Wikidata table of languages.

The shortcut {{ill}} may be used.

A full list of language codes can be found at List of Wikipedias#Detailed list.

As of February 2016^[update], if there is a redirect for the term in English Wikipedia, both the redirected (blue) link and interlanguage link(s) are displayed. This is why "casa" appears as a bluelink in the example below.

Where there are multiple interlanguage links readers may be confused about their purpose. The template {{interlanguage link info}} may be placed at the head of a page or section.

Link to one foreign language

To link to a foreign language article with the same title as the English Wikipedia, the parameters are:

{{ill|Article title|language code}}

{{ill|Hanning Schröder|de}} produces: Hanning Schröder [de] (the English article exists),

whereas

{{ill|Richard J. Youle|de}} produces: Richard J. Youle [de] (as of June 2022, no English article exists)

To link to a foreign language article with a different title, the parameters are:

{{ill|English article title|language code|Title in foreign language}}

{{ill|Hooglede town hall|nl|Gemeentehuis van Hooglede}} produces: Hooglede town hall [nl]

Link to multiple languages

To link to multiple languages with the same title as the English language page, the titles of the page are not necessary; the parameters are:

{{ill|English article title|language 1 code||language 2 code||...}}

{{ill|casa|es||it||ro||de|haus}} produces: casa [es; it; ro; de]

Note: As of February 2016, casa above is a redirect. Redirects appear as blue links even while foreign-language links are still shown.

To link to multiple language articles, the parameters are:

{{ill|English article title|language 1 code|Title in language 1|language 2 code|Title in language 2|...}}

{{ill|Olena Chaplynska|uk|Олена Чаплинська|ru|Чаплинская, Гелена|ja|モトローナ・チャプリーンシカ}} produces: Olena Chaplynska [uk; ru; ja]

Modifying the display

Displaying different text

To create a piped link (text displayed that is different from the title of the page to which the text links), use the |lt= parameter (which stands for "link text"). This is useful if disambiguation is necessary, for example to hide the (botanist) in Charles Darwin (botanist):

{{ill|Charles Darwin (botanist)|lt=

Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.Charles Darwin|fr|Charles Darwin|de|Charles Darwin|...}} produces: Charles Darwin [fr; de; es]

Do not use {{!}} to create piped links: {{ill|Maze (band){{!}}Mazy|...}} is not equivalent to {{ill|Maze (band)|lt= Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.Mazy|...}}. The former will not cause the foreign language links to disappear when the English article exists.

Forcing links

To display the interlanguage links even if the English Wikipedia article exists, add any of the values 1, y, yes or force for the parameter |display= or its alias, |preserve=.^[a]

Input	Output
`{{ill\|Joke\|fr\|Blague\|hu\|Vicc\|de\|Witz}}`	Joke [fr; hu; de]
`{{ill\|Joke\|fr\|Blague\|hu\|Vicc\|de\|Witz\|display=1}}`	Joke [fr; hu; de]

This feature should not be used in articles under most circumstances. However, in pages that are primarily lists of pages that link to the same language, it might be desirable all links on a page should link to other languages whether or not an English page exists. This feature can also be used as a work-around to eliminate expensive parser function calls.

Note: As of February 2016, redirects appear as blue links even while foreign-language links are still shown (i.e. you do not need to force-show them).

Remove bold formatting from links

Usually the display of the Interlanguage or Wikidata or the Reasonator (the "appended link") are in normal font, but if the appended link is for example in a title line of table, then along with the rest of the line the appended link will be bold. In such circumstances the appended link can be set to display unbolded by adding any value for the parameter |nobold=.

Input	Output
`'''{{ill\|Charles Darwin (botanist)\|fr\|Charles Darwin\|de\|Charles Darwin}}'''`	Charles Darwin (botanist) [fr; de]
`'''{{ill\|nobold=1\|Charles Darwin (botanist)\|fr\|Charles Darwin\|de\|Charles Darwin}}'''`	Charles Darwin (botanist) [fr; de]

Italics and quotation marks

If the linked material should be in italics (e.g., it is a major work such as a film title), use |italic=y (or |italic=yes, etc.) to generate italic markup around the link but not around the square-bracketed inter-language links.{{ill|Un papillon sur l'épaule|fr|italic= Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.y}} produces: Un papillon sur l'épaule [fr]

If the linked material should have quotation marks around it (e.g., it is a minor work such as a song title), use |quote=y (or |quote=yes, etc.) to generate them around the link, but not around the square-bracketed inter-language links, and not themselves part of the link. This only does double quotation marks: {{ill|Maman ne le sait pas|fr|quote= Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.y}} produces: "Maman ne le sait pas" [fr]

If both are used, quotation marks will appear around an italicized title, without italicizing the quotation marks.

Punctuation before language links

If punctuation such as a comma or period/full stop follows the expression, you may wish to display the punctuation before the interlanguage link(s), especially if combining it with superscript display. So, rather than have:

...the French concept of freedom of instruction^[fr].

which awkwardly displays the sentence-final punctuation after the French link, you can display it before:

...the French concept of freedom of instruction.^[fr]

The second example above is achieved simply by borrowing the |lt= parameter, and including the punctuation in it, like this:

{{ill|freedom of instruction|fr|Liberté d'enseignement|lt=

Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.freedom of instruction.|v= Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.sup}}

Vertical alignment

The vertical alignment of the interlanguage/Wikidata/Reasonator links can be altered by adding:

vertical-align=sup to place the links in superscript
vertical-align=sub to place the links in subscript

The parameter aliases |valign= or |v= may be used instead.

Input	Output
`{{ill\|Charles Darwin (botanist)\|fr\|Charles Darwin\|de\|Charles Darwin\|vertical-align=sup}}`	Charles Darwin (botanist)^{[fr; de]}
`{{ill\|Charles Darwin (botanist)\|fr\|Charles Darwin\|de\|Charles Darwin\|valign=sub}}`	Charles Darwin (botanist)_{[fr; de]}
`{{ill\|Charles Darwin (botanist)\|fr\|Charles Darwin\|de\|Charles Darwin\|v=sup}}`	Charles Darwin (botanist)^{[fr; de]}

Infobox font size

When this template is placed within elements that already use a smaller font size, such as infoboxes, the interlanguage link drops below 85% of the page's default font size. To prevent this and adhere to MOS:SMALLTEXT the value ib can be used with the vertical alignment parameter: vertical-align=ib (or v=ib, etc.)

Input	Output
`{{ill\|Charles Darwin (botanist)\|fr\|Charles Darwin\|de\|Charles Darwin\|v=ib}}`	Charles Darwin (botanist) [fr; de]

This feature should only be used when the template is placed within infoboxes or other elements that use a smaller font size.

Link to Reasonator and Wikidata

To link to the Wikidata table of languages in which the article is available, the parameters are:

{{ill|Article title in English Wikipedia|WD= Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.Wikidata item code}}

{{ill|Jokery|WD=

Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.Q131138}} produces: Jokery [Wikidata] All links to other Wikipedias are ignored if |WD= is present.

To link to Reasonator, add any value for the parameter |reasonator=. If a Wikidata item is linked, then the Reasonator link goes to the page for that item; if not, then a search is performed on Reasonator for that item.

Input	Output
`{{ill\|Jokery\|WD=Q131138\|reasonator=1}}`	Jokery [Wikidata; Reasonator]
`{{ill\|Jokery\|reasonator=1}}`	Jokery [Reasonator search]

To display Wikidata link as "d", add any value for the parameter |short= or its alias, |s=:

{{ill|Jokery|wd=

Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.Q131138|s= Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.1|v= Error: The retired template {{Template:Interlanguage link}} has been transcluded; see mw:Help:Magic words#Other for details. To fix this, use only the code {{=}} to generate the = character.sup}} produces: Jokery^[d]

Automatic removal

If you create an {{interlanguage link}} and an English Wikipedia article is later created, this template will appear as a regular (blue) link as explained above. The underlying template, however, will eventually be edited automatically (it is one of the tasks assigned to bot Cewbot), removing the template and resulting in a regular (blue) link. While this is intended to save on the computational load, it does mean users will not again be directed to the foreign-language article if the article is later deleted as this information is lost. The link will become a red link. Use |preserve= or |display= to prevent automatic removal.^[a]

Examples

{{ill|TC Matic|af|TC Matic|nl|TC Matic|fr|TC Matic|es|TC Matic}} produces: TC Matic [af; nl; fr; es], because TC Matic exists here
{{ill|TC Matic (band)|af|TC Matic|nl|TC Matic|fr|TC Matic|es|TC Matic}} produces: TC Matic (band) [af; nl; fr; es], because TC Matic (band) does not exist here
{{ill|TC Matic (band)|af||nl||fr||es|}} produces: TC Matic (band) [af; nl; fr; es] – although shown in blue the interwiki links won't work because they default to the title "TC Matic (band)" which is wrong
{{ill|TC Matic (band)|lt=TC Matic|af|TC Matic|nl|TC Matic|fr|TC Matic|es|TC Matic}} produces: TC Matic [af; nl; fr; es] – the text "TC Matic" now redlinks to "TC Matic (band)"
{{ill|TC Matic|lt=TC Matic (band)|af|TC Matic|nl|TC Matic|fr|TC Matic|es|TC Matic}} produces: TC Matic (band) [af; nl; fr; es] – the text "TC Matic (band)" now links to "TC Matic" which exists

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Interlanguage link in articles based on its TemplateData.

TemplateData for Interlanguage link

Link to other Wikipedias or Wikidata if an article in the English Wikipedia doesn't exist.

Template parameters
Parameter		Description	Type	Status
Article name	`1`	Name of the English Wikipedia page, or suggested name if the page does not exist	Page name	required
Link text	`lt`	Text displayed for the link to the English Wikipedia article, if not the same as the article title Default English Wikipedia article title	Line	suggested
1st language code	`2`	Language code for the 1st page in another language	Line	suggested
1st page	`3`	Title of the page in the 1st other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	suggested
2nd language code	`4`	Language code for the 2nd page in another language	Line	optional
2nd page	`5`	Title of the page in the 2nd other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
3rd language code	`6`	Language code for the 3rd page in another language	Line	optional
3rd page	`7`	Title of the page in the 3rd other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
4th language code	`8`	Language code for the 4th page in another language	Line	optional
4th page	`9`	Title of the page in the 4th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
5th language code	`10`	Language code for the 5th page in another language	Line	optional
5th page	`11`	Title of the page in the 5th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
6th language code	`12`	Language code for the 6th page in another language	Line	optional
6th page	`13`	Title of the page in the 6th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
7th language code	`14`	Language code for the 7th page in another language	Line	optional
7th page	`15`	Title of the page in the 7th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
8th language code	`16`	Language code for the 8th page in another language	Line	optional
8th page	`17`	Title of the page in the 8th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
9th language code	`18`	Language code for the 9th page in another language	Line	optional
9th page	`19`	Title of the page in the 9th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
10th language code	`20`	Language code for the 10th page in another language	Line	optional
10th page	`21`	Title of the page in the 10th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
11th language code	`22`	Language code for the 11th page in another language	Line	optional
11th page	`23`	Title of the page in the 11th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
12th language code	`24`	Language code for the 12th page in another language	Line	optional
12th page	`25`	Title of the page in the 12th other language, if not the same as the English Wikipedia page Default English Wikipedia article title	Line	optional
Wikidata item	`WD` `wd`	Wikidata item of the article. Replaces links to pages in other languages	Line	suggested
Short WD link text	`short` `s`	If anything is set for this, Wikidata item link is displayed as 'd'	String	optional
Reasonator	`reasonator`	If anything is set for this, there is a link to the Reasonator page for the Wikidata item (if there is a link to an item) or to a Reasonator search for the English Wikipedia article title (if there is no item link)	String	optional
Preserve	`preserve` `display`	If anything is set for this, forces links to pages in other languages and projects to always display even if the English Wikipedia article exists	String	optional
No bold (or italic)	`nobold`	Forces links to other-language pages, Wikidata and Reasonator and the link brackets to have non-bold or -italic text	String	optional
Italicize	`italic` `italics`	If anything is set for this, puts italicization markup around the text to be linked, without including the bracketed inter-language links within the italics	String	optional
Vertical alignment	`vertical-align` `valign` `v`	Alters the position of language links from baseline, to superscript ('sup') or subscript ('sub') position, or prevents the font size of the language links from being reduced when used in infoboxes ('ib') Default baseline	String	optional
Quote	`quote` `quotes`	If anything is set for this, puts double quotation marks around the text to be linked, without linking those marks and without including the bracketed inter-language links within them	String	optional

Tracking categories

Redirects

After a merge discussion, five other templates were merged into this template, and thus this template contains all of their features.

Notes

^ ^a ^b ^c ^d Use |preserve= or its alias |display= to show the language links even if the English Wikipedia page exists. Using either parameter also eliminates the expensive parser function call. Cewbot will NOT convert this template into a regular link if either parameter is set. Cewbot will also not convert this template into a regular link if the English Wikipedia page exists but is a redirect back to the same page where the template appears.
^ Discussed in 2022.

The above documentation is transcluded from Template:Interlanguage link/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.

[preserve-1] Use |preserve= or its alias |display= to show the language links even if the English Wikipedia page exists. Using either parameter also eliminates the expensive parser function call. Cewbot will NOT convert this template into a regular link if either parameter is set. Cewbot will also not convert this template into a regular link if the English Wikipedia page exists but is a redirect back to the same page where the template appears.

[2] Discussed in 2022.

[a]

[b]

@@ Line 1: / Line 1: @@
-<includeonly>{{safesubst:#if:{{{quote|}}}{{{quotes|}}}|"}}{{safesubst:#if:{{{italic|}}}{{{italics|}}}|''}}[[{{{1}}}{{safesubst:#if:{{{lt|}}}|{{safesubst:!}}{{{lt}}}}}]]{{safesubst:#if:{{{italic|}}}{{{italics|}}}|''}}{{safesubst:#if:{{{quote|}}}{{{quotes|}}}|"}}{{safesubst:#ifeq:{{subst:Substcheck}}|SUBST||<!--
+<includeonly>{{safesubst:#if:{{{quote|}}}{{{quotes|}}}|"}}{{safesubst:#if:{{{italic|}}}{{{italics|}}}|''}}[[{{{1}}}{{safesubst:#if:{{{lt|}}}|{{safesubst:!}}{{{lt}}}}}]]{{safesubst:#if:{{{italic|}}}{{{italics|}}}|&#8202;''}}{{safesubst:#if:{{{quote|}}}{{{quotes|}}}|"}}{{safesubst:#ifeq:{{subst:Substcheck}}|SUBST||<!--
 -->{{#if:{{#if:{{{preserve|{{{display|}}}}}}|1|{{#ifexist:{{{1|}}}|{{#invoke:redirect|isRedirect|{{{1|}}}}}|1}}}}<!--
 -->
   |<{{#switch:{{{vertical-align|{{{valign|{{{v|}}}}}}}}}|sup|super=sup|sub=sub|span}} class="noprint" style="{{#switch:{{{vertical-align|{{{valign|{{{v|}}}}}}}}}|ib|font-size:100%;|sup|super|sub=|font-size:85%;}} font-style: normal; {{#if:{{{nobold|}}}|font-weight: normal;}}">&nbsp;&#91;{{#if:{{{WD|{{{wd|}}}}}}
    | [[d:Special:EntityPage/{{{WD|{{{wd}}}}}}#sitelinks-wikipedia|<span title="&quot;{{{1}}}&quot; in other languages">{{#if:{{{short|{{{s|}}}}}}|d|Wikidata}}</span>]]<!--
-  -->{{main other||{{#if:{{{reasonator|}}}|<nowiki />; [//tools.wmflabs.org/reasonator/?q={{urlencode:{{{WD|{{{wd}}}}}}}} Reasonator]}}}}
+  -->{{main other||{{#if:{{{reasonator|}}}|<nowiki />; [https://tools.wmflabs.org/reasonator/?q={{urlencode:{{{WD|{{{wd}}}}}}}} Reasonator]}}}}
    | {{Separated entries|separator=;&#32;
      | {{#if:{{{2|}}}|[[:{{{2}}}:{{#if:{{{3|}}}|{{{3}}}|{{{1}}}}}|{{{2}}}]]}}
@@ Line 20: / Line 20: @@
        | {{#if:{{{24|}}}|[[:{{{24}}}:{{#if:{{{25|}}}|{{{25}}}|{{{1}}}}}|{{{24}}}]]}}
        }}}}
-     | {{#if:{{{reasonator|}}}|[//tools.wmflabs.org/reasonator/test/?find={{urlencode:{{{1}}}}} Reasonator search]}}
+     | {{#if:{{{reasonator|}}}|[https://tools.wmflabs.org/reasonator/test/?find={{urlencode:{{{1}}}}} Reasonator search]}}
      }}}}&#93;</{{#switch:{{{vertical-align|{{{valign|{{{v|}}}}}}}}}|sup|super=sup|sub=sub|span}}>
   | [[Category:Interlanguage link template existing link]]<nowiki />

Navigation menu

Personal tools

Search

The Goon Show Depository

Navigation

Tools

Namespaces

Views