From 944255f9f0857a5286d88f627c47dd9428a9f810 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Thu, 14 Oct 2010 13:38:34 +0200 Subject: Sync with ikiwiki 3.20100926. --- ikiwiki/directive.mdwn | 46 ++++++++++++++++ ikiwiki/formatting.mdwn | 107 ++++++++++++++++++++++++++++++++++++++ ikiwiki/markdown.mdwn | 13 +++++ ikiwiki/openid.mdwn | 30 +++++++++++ ikiwiki/pagespec.mdwn | 88 +++++++++++++++++++++++++++++++ ikiwiki/pagespec/attachment.mdwn | 37 +++++++++++++ ikiwiki/pagespec/po.mdwn | 23 ++++++++ ikiwiki/searching.mdwn | 24 +++++++++ ikiwiki/subpage.mdwn | 15 ++++++ ikiwiki/subpage/linkingrules.mdwn | 38 ++++++++++++++ ikiwiki/wikilink.mdwn | 31 +++++++++++ 11 files changed, 452 insertions(+) create mode 100644 ikiwiki/directive.mdwn create mode 100644 ikiwiki/formatting.mdwn create mode 100644 ikiwiki/markdown.mdwn create mode 100644 ikiwiki/openid.mdwn create mode 100644 ikiwiki/pagespec.mdwn create mode 100644 ikiwiki/pagespec/attachment.mdwn create mode 100644 ikiwiki/pagespec/po.mdwn create mode 100644 ikiwiki/searching.mdwn create mode 100644 ikiwiki/subpage.mdwn create mode 100644 ikiwiki/subpage/linkingrules.mdwn create mode 100644 ikiwiki/wikilink.mdwn (limited to 'ikiwiki') 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, <>, +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. -- cgit v1.2.3