• View
• Edit
• History
• Print

Links

A key feature of WikiWikiWebs is the ease of creating links to other places in the text of the document. PmWiki provides multiple mechanisms for creating such links.

Links to other pages

To create a link to another page, simply enclose the name of the page inside double brackets, as in [[wiki sandbox]] or [[installation]]. These result in links to wiki sandbox and installation, respectively.

PmWiki ignores all spaces between words when creating a link from the text inside the double brackets, and will automatically capitalize words following spaces and other punctuation (like ~). Thus [[Wiki sandbox]], [[wiki sandbox]], and [[WikiSandbox]] all display differently but link to the same page titled WikiSandbox.

In other words, when a page is created PmWiki will automatically name the page using title case, but links to the page will display as written.

Finally, you can specify the link text via a vertical brace, thus [[WikiSandbox | a play area]], which links to WikiSandbox but displays as a play area. You can use an arrow (->) to reverse the order of the text and target, as in [[a play area -> WikiSandbox]] (a play area).

Links to specific locations within a page

To define a location within a page to which you may jump directly, use the markup [[#name]]. This creates an "anchor" that uniquely identifies that location in the page. Then to have a link jump directly to that anchor, use one of

• [[#name|link text]] within the same page, or
• PageName#name or [[PageName#name|link text]] for a location on another page

The form [[PageName(#name)]] may be useful for hiding the anchor text in a link.

Links to external sites (URLs)

Links to external sites simply begin with a prefix such as 'http:', 'ftp:', etc. Thus http://www.google.com/ and [[http://www.google.com/]] both link to Google. As with the above, an author can specify the link text by using the vertical brace or arrow syntax, as in [[http://www.google.com/ | Google]] and [[Google -> http://www.google.com]].

Links that open a new browser window

To have a link open in another window, use %newwin%:

• %newwin% http://www.pmichaud.com produces http://www.pmichaud.com
• %newwin% Main.HomePage produces Main.HomePage

You can also specify that links should open in a new window via the target attribute:

%target=_blank% Any links on this line like http://www.pmichaud.com 
will open in a new window.