summaryrefslogtreecommitdiff
path: root/ikiwiki/subpage
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2008-01-20 21:06:27 +0100
committerJonas Smedegaard <dr@jones.dk>2008-01-20 21:06:27 +0100
commit34726343bc67e29c1776d845910d0574a43116c2 (patch)
treed00495d56711adfc9fa7e6245bdf93b9577f0d21 /ikiwiki/subpage
parentfc77a881a640719ae7effabb96ca310d5c94fa55 (diff)
Sync with ikiwiki 2.20 part I: Move a bunch of pages to ikiwiki/ subsir.
Diffstat (limited to 'ikiwiki/subpage')
-rw-r--r--ikiwiki/subpage/linkingrules.mdwn32
1 files changed, 32 insertions, 0 deletions
diff --git a/ikiwiki/subpage/linkingrules.mdwn b/ikiwiki/subpage/linkingrules.mdwn
new file mode 100644
index 0000000..c106230
--- /dev/null
+++ b/ikiwiki/subpage/linkingrules.mdwn
@@ -0,0 +1,32 @@
+To link to or from a [[SubPage]], you can normally use a regular
+[[WikiLink]] that does not contain the name of the parent directory of
+the [[SubPage]]. Ikiwiki descends the directory hierarchy looking for a
+page that matches your link.
+
+For example, if FooBar/SubPage links to "OtherPage", ikiwiki will first
+prefer pointing the link to FooBar/SubPage/OtherPage if it exists, next
+to FooBar/OtherPage and finally to OtherPage in the root of the wiki.
+
+Note that this means that if a link on FooBar/SomePage to "OtherPage"
+currently links to OtherPage, in the root of the wiki, and FooBar/OtherPage
+is created, the link will _change_ to point to FooBar/OtherPage. On the
+other hand, a link from BazBar to "OtherPage" would be unchanged by this
+creation of a [[SubPage]] of FooBar.
+
+You can also specify a link that contains a directory name, like
+"FooBar/OtherPage" to more exactly specify what page to link to. This is
+the only way to link to an unrelated [[SubPage]].
+
+You can use this to, for example, to link from BazBar to "FooBar/SubPage",
+or from BazBar/SubPage to "FooBar/SubPage".
+
+You can also use "/" at the start of a link, to specify exactly which page
+to link to, when there are multiple pages with similar names and the link
+goes to the wrong page by default. For example, linking from
+"FooBar/SubPage" to "/OtherPage" will link to the "OtherPage" in the root
+of the wiki, even if there is a "FooBar/OtherPage".
+
+Also, if the wiki is configured with a userdir, you can link to pages
+within the userdir without specifying a path to them. This is to allow for
+easy linking to a user's page in the userdir, to sign a comment. These
+links are checked for last of all.