Difference between revisions of "Help:Links"

Latest revision as of 07:20, 27 November 2017

<languages/> Template:TNT <translate> There are five types of hypertext links in MediaWiki:

[[<tvar|internal>#Internal links</>|Internal links]] to other pages in the same wiki (commonly called "wikilinks")
[[<tvar|external>#External links</>|External links]] to pages at other websites
[[<tvar|external2>#External links to internal pages</>|External links to internal pages]] in the same wiki
[[<tvar|interwiki>#Interwiki links</>|Interwiki links]] to other websites using special prefixes registered in advance
[[<tvar|interlang>#Interlanguage links</>|Interlanguage links]] to other wikis registered as different language versions of the current wiki</translate>

<translate> Please note that this list does not include [[<tvar|h-cat>Special:MyLanguage/Help:Categories</>|category links]] and [[<tvar|h-img>Special:MyLanguage/Help:Images</>|file links]], which are used to place pages into categories and display images or other media files, respectively. </translate>

Internal links[edit]

To Template:Ll a so-called internal link to a page on the same wiki (a "wikilink"), use double square brackets wiki markup, [[like this]]. When you preview or save your changes, you will see a link that can be followed to the target page. If the page exists the link is displayed in blue (like the word "create" in the first sentence of this paragraph); if the page does not exist, the link appears red (so the [[like this]] link is actually rendered like this). Note that the colors could be different if the color scheme of the wiki has been changed from the default. Following such a "redlink" to a missing page (whether or not it is actually red) will usually enable the user to create the page.

To markup any arbitrary string of text (not necessarily a page title) as a link, use a "vertical bar" or "pipe" character, like this: [[Help:Categories|category links]] results in the link category links.

The first letter of the link target is usually case-insensitive (unless the wiki is configured otherwise), meaning links can be capitalized or not (so How to contribute and how to contribute are equivalent). However, the case of every subsequent letter must match the target page exactly (so How to contribute and How To Contribute are not equivalent). Spaces in the page title may be represented as underscores (so How to contribute and How_to_contribute are again equivalent), but using underscores in links is typically frowned upon since they will be visible in the page text (but this can be prevented by using a "pipe").

If the page title you are linking to is that of the page you are editing, the result is not a hyperlink at all but simply bold text (for example, on this page the markup [[Help:Links]] gives the result Help:Links). If you're trying to create a wikilink to the current page, you probably want to link to a specific section or to an anchor within the page; see the examples below.

MediaWiki uses the Template:Ll to keep track of internal wikilinks. </translate>

<translate> Description</translate>	<translate> You type</translate>	<translate> You get</translate>
<translate> Internal link</translate>	[[Main Page]] [[Help:Contents]] [[Extension:DynamicPageList (Wikimedia)]]	Main Page Help:Contents Extension:DynamicPageList (Wikimedia)
<translate> Piped link</translate>	[[Help:Editing pages\|editing help]] [[Help:Editing pages#Preview\|previewing]] <translate> See also [[<tvar\|meta>meta:Special:MyLanguage/Help:Piped link</>\|meta:Help:Piped link]]. The second example links to a section (or anchor) within the target page.</translate>	editing help previewing
Pipe trick	[[Manual:Extensions\|]] [[User:John Doe\|]] [[Extension:DynamicPageList (Wikimedia)\|]] [[Extension:DynamicPageList (third-party)\|]] <translate> The pipe trick involves less typing for editors, but is potentially confusing to readers, as seen in these DynamicPageList examples.</translate>	Extensions John Doe DynamicPageList DynamicPageList
<translate> Word-ending links</translate>	[[Help]]s [[Help]]ing [[Help]]ers [[Help]]almostanylettersyoulikehere [[Help]]BUTnotalways <translate> Follows so-called "linktrail rules" [[<tvar\|loc>Special:MyLanguage/Localisation</>\|localised]] per [[<tvar\|msgxx>Special:MyLanguage/MessagesXx.php</>\|each language]].</translate>	Helps Helping Helpers Helpalmostanylettersyoulikehere HelpBUTnotalways
<translate> Avoiding word-ending links</translate>	[[Help]]<nowiki />ful advice [[wikipedia:GNU General Public License\|GPL]]<nowiki />v3	Helpful advice GPLv3
<translate> Redirect</translate>	#REDIRECT [[Main Page]] <translate> Should be the first and only line on the page. See [[<tvar\|redirects>Special:MyLanguage/Help:Redirects</>\|Help:Redirects]].</translate>	File:Redirect arrow without text (cropped).svg Main Page
<translate> Link to an anchor on the same page</translate>	[[#See also]] <translate> Anchors are provided automatically on [[<tvar\|formatting>Special:MyLanguage/Help:Formatting</>\|section headings]] and to the top of the page.</translate>	#See also
<translate> Piped link to an anchor on the same page</translate>	[[#See also\|different text]]	different text
<translate> Setting an anchor for incoming links</translate>	<div id="Unique anchor name 1">optional text</div> <span id="Unique anchor name 2">optional text</span> <translate> Rendered block-level and inline, respectively. Doing this would allow for `[[#Unique anchor name 1]]` on the same page or `[[Help:Links#Unique anchor name 1]]` on a different page. Omit the "optional text" for an invisible anchor. </translate>	<div id="<translate> Unique anchor name 1</translate>"><translate> optional text</translate></div> <span id="<translate> Unique anchor name 2</translate>"><translate> optional text</translate></span>
<translate> Setting an anchor in a section heading</translate>	==<span id="Alternate Section Title"></span>Section heading== <translate> Note the placement. This must be a "span" tag, not a "div". (Such anchors allow sections to be retitled without breaking incoming links.)</translate>	Section heading
<translate> Link to an anchor at another page</translate>	[[Help:Images#Supported media types for images]]	Help:Images#Supported media types for images
<translate> Link to the current page's talk page</translate>	[[{{TALKPAGENAME}}\|Discussion]] <translate> See also [[<tvar\|page-names>Special:MyLanguage/Help:Magic_words#Page_names</>\|Help:Magic words#Page names]]</translate>	Discussion
<translate> Link to a subpage</translate>	[[/example]] <translate> Shortcut for `[[Help:Links/example\|/example]]`. See also [[<tvar\|subpages>Special:MyLanguage/Help:Subpages</>\|Help:Subpages]].</translate>	/example
<translate> Link to a subpage without the leading slash</translate>	[[/example/]] <translate> Shortcut for <tvar\|code>`[[Help:Links/example\|example]]`</>.</translate>	example
<translate> Visible link to a category page</translate>	[[:Category:Help]] <translate> Without the leading colon the link would not be visible and the page would instead be placed into the category; this is a very common mistake. See also [[<tvar\|cat>Special:MyLanguage/Help:Categories</>\|Help:Categories]].</translate>	Category:Help
<translate> Visible link to an image or media file</translate>	[[:File:example.jpg]] [[:File:example.jpg\|this example]] [[media:example.jpg]] <translate> Without the leading colon on the "File:" examples, the images would actually be displayed. See also <tvar\|h-img>Template:Ll</>. Note that using the "media:" prefix links directly to the uploaded file.</translate>	File:example.jpg this example media:example.jpg
<translate> Link to a page specific to each reader (user page, etc.)</translate>	[[Special:MyPage]] [[Special:MyTalk]] [[Special:Preferences]]	Special:MyPage Special:MyTalk Special:Preferences
<translate> Internal link to a specific revision</translate>	[[Special:PermanentLink/2393992]] <translate> Revision numbers can be found in each page's [[<tvar\|h-hist>Special:MyLanguage/Help:History</>\|edit history]]. (It is very common to see links to specific revisions implemented as external links because it's easy to cut-and-paste an entire URL to form an external link.)</translate>	Special:PermanentLink/2393992
<translate> Internal link to a "diff"</translate>	[[Special:Diff/2393992]] [[Special:Diff/2390639/2393992]] <translate> The default (in the first example above) is to show the changes from the previous revision. See also the comments in the previous item.</translate>	Special:Diff/2393992 Special:Diff/2390639/2393992