authors (basic) A key feature of WikiWikiWebs is the ease of creating links in the text of a document. Pm Wiki provides multiple mechanisms for creating such links.
To create a link to another page, simply enclose the name of the page inside double square brackets, as in [[wiki sandbox]]
or [[installation]]
. These result in links to wiki sandbox and installation, respectively.
Pm Wiki creates a link by using the text inside the double brackets. It does this by removing spaces between words, and automatically capitalizing words following spaces or other punctuation (like ~). Thus [[Wiki sandbox]]
, [[wiki sandbox]]
, and [[WikiSandbox]]
all display differently but create the same link to the page titled Wiki Sandbox.
In other words, Pm Wiki will automatically create the link path name using title case as a rule, but link text will display in the format you have entered it.
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 Wiki Sandbox but displays as wiki sandboxes.
Link text in (parentheses) will not be not displayed, so that [[(wiki) sandbox]]
links to Wiki Sandbox and displays as sandbox.
Finally, you can specify the link text via a vertical brace, thus [[WikiSandbox | a play area]]
, which links to Wiki Sandbox 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).
Some sites also recognize WikiWord? links, in which a Wiki Word? appearing in the text is automatically treated as a link to a page of the same name.
[[PageName|+]]
creates a link to Page Name? 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 Page Name? in the group called Category.
[[~Author]]
link creates a link to the page in the page called Author in the Profiles group. Pm Wiki 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]]
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/
and [[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 Pm Wiki page:
Formatting the link as: [[http://google.com |#]]
produces: [1] 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 [2], [[#intermaps |#]]
produces [3], and so on for further reference links.
Inter Map? links are also supported (see InterMap?). In particular, the Path:
Inter Map? entry can be used to create links using relative or absolute paths on the current site (e.g., Path:../../somedir/foo.html
or Path:/dir/something.gif
).
To have a link open in another window, use %newwin%
:
%newwin% http://www.pmichaud.com
produces http://www.pmichaud.com
%newwin% [[http://google.com/ | Google]]
produces Google
%newwin% Main.WikiSandbox
produces 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 http://www.pmichaud.com will open in a new window. |
Any links on this line like http://www.pmichaud.com will open in a new window. |
<< Criando novas páginas | DocumentationIndex | Imagens >>
How do I put a link that will open as a new window?
Use the %newwin%
wikistyle, as in:
%newwin%http://www.example.com/ |
How do I place a mailing address in a page?
Use the mailto:
markup, as in one of the following:
mailto:myaddress@example.com [[mailto:myaddress@example.com]] [[mailto:myaddress@example.com | email me]]
See also Cookbook:EProtect for information on protecting email addresses from spammers.
How do I make a Wiki Word? link to an external page instead of a Wiki Page??
Use link markup. There are two formats:
[[http://www.example.com/ | WikiWord]] [[WikiWord -> http://www.example.com/]]
How do I find all of the pages that link to another page (i.e., backlinks)?
Use the link=
option of the (:pagelist:)
directive?, as in
(:pagelist link=SomePage:) -- show all links to SomePage (:pagelist link={$FullName}:) -- show all links to the current page