To create a link to another page, simply enclose the name of the page inside double brackets, as in
[[Common People]] or
[[Television]]. These result in links to Common People and Television, respectively.
PulpWiki 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. Thus
[[Different class]], and
[[DifferentClass]] all display differently but link to the same page.
A suffix can also be added to the end of a link, which becomes part of the link text but not the target. Thus
[[wiki sandbox]]es is a link to WikiSandbox but displays as wiki sandboxes.
Link text in (parentheses) will not be not displayed, so that
[[(wiki) sandbox]] links to WikiSandbox and displays as sandbox.
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 -> WikiSandbox).
[[PageName|+]] creates a link to PageName and uses that page's title as the link text, eg
[[Links|+]] gives Links.
[[PageName|#]] creates a reference link as shown below.
[[!PageName]]creates a link to the PageName in the group called Category.
[[~Author]] link creates a link to the page in the page called Author in the Profiles group. PmWiki will automatically generate that link for the current Author when it encounters three tilde characters (
~) in a row (
~). Adding a fourth tilde (
~) appends the current date and time.
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|link text]]for a location on another page
[[PageName(#name)]]may be useful for hiding the anchor text in a link.
For example, here's a link to the Intermaps section, below.
Links to external sites simply begin with a prefix such as 'http:', 'ftp:', etc. Thus
[[http://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://google.com/ | Google]] and
[[Google -> http://google.com]].
Links may also be specifed as References, so the target appears as an anonymous numeric reference rather than a textual reference. The following markup is provided to produce sequential reference numbering within a PmWiki page:
Formatting the link as:
[[http://google.com |#]] produces: as the link.
Subsequent occurrence of the reference link format on the same page will be incremented automatically as per the following example: Entering
[[http://pmwiki.com |#]] produces ,
[[#intermaps |#]] produces #, and so on for further reference links.
To have a link open in another window, use
%newwin% [[http://google.com/ | Google]]produces %newwin%