Sync with ikiwiki 3.20100926.HEADmasterikiwiki

11 files changed, 452 insertions, 0 deletions

diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
new file mode 100644
index 0000000..f7ebc17
--- /dev/null
+++ b/ikiwiki/directive.mdwn
@@ -0,0 +1,46 @@
+[[!meta robots="noindex, follow"]]
+Les directives sont semblables aux [[ikiwiki/WikiLink]] mais elles
+commencent par un `!` et peuvent contenir des paramètres. La forme d'une
+directive est la suivante :
+
+	\[[!directive param="value" param="value"]]
+
+Le contenu de cette directive est traité avant que la page ne soit traitée
+et cela peut être utilisé pour modifier cette page.
+
+Les guillements autour des valeurs des paramètres peuvent être omis si cette
+valeur est un simple mot. D'autre part, certaines directives peuvent avoir
+des paramètres sans valeur, par exemple : 
+
+	\[[!tag foo]]
+
+Il n'est pas nécessaire d'écrire une directive sur une seule ligne ; elle
+peut l'être sur plusieurs si vous préférez. Par exemple :
+	
+	\[[!directive foo="baldersnatch"
+	bar="supercalifragilisticexpialidocious" baz=11]]
+
+De plus, une *citation* sur plusieurs lignes peut servir de valeur. Pour
+autoriser les guillemets du texte, il suffit de mettre trois séries de
+guillemets autour du texte :
+
+	\[[!directive text="""
+	1. "foo"
+	2. "bar"
+	3. "baz"
+	"""]]
+
+Il existe aussi une ancienne syntaxe pour les directives. Elle demande un
+espace dans la directive pour les distinguer des
+[[wikilinks|ikiwiki/wikilink]]. Cette syntaxe a plusieurs défauts : elle
+demande un espace après une directive sans paramètre, comme `\[[pagecount
+]]`, et elle interdit les espaces dans les
+[[wikilinks|ikiwiki/wikilink]]. Par défaut, ikiwiki utilise maintenant la
+syntaxe montrée plus haut, avec le `!`. Cependant, l'ancienne syntaxe est
+toujours acceptée, une fois que l'option `prefix_directives` est désactivée.
+
+[[!if test="enabled(listdirectives)" then="""
+Voici une liste des directives actuellement disponibles sur ce wiki :
+
+[[!listdirectives ]]
+"""]]
diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn
new file mode 100644
index 0000000..a851930
--- /dev/null
+++ b/ikiwiki/formatting.mdwn
@@ -0,0 +1,107 @@
+[[!meta title="Formater les pages"]]
+[[!meta robots="noindex, follow"]]
+
+Sur ce wiki, la mise en forme du texte est semblable à celle utilisée dans
+les courriels. Ce style de formatage s'appelle [[MarkDown]]. Voici comment
+il fonctionne :
+
+Lignes vides entre les paragraphes.
+
+Texte en *\*italique\** avec un astérisque ou texte en **\*\*gras\*\*** avec
+deux astérisques.
+
+Une liste, chaque ligne commençant par un astérisque :
+
+* "* ma liste"
+* "* un autre élément"
+
+Une liste numérotée, chaque ligne commençant par un chiffre (n'importe
+lequel), suivi d'un point :
+
+1. "1. première ligne"
+2. "2. deuxième ligne"
+2. "2. troisième ligne"
+
+Un titre, une ligne commençant par un ou plusieurs caractères `#` suivis
+d'un caractère espace et du texte du titre. Le nombre de `#` détermine la
+taille du titre :
+
+# # h1
+## ## h2
+### ### h3
+#### #### h4
+##### ##### h5
+###### ###### h6
+
+Une règle horizontale,  au moins trois tirets ou étoiles sur la même ligne :
+
+----
+
+Pour citer quelqu'un, faire précéder la citation de ">" :
+
+> To be or not to be,
+> that is the question.
+
+Un morceau de code, faire précéder chaque ligne par une tabulation ou quatre
+espaces :
+
+	10 PRINT "Hello, world!"
+	20 GOTO 10
+
+Pour créer un lien avec une URL ou une adresse électronique,
+mettre l'URL entre crochets, <<http://ikiwiki.info>>,
+ou utiliser la forme \[texte du lien\]\(url\)
+
+----
+
+En plus du formatage html élémentaire avec [[MarkDown]], ce wiki offre
+d'autres possibilités :
+
+* Pour créer un lien vers une autre page du wiki, mettre le nom de la page
+  entre deux paires de crochets. Ainsi, utilisez `\[[WikiLink]]` pour un
+  lien avec [[WikiLink]].
+
+[[!if test="enabled(smiley) and smileys" then="""
+* Insérer des [[smileys]] et d'autres symboles très utiles :-)
+"""]]
+
+[[!if test="enabled(shortcut) and shortcuts" then="""
+* Utiliser des [[shortcuts]] pour renvoyer à des ressources communes.
+
+	\[[!wikipedia War\_of\_1812]]
+"""]]
+
+[[!if test="enabled(template) and templates" then="""
+* Créer et utiliser des modèles ([[templates]]) pour répéter des morceaux de
+  texte standard.
+"""]]
+
+Insérer diverses [[directives|directive]] sur une page pour modifier cette page.
+[[!if test="enabled(toc) or enabled(meta) or enabled(inline)" then="""
+  Par exemple, vous pouvez :
+"""]]
+
+[[!if test="enabled(toc)" then="""
+  * ajouter une table des matières sur une page :
+
+	\[[!toc]]
+"""]]
+
+
+[[!if test="enabled(meta)" then="""
+  * changer le titre d'une page :
+
+	\[[!meta title="titre complet de la page"]]
+"""]]
+
+[[!if test="enabled(inline)" then="""
+  * créer un blog en enchaînant un ensemble de pages (directive
+    « inline ») :
+
+	\[[!inline pages="blog/*"]]
+"""]]
+
+[[!if test="enabled(listdirectives)" then="""
+  Voici la liste complète des directives activées sur ce wiki :
+  [[!listdirectives ]]
+"""]]
diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn
new file mode 100644
index 0000000..70fa5d3
--- /dev/null
+++ b/ikiwiki/markdown.mdwn
@@ -0,0 +1,13 @@
+[[!meta robots="noindex, follow"]]
+[Markdown](http://daringfireball.net/projects/markdown/) est un langage de
+balisage élémentaire, comparable à celui utilisé dans la messagerie
+électronique. Il s'agit du langage de balisage utilisé par défaut dans ce
+wiki.
+
+Référez vous à [[formatting]] et [Syntaxe
+Markdown](http://daringfireball.net/projects/markdown/syntax) pour la
+documentation sur la syntaxe du langage markdown.
+
+Notez que les [[WikiLinks|WikiLink]] et les [[directives|directive]] ne font
+pas partie de la syntaxe du langage markdown. Il s'agit des seules balises
+qui sont traitées en interne par ce wiki.
diff --git a/ikiwiki/openid.mdwn b/ikiwiki/openid.mdwn
new file mode 100644
index 0000000..5875c1d
--- /dev/null
+++ b/ikiwiki/openid.mdwn
@@ -0,0 +1,30 @@
+[[!meta title="OpenID"]]
+[[!meta robots="noindex, follow"]]
+
+[[!if test="enabled(openid)"
+     then="OpenID est **activé** sur ce wiki."
+     else="OpenID est **desactivé** sur ce wiki."]]
+
+[OpenID](http://openid.net) est un système d'authentification décentralisé
+qui permet d'avoir un identifiant unique, utilisable sur un nombre croissant
+de sites internet.
+
+Si vous possédez un compte sur l'un des nombreux fournisseurs de services
+web, il se peut que vous ayez déjà un OpenID. [Répertoire des fournisseurs
+d'OpenID](http://openiddirectory.com/openid-providers-c-1.html).
+
+[[!if test="enabled(openid)" then=""
+Pour vous connecter à ce wiki en utilisant OpenID, entrez simplement votre
+identifiant dans le champ OpenID du formulaire de connexion. Vous n'avez pas
+besoin de donner un mot de passe pour ce wiki ou de passer par le processus
+d'enregistrement lorsque vous utilisez OpenID.
+"""]]
+
+---
+
+Il est également possible de faire une page dans le wiki utilisable comme un
+identifiant OpenID (URL) en la déléguant à un serveur OpenID. Voici un
+exemple permettant de faire cela :
+
+	\[[!meta openid="http://yourid.myopenid.com/"
+	       server="http://www.myopenid.com/server"]]
diff --git a/ikiwiki/pagespec.mdwn b/ikiwiki/pagespec.mdwn
new file mode 100644
index 0000000..680382c
--- /dev/null
+++ b/ikiwiki/pagespec.mdwn
@@ -0,0 +1,88 @@
+[[!meta robots="noindex, follow"]]
+Le wiki utilise un concept de spécification de page « PageSpec » afin de
+choisir un ensemble de pages. Par exemple il est possible de choisir les
+pages verrouillées, les pages dont vous recevez par courriel les
+modifications ou des pages à regrouper pour faire blog. Une spécification
+correspond à un ensemble de pages.
+
+La spécification la plus simple est la liste de pages. Par exemple,
+l'expression suivante correspond à l'une ou l'autre des trois pages
+listées :
+
+	foo or bar or baz
+
+La plupart du temps, vous voulez trouver les pages qui contiennent une
+expression particulière dans leur nom. Cela s'obtient en utilisant un motif
+(« glob pattern »). Le métacaractère « `*` » correspond à n'importe quelle
+partie du nom de la page et le métacaractère « `?` » à n'importe quelle
+lettre. Ainsi, l'expression suivante correspond à toutes les pages traitant
+de musique et à n'importe quelle sous-page [[SubPage]] de la *SandBox*, mais
+pas à la *SandBox* elle-même :
+
+	*musique* or SandBox/*
+
+Vous pouvez également préfixer un élément avec « `!` » pour ignorer les
+pages correspondantes. Ainsi pour trouver toutes les pages sauf les pages
+Discussion et la page *SandBox* :
+
+	* and !SandBox and !*/Discussion
+
+Des contraintes plus élaborées peuvent être ajoutées avec les fonctions
+suivantes :
+
+* "`glob(motif)`" - recherche les pages et fichiers qui correspondent au motif.
+  N'écrire que le motif lui-même est un raccourci pour cette fonction.
+* "`page(motif)`" - comme `glob()`, mais ne recherche que des pages, pas des fichiers.
+* "`link(page)`" -  correspond aux pages ayant un lien vers cette page (ou motif)
+* "`tagged(étiquette)`" - correspond aux pages qui sont marquées ou qui sont
+  liées à l'étiquette donnée (ou des étiquettes correspondant à un motif).
+* "`backlink(page)`" -  correspond seulement aux pages qui sont pointées (lien) par la page donnée.
+* "`creation_month(mois)`" - correspond aux pages créées durant ce mois
+* "`creation_day(jour)`" - ou au jour de ce mois
+* "`creation_year(année)`" - ou année
+* "`created_after(page)`" - correspond aux fichiers créés après la création de la page donnée.
+* "`created_before(page)`\" - correspond aux fichiers créés avant la création de la page donnée.
+* "`internal(motif)`" - comme `glob()`,  mais correspond en plus aux
+  pages à usage interne que la fonction glob ne trouve pas en général.
+* "`title(motif)`", "`author(motif)`", "`authorurl(motif)`",
+  "`license(motif)`", "`copyright(motif)`", "`guid(motif)`"
+  -  renvoient les pages qui possèdent les métadonnées correspondant au motif donné.
+* "`user(username)`" - teste si une modification est faite par l'identifiant donné.
+  Si openid est activé, on peut aussi l'utiliser. L'identifiant peut contenir des expressions régulières.
+  Par exemple, pour obtenir tous les utilisateurs openid, utilisez l'expression : `user(*://*)`.
+* "`admin()`" - teste si une modification par un administrateur du wiki est en cours.
+* "`ip(adresse)`" - teste si une modification par l'IP donnée est en cours.
+* "`comment(motif)`" - renvoient les commentaires d'une page correspondant au motif donné.
+* "`comment_pending(motif)`" - renvoient les commentaires non modérés, en attente.
+* "`postcomment(motif)`" -  ne correspond que si des commentaires sont postés
+  vers une page correspondant au motif donné.
+
+Par exemple, pour trouver toutes les pages d'un blog qui ont un lien vers la
+page traitant de musique et qui ont été créées en 2005 :
+
+	blog/* and link(musique) and creation_year(2005)
+
+Veuillez noter l'utilisation du « and » dans l'exemple ci-dessus. Seules les
+pages dont les trois conditions sont vraies seront trouvées. Utilisez
+« and » pour ce genre d'expression combinée. « or » est utilisé quand une
+seule des trois conditions est suffisante. Veuillez noter que « index and
+SandBox » n'a pas de sens puisqu'aucune page ne peut correspondre aux deux
+expressions.
+
+On peut créer des expressions plus complexes à l'aide de parenthèses. Par
+exemple, pour trouver les pages d'un blog possédantl'une ou l'autre
+étiquette, on utiliserait :
+
+	blog/* and (tagged(foo) or tagged(bar))
+
+Veuillez noter que le nom d'une page dans une spécification de page
+correspond au nom absolu du fichier dans le wiki. Ainsi une expression
+« foo » utilisée sur une page « a/b » ne correspondra pas à une page nommée
+« a/foo » ni à une page « a/b/foo ». Pour une correspondance relative au
+répertoire de la page contenant la spécification, vous pouvez utiliser
+« ./ ». Par exemple, « ./foo » sur la page « a/b » correspondra à la page
+« a/foo ».
+
+To indicate the name of the page the PageSpec is used in, you can use a
+single dot. For example, `link(.)` matches all the pages linking to the page
+containing the PageSpec.
diff --git a/ikiwiki/pagespec/attachment.mdwn b/ikiwiki/pagespec/attachment.mdwn
new file mode 100644
index 0000000..5f9c9fd
--- /dev/null
+++ b/ikiwiki/pagespec/attachment.mdwn
@@ -0,0 +1,37 @@
+[[!meta robots="noindex, follow"]]
+[[!if test="enabled(attachment)"
+     then="Les pièces jointes sont autorisées sur ce wiki."
+     else="Les pièces jointes ne sont pas autorisées sur ce wiki."]]
+
+Quand les pièces jointes sont autorisées, l'administrateur du wiki peut
+contrôler le type des pièces acceptées, avec l'option de configuration
+`allowed_attachments`.
+
+For example, to limit most users to uploading small images, and nothing
+else, while allowing larger mp3 files to be uploaded by joey into a specific
+directory, and check all attachments for viruses, something like this could
+be used:
+  
+	virusfree() and ((user(joey) and podcast/*.mp3 and mimetype(audio/mpeg) and maxsize(15mb)) or (mimetype(image/*) and maxsize(50kb)))
+
+La syntaxe normale de [[ikiwiki/PageSpec]] est appliquée avec les tests
+supplémentaires suivants :
+
+* `maxsize(size)` - teste si la taille de la pièce n'est pas plus grande que
+  la taille donnée. La taille est mesurée en octet mais on peut l'indiquer
+  en « ko », « mo », « go » etc.
+  
+* `minsize(size)` -  teste si la taille de la pièce n'est pas plus petite
+  que la taille donnée.
+
+* `ispage()` - teste si la pièce jointe sera traitée comme page de wiki par
+  ikiwiki, c'est-à-dire si son extension est « .mdwn » ou un autre format
+  accepté.
+
+ Donc, si vous ne voulez pas que des pages de wiki puissent être envoyées en pièces jointes, utilisez  `!ispage()`
+ et dans le cas contraire, `ispage()`.
+
+* `mimetype(foo/bar)` - teste le type MIME de la pièce jointe. Vous pouvez
+  inclure un motif dans le type, par exemple  `mimetype(image/*)`.
+
+* `virusfree()` - teste la pièce jointe avec un programme antivirus.
diff --git a/ikiwiki/pagespec/po.mdwn b/ikiwiki/pagespec/po.mdwn
new file mode 100644
index 0000000..62f165b
--- /dev/null
+++ b/ikiwiki/pagespec/po.mdwn
@@ -0,0 +1,23 @@
+[[!if test="enabled(po)"
+     then="Ce wiki gère le mode po."
+     else="Ce wiki ne gère pas le mode po."]]
+
+Si le greffon [[!iki plugins/po desc=po]] est activé, la syntaxe normale de
+[[ikiwiki/PageSpec]] est développée avec les tests supplémentaires suivants
+qui peuvent améliorer la navigation d'un utilisateur de wiki
+plurilinguistique :
+
+* `lang(LL)` - teste si la page est écrite dans la langue indiquée par le
+  code ISO639-1 (deux lettres).
+* `currentlang()` - teste si une page est écrite dans la langue de la page
+  donnée.
+* "`needstranslation()`" - tests whether a page needs translation work. Only
+  slave pages match this PageSpec. A minimum target translation percentage
+  can optionally be passed as an integer parameter: "`needstranslation(50)`"
+  matches only pages less than 50% translated.
+
+Notez que chaque page qui n'est pas de type po est considérée comme une page
+écrite selon le `po_master_language`, tel que spécifié dans le fichier de
+configuration `ikiwiki.setup`.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/searching.mdwn b/ikiwiki/searching.mdwn
new file mode 100644
index 0000000..7717a97
--- /dev/null
+++ b/ikiwiki/searching.mdwn
@@ -0,0 +1,24 @@
+[[!meta robots="noindex, follow"]]
+
+[[!if test="enabled(search)"
+then="La fonction de recherche est **activée** sur ce wiki."
+else="La fonction de recherche est **désactivée** sur ce wiki."]]
+
+Si la fonction de recherche est activée, vous pouvez saisir des mots clefs
+dans le champ de recherche, comme vous pouvez vous y attendre. Il y a
+quelques petits trucs que vous pouvez utiliser pour obtenir des résultats
+plus précis.
+
+* Pour rechercher précisément une phrase, mettez-la entre guillemets.
+* `AND` peut être utilisé pour rechercher des documents contenant deux
+  expressions.
+* `OR` peut être utilisé pour rechercher des documents contenant l'une des
+  deux expressions.
+* Les parenthèses peuvent être utilisées pour construire des requêtes plus
+  compliquées, comme par exemple "(foo AND bar) OR (me AND you)"
+* Préfixez un mot clef avec "-" pour éviter que les pages contenant ce mot
+  clef n'apparaissent dans les résultats. Par exemple, "-discussion" ne
+  prendra pas en compte les pages contenant "discussion".
+* Pour chercher une page dont le titre est connu, utilisez "title:foo".
+* Pour rechercher les pages contenant un lien vers une page "truc", utilisez
+  "link:truc".
diff --git a/ikiwiki/subpage.mdwn b/ikiwiki/subpage.mdwn
new file mode 100644
index 0000000..98e5232
--- /dev/null
+++ b/ikiwiki/subpage.mdwn
@@ -0,0 +1,15 @@
+[[!meta robots="noindex, follow"]]
+ikiwiki permet de ranger les pages dans une arborescence de répertoires. Par
+exemple cette page, [[SubPage]], est liée à des pages placées
+hiérarchiquement sous elle, comme la page [[SubPage/LinkingRules]]. C'est
+une façon pratique d'ordonner le wiki au lieu d'avoir un seul gros
+répertoire plein de pages.
+
+Pour ajouter une sous-page, faites simplement un sous-répertoire et mettez-y
+les pages. Par exemple, cette page est `subpage.mdwn` dans les sources de ce
+wiki et il y a également un sous-répertoire subpage, qui contient
+`subpage/linkingrules.mdwn`. Les sous-pages peuvent être emboîtées autant
+que vous le souhaitez.
+
+Faire un lien depuis et vers une sous-page est expliqué dans
+[[LinkingRules]].
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.
diff --git a/ikiwiki/wikilink.mdwn b/ikiwiki/wikilink.mdwn
new file mode 100644
index 0000000..2033477
--- /dev/null
+++ b/ikiwiki/wikilink.mdwn
@@ -0,0 +1,31 @@
+[[!meta robots="noindex, follow"]]
+Un WikiLink est un moyen simple de lier des pages entre elles. Pour créer un
+[[WikiLink]], il suffit de mettre le nom d'une page à lier entre double
+crochets. Par exemple, `\[[WikiLink]]`.
+
+Si jamais vous avez besoin d'écrire quelque chose comme `\[[WikiLink]]` sans
+créer de lien, il suffit de préfixer le mot par une barre oblique `\`, comme
+`\\[[WikiLink]]`.
+
+Quelques règles spéciales, [[SubPage/LinkingRules]], entrent en jeu pour
+lier des sous-pages, [[SubPages|SubPage]].
+
+La recherche de correspondance entre WikiLinks et noms de page ne tient pas
+compte de la casse des lettres. Inutile de s'embêter avec les majuscules et
+les minuscules et vous pouvez mettre une lettre capitale au lien qui se
+trouve en début de phrase, etc.
+
+Il est aussi possible d'écrire un WikiLink dont le texte n'est pas un nom de
+page. Ainsi, `\[[foo_bar|SandBox]]` pointe vers la page SandBox, mais le
+lien apparaît comme ceci : [[foo_bar|SandBox]].
+
+Pour pointer vers une ancre à l'intérieur d'une page, vous pouvez utiliser
+quelque chose comme `\[[WikiLink#foo]]`.
+
+Quand le fichier pointé par un WikiLink ressemble à une image, il est
+affiché au fil du texte sur la page.
+
+---
+
+Vous pouvez mettre une URL dans un WikiLink pour lier une page externe. Des
+adresses électroniques peuvent servir à créer des liens mailto.