blob: a9dd931516dd785aa0d1b26dce4daa418fa62895 [file] [log] [blame]
text=A key feature of [[WikiWikiWeb]]s 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²²First, 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 - which is titled ''`WikiSandbox''.²²In other words, when a page is created PmWiki will automatically create a [[PmWiki/WikiWord]] for its title, but links to the page will display as written.²²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 still a link to WikiSandbox but displays as [[wiki sandbox]]es. And you can put parentheses around any text you don't want to have displayed, so that [@[[(wiki) sandbox]]@] still links to WikiSandbox but displays as [[(wiki) sandbox]].²²Finally, you can specify the link text via a vertical brace, thus [@[[WikiSandbox |a play area]]@], which links to WikiSandbox but displays as [[WikiSandbox |a play area]]. Alternately, you can use an arrow ([@->@]) to reverse the order of the text and target, as in [@[[a play area -> WikiSandbox]]@] ([[a play area -> WikiSandbox]]).²²Some sites also recognize WikiWord links, in which a WikiWord appearing in the text is automatically treated as a link to a page of the same name.²²!!!Links to external sites ([=URLs=])²²Links to external sites simply begin with a prefix such as 'http:', 'ftp:', etc. Thus [@] and [@[[]]@] 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 [@[[ | Google]]@] and [@[[Google ->]]@].²²InterMap links are also supported (see [[InterMap]]).²²!!!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 will create 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²²You may find the form [@[[PageName(#name)]]@] more useful than [@[[Pagename#name]]@] as the former hides the anchor text while the latter displays it. ²²!!!Links that open a new browser window²²These are particularly useful for links to external sites where you want to keep the window to your Wiki open, allowing users to return to your site easily.²* [@%newwin%] produces this link: %newwin% ²* [@%newwin% Main.WikiSandbox@] produces this link: %newwin% Main.WikiSandbox²²You can also specify that links should open in a new window via the @@target@@ attribute:²² [=%target=_blank% Any links on this line like ² will open in a new window. =]²²which gives²²->%target=_blank% Any links on this line like will open in a new window.²²(This method is described in WikiStyles).² ²²²%trail%<<|DocumentationIndex|>>
agent=Mozilla/5.0 (Macintosh; U; PPC Mac OS X; de-de) AppleWebKit/85.8.2 (KHTML, like Gecko) Safari/85.8