There are two fundamental linking types on MoinMoin.
Brackets ([[ ]]) are used to link to a target (a local wiki page, an external URL, a file, etc).
Braces ({{ }}) are used to embed (transclude/include/show) some target (often an image, but can be text).
Targets are very flexible in that they support virtually any style you can with regular HTML (relative or absolute paths, anchors, etc).
Linking
Properly-formed URLs (i.e. http://example.net), InterWiki pages, email addresses, and CamelCase pagenames are automatically recognized as targets even without using brackets.
Description |
Syntax |
Comment |
internal link |
WikiName |
CamelCase page name |
internal free link |
[[free link]] |
any page name |
internal link to sub page |
/SubPage or [[/sub page]] |
|
internal link to sister page |
../SisterPage or [[../SisterPage|link text]] |
|
internal link with linktext |
[[SomePage|some Page]] |
|
internal link to a section |
[[SomePage#subsection|subsection of Some Page]] |
See #Anchors section below |
internal link with linktext & parameter |
[[SomePage|some Page|target="_blank"]] |
see below for parameter configurations |
internal link using a graphic as button |
[[SomePage|{{attachment:imagefile.png}}]] |
|
internal link using graphic button, open new window |
[[SomePage|{{attachment:samplegraphic.png}}|target="_blank"]] |
|
link to attachment |
[[attachment:image.png]] |
links to attachment image |
link to attachment of another page |
[[attachment:SomePage/image.png]] |
links to image attached to a different page |
interwiki link |
Otherwiki:somepage |
requires uppercase wikiname |
interwiki free link |
[[otherwiki:somepage]] |
any wikiname in the map works |
external link |
http://example.net/ |
|
external link with linktext |
[[http://example.net/|example site]] |
|
external link with linktext, open new window |
[[http://example.net/|example site|target="_blank"]] |
see below for parameter configurations |
external link using a graphic as button |
[[http://example.net/|{{attachment:samplegraphic.png}}]] |
|
external link using graphic button, open new window |
[[http://example.net/|{{attachment:samplegraphic.png}}|target="_blank"]] |
|
border of internal link |
WikiName``s |
2 backticks - for when a WikiName ends in the middle of a word |
avoid an internal link |
!WikiName |
configurable function |
Embedding
Embedding/Transclusion is used if you want to include an external file within your wiki. Most commonly, this will be a graphic. But it can also be a text file or any other file that the wiki understands (for example, you can provide link for downloading and display the contents of that file on the page!).
see HelpOnImages for examples.
Description |
Syntax |
Comment |
embed an attached graphics |
{{attachment:image.png}} |
show attached image file image.png |
embed an attached graphics and give alt text |
{{attachment:image.png|alt text}} |
show attached image file image.png with alternative text saying alt text (recommended for accessibility) |
embed an attached graphics and define alignment |
{{attachment:image.png|alt text|align="position"}} |
show attached image file image.png with alternative text alt text and aligned to position, where position can be one of top, middle, bottom, right or left (do not omit alt text) |
embed an attached graphics and resize it |
{{attachment:image.png|alt text|width=100 height=150}} |
show attached image file image.png with alternative text alt text and resize it to 100px width and 150px high (do not omit alt text) |
embed an external graphics |
{{http://example.net/image.png}} |
show target image inline |
embed an external graphics and give alt text |
{{http://example.net/image.png|alt text}} |
show target image inline with alternative text saying alt text (recommended for accessibility) |
embed an external graphics and define alignment |
{{http://example.net/image.png|alt text|align="position"}} |
show target image inline with alternative text alt text and aligned to position, where position can be one of top, middle, bottom, right, or left (do not omit alt text) |
embed an external graphics and resize it |
{{http://example.net/image.png|alt text|width=100}} |
show target image inline with alternative text alt text and resize it to 100px width (do not omit alt text) |