Sync with ikiwiki 3.20100926.HEADmasterikiwiki

1 files changed, 38 insertions, 0 deletions

diff --git a/ikiwiki/subpage/linkingrules.mdwn b/ikiwiki/subpage/linkingrules.mdwn
new file mode 100644
index 0000000..1c0f2f5
--- /dev/null
+++ b/ikiwiki/subpage/linkingrules.mdwn
@@ -0,0 +1,38 @@
+[[!meta robots="noindex, follow"]]
+Pour faire un lien depuis ou vers une sous-page ([[SubPage]]), vous pouvez
+normalement utiliser un [[WikiLink]] classique qui ne contient pas le nom du
+répertoire parent de la sous-page. Ikiwiki parcourt l'arborescence des
+répertoires pour trouver une page qui corresponde au lien.
+
+Par exemple, si FooBar/SubPage est liée à "OtherPage", ikiwiki préfèrera
+d'abord chercher la page dans FooBar/SubPage/OtherPage si elle existe,
+ensuite dans FooBar/OtherPage et finalement dans OtherPage à la racine du
+wiki.
+
+Cela signifie que si un lien de FooBar/SomePage vers "OtherPage" pointe
+actuellement vers OtherPage à la racine du wiki, et que la page
+FooBar/OtherPage est créée, alors le lien _changera_ pour pointer vers la
+page FooBar/OtherPage. Cependant, un lien de BazBar vers "OtherPage" ne
+serait pas impacté par cette création d'une sous-page ([[SubPage]]) de
+FooBar.
+
+Vous pouvez également définir un lien qui contient le nom d'un répertoire,
+comme "FooBar/OtherPage" pour spécifier plus précisément vers quelle page il
+faut pointer. C'est le seul moyen de faire un lien vers une sous-page qui
+n'est pas apparentée.
+
+Vous pouvez utiliser ceci pour, par exemple, faire un lien depuis BazBar
+vers "FooBar/SubPage", ou de BazBar/SubPage vers "FooBar/SubPage".
+
+Vous pouvez également utiliser "/" au début d'un lien pour indiquer
+précisément quelle page doit être pointée lorsqu'il y a plusieurs pages avec
+des noms identiques et que le lien ne pointe pas vers la bonne page par
+défaut. Par exemple, faire un lien depuis "FooBar/SubPage" vers "/OtherPage"
+pointera vers la page "OtherPage" à la racine du wiki même s'il existe une
+page "FooBar/OtherPage".
+
+De plus, si le wiki est configuré avec un répertoire `userdir`, vous pouvez
+facilement faire des liens vers les pages dans `userdir` sans spécifier le
+chemin vers ces pages. Cela permet de facilement pointer vers la page d'un
+utilisateur dans `userdir` pour signer un commentaire. La correspondance des
+liens avec ces pages est testée en tout dernier lieu.