Wikipedia:Piped link

{{Short description|Wikipedia how-to guide}}

{{About||the use of piping on disambiguation pages|Wikipedia:Manual of Style/Disambiguation pages#Piping and redirects}}

{{About||the pipe trick in links (such as |Help:Pipe trick}}

{{See also|Wikipedia:Manual of Style/Linking#Piped links}}

{{Wikipedia how-to|WP:PIPE|WP:PIPELINK}}

{{Linking and page manipulation|Linking and diffs}}

A piped link is an internal link that displays text different from the title of the page to which the text links. It is created with wikitext (markup code) that results in hyperlinked (underlined, clickable) text. It is called "piped" because it uses the pipe character ("{{code|{{!}}}}") or vertical bar.

For example, the wikitext station displays as station but links to the Wikipedia article about train stations.

Do not confuse piped links and redirects: they are two very different mechanisms. Both allow the displayed text of a link to differ from the title of the final destination page (the page that a reader will see after clicking that link). However, a piped link conceals the destination page's title only in that single line on the single page where its wikitext is used, while on any page throughout Wikipedia any link, piped or not, to a specific redirect page will always lead to the same destination page.

Use

{{Main|Help:Piped link}}

{{see also|Wikipedia:Manual of Style/Linking#Piped links}}

Piped links are useful for preserving the grammatical structure and flow of a sentence when:

  1. the wording of the exact link title does not fit in context (see [https://en.wikipedia.org/wiki/Cetacea#:~:text=Cetaceans%20have%20been%20extensively%20hunted%20for%20their%20meat here] as an example), or
  2. there are multiple meanings of the word (see "Mercury" example on the Disambiguation page).

The pipe ("|") character is also known as a vertical bar.

There are two ways to create the pipe ("|") character: using the keyboard or choosing from a list of symbols. On English-layout keyboards, you may press {{keypress|Shift|\}}. On Spanish keyboards, the pipe character can be obtained by pressing {{keypress|AltGr|1}}. On French (AZERTY) keyboards, the pipe character can be obtained by pressing {{keypress|AltGr|6}}. Or note that, when you are in "edit this page" mode, the "pipe" appears as the third character in the "Wiki markup" section at the bottom of the page, among the list of symbols. (You may need to choose "Wiki markup" on the pull-down menu.) Clicking on the pipe symbol there inserts it at the cursor spot, just as happens for any symbol chosen from this page.

For full details on how to use this feature, see Help:Piped link.

When not to use

{{Shortcut|WP:NOPIPE|WP:NOPIPEDLINK}}

{{Anchor|NOT}}

{{Redirect|WP:NOPIPE|the Manual of Style guideline|MOS:NOPIPE|the guidance against using pipes on disambiguation pages|MOS:DABPIPE}}

First of all, keep links as simple as possible:

  • Avoid making links longer than necessary:

{{block indent|

{{xmark|15}} {{!mxt|President George Washington}}

{{tick|15}} {{mxt|President George Washington}}

}}

{{block indent|

{{xmark|15}} {{!mxt|Mozart}}

{{tick|15}} {{mxt|Mozart}}

}}

: Unnecessary piping makes the wikitext harder to read.

: Furthermore, the number of links to a redirect page can be a useful gauge of when it would be helpful to spin off a subtopic of an article into its own page, and such links would also continue to work correctly after the spin-off.

: For example: Leningrad currently redirects to Saint Petersburg, but one day it could be decided to spin off a dedicated article about the old city of Leningrad; when that happens, all existing links Leningrad will automatically point to the correct article, while the unnecessarily piped ones Leningrad will point to the wrong place.

  • Characters (up to punctuation) suffixed to a link will be "blended" as part of the displayed hyperlink, despite not being inside the double brackets, making it unnecessary to use piping only because the linked article name is only the first part of the word. Typical examples include a plural form or trailing affix. Given an option between pipe a link and "blending" a suffix, preferred style is to use a blended suffix:

{{block indent|

{{xmark|15}} {{!mxt|public transportation}}

{{tick|15}} {{mxt|public transportation}}

}}

  • In a link, the first letter of a page title (after the namespace prefix) is never case-sensitive. This means: It is not necessary to pipe a link to convert the first letter to lower case. So, never do this:

{{block indent|

{{xmark|15}} {{!mxt|public transport}}

{{tick|15}} {{mxt|public transport}}

}}

: Both correctly link to the article Public transport.

Transparency <span class="anchor" id="EGG"></span>

{{redirect|WP:EASTEREGG|text=You may also be looking for MOS:EGG}}

{{Anchor|Intuitiveness}}

{{Shortcut|WP:TRANSPARENCY|WP:EASTEREGG|WP:RICKROLL|WP:TROJANHORSE}}

File:Adventkalender AR.jpg, so don't tease the reader.]]

Keep piped links as transparent as possible and follow the principle of least astonishment. Do not use piped links to create "Easter egg" links that require the reader to open them (or, at least, to hover their mouse pointer on those links to get page previews in the form of navigation popups) before understanding where they lead. Wikipedia is not an Advent calendar.

Also remember there are people who print the articles. For example, do not write this:

{{!mxt|... and by mid-century the puns and sexual humor were (with only a few exceptions) back in to stay.}}

The readers will not see the hidden reference to Thomas Bowdler unless they click or hover over the piped exceptions link. In a print version, there is no link to select, and the reference is lost. Instead, reference the article explicitly:

{{mxt|... and by mid-century the puns and sexual humor were (with only a few exceptions, such as Thomas Bowdler) back in to stay.}}

Similarly, instead of:

{{!mxt|After an earlier disaster ...}}

consider:

{{mxt|After an earlier disaster, the 1944 Bombay explosion, ...}}

or simply:

{{mxt|After the 1944 Bombay explosion, ...}}

It will occasionally be useful to link to a fuller explanation of a phrase; when this is done, link the phrase, not a single word.

For example: If Pontiac's War is defined as having been

: a war launched in 1763 by a loose confederation of elements of Native American tribes,

and there is no space for further explanation in that context (this is a quote from the lead of the article), then some readers will value a link to a description of the confederation. This should not be linked from the word confederation; the link in the following phrase:

: {{!xt|a war launched in 1763 by a loose confederation of elements of Native American tribes}}

looks like a link to the article Confederation.

At a minimum, link something that, obviously, wouldn't be the title of an article under our article title conventions:

: {{xt|a war launched in 1763 by a loose confederation of elements of Native American tribes.}}

Further, it is inappropriate to contain veiled and uncited interpretations of fiction through piped links, as in this excerpt from the The Iron Dream article, which contained over 30 interpretations of the book's allusions hidden in links:

: {{!xt|The pure and strong young "Trueman" (so named for the lack of mutations in his DNA) Feric Jaggar returns from the outlands of Borgravia where his family was exiled by the Treaty of Karmak with the surrounding mutant states ...}}

... and in wikitext:

The pure and strong young "Trueman" (so named for the lack of mutations in his DNA) Feric Jaggar returns from the outlands of Borgravia where his family was exiled by the Treaty of Karmak with the surrounding mutant states ...

Such interpretation, if properly sourced, should be placed in its own section and citations provided. If the interpretation is purely that of the editor, it is original research and should be removed.

Templates

The pipe character is also used when supplying parameters to templates; this is not the same thing as a piped link.

Some templates automatically add link formatting, [https://en.wikipedia.org/w/index.php?title=Grammy_Awards&oldid=1276967913 as seen here] with the previous_awards field. Those automatic links won't work with the normal piped links, so for them instead of a normal pipe you should use these five characters: {{t|!}} to call the Template:!, [https://en.wikipedia.org/w/index.php?title=Robin_Boyd_Award&oldid=1203220725 as seen here] with the current_awards field.

See also