Michael_Aivaliotis: /* See also */

2007-09-30T05:27:35Z

MichaelAivaliotis: New page: A '''piped link''' is an internal link where the link target and link label are both specified. This is needed in the case that they are not equal, while also the link label ...

2007-09-26T07:48:30Z

New page: A '''piped link''' is an internal link where the link target and link label are both specified. This is needed in the case that they are not equal, while also the link label ...

New page

A '''piped link''' is an internal [[Help:Link|link]] where the link target and link label are both specified. This is needed in the case that they are not equal, while also the link label is not equal to the link target with the last word extended. This allows linking a word or phrase within the text of a page rather than using "see also", even if the wording does not exactly correspond with the name of the target page. With a suitable browser and depending on the [[Help:Preferences|preferences]] set, one can still see the link target: when you point at the link, the name shows up in a hover box and is also shown in the status bar.

For instance:

<pre><nowiki>[[recursion|Everything you always wanted to know about recursion]]</nowiki></pre>
will show: [[recursion|Everything you always wanted to know about recursion]]

Another example would be <nowiki>[[machine vision|vision]]</nowiki> rendering as [[machine vision|vision]]. This is useful where the word "vision" is used in an article on imaging; from the context, it would be clear that machine vision is meant. The piped link is more convenient to the user than a link to [[vision]] which might be a disambiguation page.

The term ''piped'' refers to the use of the pipe character "|" used to separate the good description from the actual link. This character is named after an alternative use of it; see [http://en.wikipedia.org/wiki/Pipe_%28computing%29 Pipe Computing].

==Using a redirect as an alternative==
An alternative is simply using [[Help:Redirect|redirect pages]]. To create [[Everything you always wanted to know about recursion]], use <nowiki>[[Everything you always wanted to know about recursion]]</nowiki> and make this a redirect to [[recursion]] (note that, unlike above, what pops up when you point at the link, if applicable for your browser, is simply the text already shown).

This is convenient if the redirect is already there or will also be of use elsewhere; however, there are a few drawbacks:

*the popup does not show the page one will arrive at
*"Related changes" gives the changes in the ''redirect page'' not the redirect target
*the redirect message on the target page slightly clutters it

Combining a piped link and a redirect, one can provide some information that is not the name of the page one links to in the hover box, such as the value of a unit in terms of other units. In that case one can make a page whose pagename is the info one wants in the link title, and which redirects to a page with a more appropriate name.

==Automatic conversion of the wikitext==
===Pipe trick===
If in a piped link the part after the "|" is left empty, it is converted to an abbreviated form of the page name on the left, as follows:

#any word before the first colon ":", as well as the colon itself, is removed. This word may or may not be a namespace prefix (such as "Help:") or an interwiki prefix (such as "commons:"). If the page name is preceded by a colon, "first" refers to "first after this".
#if there is text in parentheses at the end it will be removed
#if there are no parentheses but there is a comma, the comma and everything after it is removed

Just like for the three or four tildes when signing on Talk pages and the use of subst, in a preview, the result already shows up in the preview itself, but the conversion in the edit box is not yet shown. Press "Show changes" to see the change in the wikitext.

====Examples====

* <nowiki>[[Help:Template|]]</nowiki> is converted to <nowiki>[[Help:Template|Template]]</nowiki>, which is rendered as [[Help:Template|Template]]
* <nowiki>[[Music: My life|]]</nowiki> is converted to <nowiki>[[Music: My life| My life]]</nowiki>, which is rendered as [[Music: My life| My life]] - although "Music:" is not a namespace (therefore the space after the colon is not automatically removed), the shortcut works anyway
* <nowiki>[[w:en:Pipe (computing)|]]</nowiki> is converted to <nowiki>[[w:en:Pipe (computing)|en:Pipe]]</nowiki>, which is rendered as [[w:en:Pipe (computing)|en:Pipe]]
* <nowiki>[[commons:Boston, Massachusetts|]]</nowiki> is converted to <nowiki>[[commons:Boston, Massachusetts|Boston]]</nowiki>, which is rendered as [[commons:Boston, Massachusetts|Boston]].

== Syntax for external links ==

For external links a space is used instead of a pipe character; see [[Help:Editing]].

==See also==
[[Help:Link]]

[[Category:Help|Piped link]]

← Older revision		Revision as of 05:27, 30 September 2007
Line 43:		Line 43:

	==See also==		==See also==
	[[Help:Link]]		*[[Help:Link\|Links]]

	[[Category:Help\|Piped link]]		[[Category:Help\|Piped link]]

Help:Piped link - Revision history

Michael_Aivaliotis: /* See also */

MichaelAivaliotis: New page: A '''piped link''' is an internal link where the link target and link label are both specified. This is needed in the case that they are not equal, while also the link label ...