X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/67bfc9a30b5e62e63a189b5a9abccab382e7d22e..96c278d394a8c723cac1472dc3d509a0b9cc2a33:/doc/wikilink.mdwn diff --git a/doc/wikilink.mdwn b/doc/wikilink.mdwn index 5d454fb3f..301f71a7f 100644 --- a/doc/wikilink.mdwn +++ b/doc/wikilink.mdwn @@ -1,21 +1,26 @@ -foo! - WikiLinks provide easy linking between pages of the wiki. To create a [[WikiLink]], just put the name of the page to link to in double brackets. -For example "\[[WikiLink]]". - -If you ever need to write something like "\[[WikiLink]] without creating a -wikilink, just prefix it with a "\", like "\\\\[[WikiLink]]". +For example `\[[WikiLink]]`. -Note that there are some special [[SubPage/LinkingRules]] that come into -play when linking between [[SubPage]]s. +If you ever need to write something like `\[[WikiLink]]` without creating a +wikilink, just prefix it with a `\`, like `\\[[WikiLink]]`. -WikiLinks can be entered in any case you like, the page they link to is -always lowercased. +There are some special [[SubPage/LinkingRules]] that come into play when +linking between [[SubPages|SubPage]]. -Note that if the file linked to by a WikiLink looks like an image, it will +Also, if the file linked to by a WikiLink looks like an image, it will be displayed inline on the page. +WikiLinks are matched with page names in a case-insensitive manner, so you +don't need to worry about getting the case the same, and can capitalise +links at the start of a sentence, and so on. + It's also possible to write a WikiLink that uses something other than the -page name as the link text. For example "\[[foo|SandBox]]" links to the -SandBox page, but the link will appear like this: [[foo|SandBox]] +page name as the link text. For example `\[[foo_bar|SandBox]]` links to the +SandBox page, but the link will appear like this: [[foo_bar|SandBox]] + +To link to an anchor inside a page, you can use something like +`\[[WikiLink#foo]]` + +**Note that you cannot use spaces in WikiLinks**. Replace spaces with +underscores.