Help:Linking

From Valve Developer Community
Jump to: navigation, search
Help:Editing

Links (sometimes called hyperlinks) are all over the web. You probably followed one to find this page.


To add a link to another wiki page, type [[, then the page name, then ]].

[[Main Page]]

Main Page


If you want to link to the page but don't want to type in the exact name of the page, add a | between the page name and the ]], and then write what you want the text to be.

[[Help Talk:Contents|The discussion page]]

The discussion page


To link to a page on Wikipedia, add Wikipedia: to your page name.

[[Wikipedia:Half-Life 2|Half-Life 2 on Wikipedia]]

Half-Life 2 on Wikipedia

There are other websites you can link to as well. See here for a full list.


To link to somewhere outside of the wiki, type [, then the URL, followed by a space, the text you want to describe the link, and then ].

[https://www.google.com/ External link to Google]

External link to Google


You can also just directly paste in a URL, but it doesn't look as nice

https://www.google.com/

A URL pointing to an image will display that image on a page. It won't have the best formatting however. Exercise caution when doing this and note that images from another website may change or disappear at any time.

The template we call ent is convenient for when you want to make text both a link and code at once.

Tip:You normally only need to link a term the first time it is mentioned in an article, but if the separate mentions are far apart you might want to link it more than once. Furthermore, consider your audience; you probably don't need to link to Source on a page about programming.

Red (broken) links

It's O.K. to link to a non-existent page! We would prefer that you then created that page, if you know about it. What we don't want is a page that's just "todo: make this page".

If you've created a page and pre-existing links to it still show as red, add ?action=purge to the end of the URLs to update their link colors. You can also do this by pressing the Edit button on the pages and saving them without changing anything.

Note:Broken links are only detected for wiki pages, not external or Wikipedia links.

Link Colors

Type of Link Before Visiting After Visiting
Wiki pages and external links #8BB9E0 #002BB8
Inter-wiki links #36B #551A8B
Broken links #D64B4B #BA0000

Links that link to their own pages (excluding ones redirecting to other sections) will appear to be bold.

See Also