Ceci est une ancienne révision du document !
Créez votre premier article
Vous avez envie d'ajouter un article sur un des wiki de Khaganat ? Excellente idée !
Vérifier qu'on ne fait pas n'importe quoi
Avant tout il faut vérifier si l'article n'existe pas déjà pour éviter de faire des pages en doublon. Il vaut mieux rajouter un paragraphe à un article que disperser l'information.
Mais parfois il vaut aussi mieux créer une nouvelle page pour aborder un point spécifique que faire des articles sans fin !
Où parle-t-on de ça ?
Il suffit de faire une recherche avec les mot-clés de ce dont vous voulez parler. Si vous avez envie d'ajouter des informations sur la migration des pendos ou l'installation d'un serveur de jeu, alors pensez à chercher des mots comme “migration”, “pendo”, “serveur”, “installation”.
Soit il existe des pages parlant déjà de ces sujets (à voir s'il est plus pertinent de les compléter ou de les lier à votre nouvelle page), soit il n'y a rien… très bien, on peut passer à la création.
Créer, oui, mais pas n'importe où
Les wiki s'organisent suivant une certaine arborescence et c'est toujours plus simple si la page est créée au bon endroit.
Dokuwiki (notre moteur de wiki) a une organisation un peu particulière. Les pages sont rangés dans des espaces de noms (namespaces). En pratique, ce sont des dossiers, les articles étant des fichiers textes, comme sur votre ordinateur personnel.
On confond parfois espace de nom et catégorie. Ce n'est pas complètement la même chose. Un article peut appartenir à plusieurs catégories mais il ne sera jamais que dans un seul dossier (ou espace de nom). C'est ce qui est important lors de la création de votre article : le placer dans le bon espace de nom. Quand aux catégories, on voit ça une fois l'article créé.
Il y a un nom de page spécial : “start”, qui si elle est créé sera la page d’accueil de l'espace de nom. mon_espace_de_nom:mon_espace_secondaire:start
Au niveau des conventions, écrivez la page start des espaces de nom de cette façon :
Titre de la section en H1
Description courte si besoin
Listage des sous-espaces avec la balise : <catlist -noHead -noAddPageButton >
Listage des sous-catégories (tags) avec la balise {{count>+&espacedenom1:espacedenom2}}
Catégories de la sections renseignés par les tags avec la balise : {{tag>tag1}}
Pour en savoir encore plus sur l'organisation d'un dokuwiki, visitez cette page.
Chaque wiki a sa façon d'organiser l'espace. Lire Principes de rédaction est utile :
La création, enfin !
Pour créer une nouvelle page au bon endroit, allez sur un page situé dans le même espace de nom, puis dans votre barre d'adresse, changer la fin par le nom identifiant votre article.
L'adresse se termine par quelque chose ressemblant à ça :
cat1:cat2:exemple
Vous effacez ici le mot “exemple” pour le remplacer par le nom de votre article, “monarticle” par exemple, afin d'obtenir ceci :
cat1:cat2:monarticle
Vous allez alors arriver sur une page vierge, vous indiquant “qu'elle n'existe pas”. Il ne reste plus qu'à cliquer sur “éditer” pour créer votre page ! Suivant le template, c'est l’icône de crayon sur la barre à droite ou un onglet en haut de l'article.
Les noms de pages doivent être écrits en minuscules, sans accent, ni espace, ni caractères bizarres. Des lettres et des chiffres seulement ! Essayez de trouver un nom en rapport avec la page, mais pas d'inquiétude si c'est un peu moche comme syntaxe : lorsqu'on liste des articles sur une page, c'est le premier titre qui apparaît.
Si vous avez fait une erreur en créant la page (nom pas terrible ou mauvais espace de nom), pas de panique, c'est facile à corriger. Recréer une page au bon endroit (ou avec le bon nom), copiez dedans le contenu de votre premier article, puis effacez celui-ci. Il retourne à l'oubli.
Rédigez en suivant le guide
Certaines sections de wiki, certains types de pages, doivent obéir à des modèles de mise en page précis afin que l'ensemble reste cohérent. Nous essayons de mettre en place des modèles chaque fois que c'est possible et de créer des guides sur ces modèles1).
Il y a cependant des règles valables sur toutes les pages :
- Mettre un titre au début. C'est toujours le titre de niveau 1 et le seul endroit de l'article où utiliser ce niveau de titre…dont la balise ressemble à ça :
====== Titre de niveau 1 ======
- Renseigner les catégories à la fin de l'article (pas avant, ni après). Il est possible que certains articles n'aient pas de catégories : ajoutez-en ! Les catégories sont aussi appelés tags. Il faut rajouter une balise à la fin d'un article pour lister les catégories à laquelle elle appartient.
{{tag>tag1,tag2,tag3}}
Pour le reste il faut maîtriser un peu la syntaxe (suivez le guide, tout est détaillé !). Les options de mises en page les plus courantes sont listés dans la barre d'édition, il suffit de cliquer ! Dokuwiki simplifie beaucoup l'apprentissage de la syntaxe grâce à son éditeur intégré.
Deux choses importantes à savoir : un retour à la ligne n'est pas pris en compte (il en faut deux et ça fait un paragraphe), et les espaces en début de ligne vont apparaître très différemment dans votre article. C'est contournable facilement pour le premier. Pour le second, évitez les indentations ou utilisez les listes à puces.
