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.mdwn | 17 ++++++ 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 +++++++++++ index.mdwn | 7 +++ recentchanges.mdwn | 7 +++ sandbox.mdwn | 33 ++++++++++++ shortcuts.mdwn | 82 +++++++++++++++++++++++++++++ templates.mdwn | 82 +++++++++++++++++++++++++++++ 17 files changed, 680 insertions(+) create mode 100644 ikiwiki.mdwn 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 create mode 100644 index.mdwn create mode 100644 recentchanges.mdwn create mode 100644 sandbox.mdwn create mode 100644 shortcuts.mdwn create mode 100644 templates.mdwn diff --git a/ikiwiki.mdwn b/ikiwiki.mdwn new file mode 100644 index 0000000..bdef1e1 --- /dev/null +++ b/ikiwiki.mdwn @@ -0,0 +1,17 @@ +[[!meta robots="noindex, follow"]] +Ce wiki est propulsé par [ikiwiki](http://ikiwiki.info/). +[[!if test="enabled(version)" + then "(version actuelle : [[!version ]].)" +]] + +Voici quelques pages de documentation sur l'utilisation d'ikiwiki : + +* [[ikiwiki/formatting]] +* [[ikiwiki/wikilink]] +* [[ikiwiki/subpage]] +* [[ikiwiki/pagespec]] +* [[ikiwiki/directive]] +* [[ikiwiki/markdown]] +* [[ikiwiki/openid]] +* [[ikiwiki/searching]] +* [[templates]] 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. diff --git a/index.mdwn b/index.mdwn new file mode 100644 index 0000000..b5667ad --- /dev/null +++ b/index.mdwn @@ -0,0 +1,7 @@ +Bienvenue sur votre nouveau wiki. + +Comme tous les wikis, ce wiki possède une page [[SandBox]]. + +---- + +Ce wiki est propulsé par [[ikiwiki]]. diff --git a/recentchanges.mdwn b/recentchanges.mdwn new file mode 100644 index 0000000..bda7e61 --- /dev/null +++ b/recentchanges.mdwn @@ -0,0 +1,7 @@ +[[!if test="enabled(meta)" then=""" +[[!meta title="RecentChanges"]] +"""]] +Dernières modifications : + +[[!inline pages="internal(recentchanges/change_*) and !*/Discussion" +template=recentchanges show=0]] diff --git a/sandbox.mdwn b/sandbox.mdwn new file mode 100644 index 0000000..fc76e48 --- /dev/null +++ b/sandbox.mdwn @@ -0,0 +1,33 @@ +Voici le bac à sable, une page que tout le monde peut éditer pour apprendre +à se servir du wiki. + +---- + +Voici un paragraphe. + +Un autre avec du texte en *italique*. + +# Titre + +## Sous-titre + +> Un bloc de citation. +> +> Le premier niveau de citation. +> +> > Une citation imbriquée. +> +> Retour au premier niveau. + +Liste numérotée + +1. Premier élément. +1. Un autre. +1. Encore un autre... + +Liste avec point + +* *élement* +* élement + +[[ikiwiki/WikiLink]] diff --git a/shortcuts.mdwn b/shortcuts.mdwn new file mode 100644 index 0000000..8e0c7a2 --- /dev/null +++ b/shortcuts.mdwn @@ -0,0 +1,82 @@ +[[!if test="enabled(shortcut)" + then="Les raccourcis sont **activés** dans ce wiki." + else="Les raccourcis sont **désactivés** dans ce wiki."]] + +Voici quelques exemples de raccourcis : + + \[[!google foo]] + \[[!wikipedia War_of_1812]] + \[[!debbug 12345]] + Consultez la \[[!cia ikiwiki desc="page du projet CIA pour %s"]]. + +Cette page définit les raccourcis connus par ce wiki. + +* [[!shortcut name=google url="https://encrypted.google.com/search?q=%s"]] +* [[!shortcut name=archive url="http://web.archive.org/*/%S"]] +* [[!shortcut name=gmap url="http://maps.google.com/maps?q=%s"]] +* [[!shortcut name=gmsg url="http://groups.google.com/groups?selm=%s"]] +* [[!shortcut name=wikipedia + url="https://secure.wikimedia.org/wikipedia/en/wiki/%s"]] +* [[!shortcut name=wikitravel url="https://wikitravel.org/en/%s"]] +* [[!shortcut name=wiktionary + url="https://secure.wikimedia.org/wiktionary/en/wiki/%s"]] +* [[!shortcut name=debbug url="http://bugs.debian.org/%S" desc="bug #%s"]] +* [[!shortcut name=deblist url="http://lists.debian.org/debian-%s" + desc="debian-%s@lists.debian.org"]] +* [[!shortcut name=debpkg url="http://packages.debian.org/%s"]] +* [[!shortcut name=debpkgsid url="http://packages.debian.org/sid/%s"]] +* [[!shortcut name=debpts url="http://packages.qa.debian.org/%s"]] +* [[!shortcut name=debmsg url="http://lists.debian.org/msgid-search/%s"]] +* [[!shortcut name=debrt + url="https://rt.debian.org/Ticket/Display.html?id=%s"]] +* [[!shortcut name=debss url="http://snapshot.debian.net/package/%s"]] + * Usage : `\[[!debss package]]`, `\[[!debss package#version]]`, ou `\[[!debss package/version]]`. Consultez http://snapshot.debian.net pour d'autres précisions. +* [[!shortcut name=debwiki url="http://wiki.debian.org/%s"]] +* [[!shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]] +* [[!shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]] +* [[!shortcut name=gnomebug url="http://bugzilla.gnome.org/show_bug.cgi?id=%s" desc="GNOME bug #%s"]] +* [[!shortcut name=linuxbug url="http://bugzilla.kernel.org/show_bug.cgi?id=%s" desc=\"Linux bug #%s"]] +* [[!shortcut name=mozbug url="https://bugzilla.mozilla.org/show_bug.cgi?id=%s" desc="Mozilla bug #%s"]] +* [[!shortcut name=gnulist url="http://lists.gnu.org/mailman/listinfo/%s" desc="%s@gnu.org"]] +* [[!shortcut name=marcmsg url="http://marc.info/?i=%s"]] +* [[!shortcut name=marclist url="http://marc.info/?l=%s"]] +* [[!shortcut name=gmane url="http://dir.gmane.org/gmane.%s" desc="gmane.%s"]] +* [[!shortcut name=gmanemsg url="http://mid.gmane.org/%s"]] +* [[!shortcut name=cpan url="http://search.cpan.org/search?mode=dist&query=%s"]] +* [[!shortcut name=ctan url="http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s"]] +* [[!shortcut name=hoogle url="http://haskell.org/hoogle/?q=%s"]] +* [[!shortcut name=iki url="http://ikiwiki.info/%S/"]] +* [[!shortcut name=ljuser url="http://%s.livejournal.com/"]] +* [[!shortcut name=rfc url="http://www.ietf.org/rfc/rfc%s.txt" desc="RFC %s"]] +* [[!shortcut name=c2 url="http://c2.com/cgi/wiki?%s"]] +* [[!shortcut name=meatballwiki url="http://www.usemod.com/cgi-bin/mb.pl?%s"]] +* [[!shortcut name=emacswiki url="http://www.emacswiki.org/cgi-bin/wiki/%s"]] +* [[!shortcut name=haskellwiki url="http://haskell.org/haskellwiki/%s"]] +* [[!shortcut name=dict url="http://www.dict.org/bin/Dict?Form=Dict1&Strategy=*&Database=*&Query=%s"]] +* [[!shortcut name=imdb url="http://imdb.com/find?q=%s"]] +* [[!shortcut name=gpg url="http://pgpkeys.mit.edu:11371/pks/lookup?op=vindex&exact=on&search=0x%s"]] +* [[!shortcut name=perldoc url="http://perldoc.perl.org/search.html?q=%s"]] +* [[!shortcut name=whois url="http://reports.internic.net/cgi/whois?whois_nic=%s&type=domain"]] +* [[!shortcut name=cve url="http://cve.mitre.org/cgi-bin/cvename.cgi?name=%s"]] +* [[!shortcut name=cia url="http://cia.vc/stats/project/%s"]] +* [[!shortcut name=ciauser url="http://cia.vc/stats/user/%s"]] +* [[!shortcut name=flickr url="http://www.flickr.com/photos/%s"]] +* [[!shortcut name=man url="http://linux.die.net/man/%s"]] +* [[!shortcut name=ohloh url="http://www.ohloh.net/projects/%s"]] +* [[!shortcut name=cpanrt url="https://rt.cpan.org/Ticket/Display.html?id=%s" desc="CPAN RT#%s"]] +* [[!shortcut name=novellbug url="https://bugzilla.novell.com/show_bug.cgi?id=%s" desc="bug %s"]] + +Pour ajouter un raccourci, utilisez la [[ikiwiki/directive]] +`shortcut`. Dans l'URL, "%s" est remplacé par le texte passé au raccourci, +après l'avoir codé [[!"wikipedia url_encoding]], et le "%S" est remplacé par +le texte brut, non codé. La paramètre facultatif `desc` contrôle la +description du lien. + +N'oubliez pas que le paramètre `name` donné au raccourci devient une +nouvelle [[ikiwiki/directive]]. Évitez de donner un nom qui entre en conflit +avec une directive existante. Ces directives acceptent aussi un paramètre +`desc` qui primera celui fourni au moment de la définition du raccourci. + +Si vous trouvez un raccourci qui vous paraît utile, proposez-le sur la [page +des raccourcis du wiki d'ikiwiki](http://ikiwiki.info/shortcuts/). Ainsi les +futures versions d'ikiwiki incluront automatiquement ce raccourci. diff --git a/templates.mdwn b/templates.mdwn new file mode 100644 index 0000000..0bac82a --- /dev/null +++ b/templates.mdwn @@ -0,0 +1,82 @@ +[[Ikiwiki]] se sert de modèles dans beaucoup de cas. En modifiant ces +modèles, vous pouvez « personnaliser » ce wiki. + +Les modèles sont situés dans le répertoire +`/usr/share/ikiwiki/templates`. Le paramètre `templatedir` peut être utilisé +pour commencer la recherche dans un autre répertoire. Des modèles +personnalisés peuvent être placés dans dans le sous-répertoire `templates/` +du répertoire source du wiki. + +Ikiwiki utilise le module HTML::Template pour créer ses modèles. Ce module, +facile à étudier, permet l'utilisation de conditions et de boucles. Voici ce +que vous avez besoin de savoir : + +* Pour insérer la valeur d'une variable, sans que la syntaxe wiki soit + convertie en HTML, utilisez ``. +* Pour écrire un bloc de texte si une variable est définie, utilisez + `texte`. +* Pour utiliser un bloc de texte si une variable est définie et un autre + dans le cas contraire, utilisez `texteautre + texte` + +[[!if test="enabled(template)" then=""" +## pages modèles + +La directive [[!iki ikiwiki/directive/template desc="template"]] permet +d'utiliser des pages de wiki comme modèles. Ces modèles peuvent être remplis +et insérés dans d'autres pages du wiki. +"""]] + +[[!if test="enabled(edittemplate)" then=""" +## contenu par défaut des nouvelles pages + +La directive [[!iki ikiwiki/directive/edittemplate desc="edittemplate"]] +permet que le contenu par défaut des nouvelles pages soit le texte d'une +page modèle, qui peut être remplie en même temps que la page est modifiée. +"""]] + +[[!if test="enabled(template) or enabled(edittemplate)) +and enabled(inline)" then=""" +[[!inline pages="templates/* and !*.tmpl and !templates/*/* and !*/discussion" +feeds=no archive=yes sort=title template=titlepage +rootpage=templates postformtext="Ajouter un nouveau modèle :"]] +"""]] + +## modèles du wiki + +Ces modèles permettent la construction du wiki. Le but est de mettre presque +tout le formatage HTML dans des modèles, hors de ikiwiki. + +* `page.tmpl` - permet d'afficher toutes les pages normales du wiki. C'est + le principal modèle à modifier. [[!if test="enabled(pagetemplate)" + then=""" + (La directive [[!iki ikiwiki/directive/pagetemplate desc="pagetemplate"]] + permet d'utiliser un modèle différent de `page.tmpl`.)"""]] +* `rsspage.tmpl` - permet la création de flux RSS pour les blogs. +* `rssitem.tmpl` - permet la création d'éléments individuels dans les flux RSS. +* `atompage.tmpl` - permet la création de flux Atom pour les blogs. +* `atomitem.tmpl` - permet la création d'éléments individuels dans les flux Atom. +* `inlinepage.tmpl` - permet l'affichage d'un message dans un blog. +* `archivepage.tmpl` - permet de lister une page dans une page d'archive de blog. +* `titlepage.tmpl` - permet de lister une page par son titre dans une page d'archive de blog. +* `microblog.tmpl` - permet de montrer un message de microblog au fil du texte. +* `blogpost.tmpl` - offre un formulaire pour ajouter un message dans un blog (avec des liens RSS/Atom) +* `feedlink.tmpl` - permet d'ajouter des liens RSS/Atom quand `blogpost.tmpl` n'est pas utilisé. +* `aggregatepost.tmpl` - modèle utilisé par le module aggregate pour créer une page de blog. +* `searchform.tmpl`, `googleform.tmpl` - modèles utilisés par les modules search et. + google pour ajouter un formulaire de recherche dans les pages de wiki. +* `searchquery.tmpl` - C'est un modèle Omega, utilisé par le module search. +* `comment.tmpl` - modèle utilisé par le module comments pour afficher un commentaire. +* `change.tmpl` - permet la création d'une page décrivant une modification du wiki. +* `recentchanges.tmpl` - permet de lister une modification sur la page RecentChanges. +* `autoindex.tmpl` - modèle utilisé par le module autoindex pour créer des pages d'index. +* `autotag.tmpl` - modèle utilisé par le module tag pour créer des pages avec étiquette. +* `calendarmonth.tmpl`, `calendaryear.tmpl` - modèles utilisés par le module ikiwiki-calendar pour + créer les pages d'archives des agendas. +* `editpage.tmpl`, `editconflict.tmpl`, `editcreationconflict.tmpl`, + `editfailedsave.tmpl`, `editpagegone.tmpl`, `pocreatepage.tmpl`, + `editcomment.tmpl` `commentmoderation.tmpl`, `renamesummary.tmpl`, + `passwordmail.tmpl`, `openid-selector.tmpl` - modèles faisant partie de l'interface utilisateur + d'ikiwiki'. Il n'y a en général aucun besoin de les personnaliser. + +[[!meta robots="noindex, follow"]] -- cgit v1.2.3