View source for Safer Nicotine Wiki:Piped link

{{About||the use of piping on disambiguation pages|Wikipedia:Manual of Style/Disambiguation pages#Piping and redirects|the pipe trick in links (such as <nowiki>[[Wikipedia:Example|]]</nowiki>|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 [[WP:Links|link]] that displays text that is different from the title of the page to which the text links. It is created with [[WP:Wikitext|wikitext]] that results in [[hyperlink|hyperlinked]] (underlined, clickable) text. For example, the wikitext <code><nowiki>[[train station|station]]</nowiki></code> displays as [[train station|station]] but links to the Wikipedia article about [[train station]]s.

[[WP:Manual of Style/Disambiguation pages#Piping and redirects|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:
#the wording of the exact link title does not fit in context, or
#there are multiple meanings of the word (see "[[Mercury]]" example on the [[WP:Disambiguation|Disambiguation]] page).

To create the pipe ("'''|'''") character (also known as a [[vertical bar]]), you may press ({{key top|Shift}} + {{key top|Backslash}}) on English-layout keyboards. On Spanish keyboards, the pipe character can be obtained by pressing ({{key top|AltGr}}+{{key top|1}}). More simply, note that the pipe character is the third character that appears in the "wiki markup" section of symbols at the bottom of the symbol page that appears in "edit this page" mode. 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}}<!-- for quick access via [[WP:PIPE#NOT]] -->
{{Redirect|WP:NOPIPE|the Manual of Style guideline|MOS:NOPIPE}}
First of all, keep links as simple as possible:

*Avoid making links longer than necessary:
{{block indent|
{{xmark|15}} <code>{{!mxt|<nowiki>[[George Washington|President George Washington]]</nowiki>}}</code>

{{tick|15}} <code>{{mxt|<nowiki>President [[George Washington]]</nowiki>}}</code>
}}
*It is generally not good practice to pipe links simply [[Wikipedia:Redirect#Do not "fix" links to redirects that are not broken|to avoid redirects]]:
{{block indent|
{{xmark|15}} <code>{{!mxt|<nowiki>[[Wolfgang Amadeus Mozart|Mozart]]</nowiki>}}</code>

{{tick|15}} <code>{{mxt|<nowiki>[[Mozart]]</nowiki>}}</code>
}}
:Unnecessary piping makes the [[Help:Wikitext|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: <code><nowiki>[[Leningrad]]</nowiki></code> 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 <code><nowiki>[[Leningrad]]</nowiki></code> will automatically point to the correct article, while the unnecessarily piped ones <code><nowiki>[[Saint Petersburg|Leningrad]]</nowiki></code> will not.
*Given the option to pipe a link or to "blend" an [[affix]], preferred style is to use a blended affix:
{{block indent|
{{xmark|15}} <code>{{!mxt|<nowiki>[[public transport|public transportation]]</nowiki>}}</code>

{{tick|15}} <code>{{mxt|<nowiki>[[public transport]]ation</nowiki>}}</code>
}}
*Never use piped links to convert the first letter to lower case:
{{block indent|
{{xmark|15}} <code>{{!mxt|<nowiki>[[Public transport|public transport]]</nowiki>}}</code>

{{tick|15}} <code>{{mxt|<nowiki>[[public transport]]</nowiki>}}</code>
}}
:Both display identically as [[public transport]]. The first letter of a page title (after the namespace prefix) is never case-sensitive.

{{Anchor|EGG}} <!-- Please keep the span tag *above* the header, as it allows the shortcut to work properly -->

==Transparency==
{{redirect|WP:EASTEREGG|text=You may also be looking for [[MOS:EGG]]}}
{{Anchor|Intuitiveness}}
[[File:Adventkalender AR.jpg|thumb|200px|Wikipedia is not an [[Advent calendar]], so don't tease the reader.]]
{{Shortcut|WP:EASTEREGG|WP:EASTER|WP:RICKROLL}}
Keep piped links as transparent as possible. Do not use piped links to create "[[Easter egg (media)|Easter egg]]" links that require the reader to open them before understanding what's going on. Wikipedia is not an [[Advent calendar]]. Also remember there are people who print the articles. For example, do not write this:
:{{!xt|...and by mid-century the puns and sexual humor were (with only a few <nowiki>[[Thomas Bowdler|exceptions]]</nowiki>) back in to stay.}}
The readers will not see the hidden reference to [[Thomas Bowdler]] unless they click or hover over the piped [[Thomas Bowdler|exceptions]] link. In a print version, there is no link to select, and the reference is lost. Instead, reference the article explicitly:
:{{xt|...and by mid-century the puns and sexual humor were (with only a few exceptions, such as <nowiki>[[Thomas Bowdler]]</nowiki>) back in to stay.}}

Similarly, instead of:
:{{!xt|After an [[1944 Bombay explosion|earlier disaster]]...}}
consider:
:{{xt|After an earlier disaster, the [[1944 Bombay explosion]], ...}}
or simply:
:{{xt|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.

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 [[Pontiac's Rebellion#Origins|confederation]] of elements of Native American tribes}}
looks like a link to the article [[Confederation]]. At a minimum, link something that wouldn't be the title of an article under [[WP:Article titles|our article title conventions]]:
:{{xt|a war launched in 1763 by a [[Pontiac's Rebellion#Origins|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 hidden in links:
:{{!xt|The pure and strong young [[breeding true|"Trueman"]] (so named for the lack of mutations in his [[DNA]]) Feric Jaggar returns from the outlands of [[Austria|Borgravia]] where his family was exiled by the [[Treaty of Versailles|Treaty of Karmak]] with the [[Allies of World War I|surrounding mutant states]] to his ancestral land of [[Germany|Helder]] ("the High Republic of Heldon"; founded on the principles of killing mutants and keeping humanity pure), only to find its rigor slackened and corrupted by the "[[Marxism|Universalists]]", pawns of the sinister Dominator country [[Soviet Union|Zind]], which seeks to corrupt Helder's pure human gene pool into the mutant diversity that rules the rest of the world.}}
Such interpretation, if [[WP:Citing sources|properly sourced]], should be placed in its own section and citations provided. If the interpretation is purely that of the editor, it is [[WP:No original research|original research]] and should be removed.

==Piped category links==
{{Main|WP:SORTKEY}}
In the case of a [[WP:Categorization|category]] link, a piped link overrides the alphabetical sort order of the article, as shown on the linked category page.

For example, in a hypothetical new article [[Albert Einstein]], using <code><nowiki>[[Category:Theoretical physicists]]</nowiki></code> places him in [[:Category:Theoretical physicists]]. That category page will list him as "Albert Einstein", but it will list him among the "A"s, instead of the "E"s (where he belongs), because it sorts on the article's name, "Albert Einstein".

One way to impose correct sort order is to use <code><nowiki>[[Category:Theoretical physicists|Einstein, Albert]]</nowiki></code>, which makes that category page list "Albert Einstein" among the "E"s (between "Martin B. Einhorn" and "Leonard Eisenbud"), by sorting it ''as if'' it were "Einstein, Albert" rather than "Albert Einstein".

However, the ''actual'' [[Albert Einstein]] page has 83 category links. Piping every category link would be unattractive. As is standard for most "person" pages, that page uses <code><nowiki>{{DEFAULTSORT:Einstein, Albert}}</nowiki></code> to override the default sorting for category links. On that page, <code><nowiki>[[Category:Theoretical physicists]]</nowiki></code> places him in [[:Category:Theoretical physicists]] as "Albert Einstein", ''and'' makes that category page sort him as "Einstein, Albert", without need of a piped link, and likewise for 81 other category links. That page uses one piped category link, <code><nowiki>[[Category:Einstein family|Albert]]</nowiki></code>, to place him in [[:Category:Einstein family]] and make (only) that category alphabetize him under "Albert".

==Templates==
The pipe character is also used when supplying parameters to [[Help:Template|templates]]; this is not the same thing as a piped link.

==See also==
*[[Help:Pipe trick]]
*[[Help:Link]]
*[[Help:Editing]]
*[[Wikipedia:FAQ/Editing#How do I make links?|Editing FAQ: How do I make links?]]
*{{tl|Pipe}}

{{Wikipedia help pages}}
[[Category:Wikipedia how-to|{{PAGENAME}}]]
[[Category:Wikipedia link help]]