Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:wiki:1erarticle [2013/02/10 21:09] – modification externe 127.0.0.1
+++ fr:wiki:1erarticle [Date inconnue] (Version actuelle) – supprimée - modification externe (Date inconnue) 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
-====== 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.
-[[https://www.dokuwiki.org/start?id=fr:dokuwiki|Dokuwiki]] (notre moteur de wiki) a une organisation un peu particulière. Les pages sont rangés dans des [[https://www.dokuwiki.org/fr:namespaces|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 : "//accueil//", qui si elle est créé sera la page de l'espace de nom.
-mon_espace_de_nom:mon_espace_secondaire:accueil
-Au niveau des conventions, écrivez la page //accueil// des espaces de nom de cette façon :
-<file>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}}
-</file>
-<WRAP center round help 60%>
-J'aimerais trouver mieux que ça...
-</WRAP>
-Pour en savoir encore plus sur l'organisation d'un dokuwiki, visitez [[https://www.dokuwiki.org/fr:page|cette page]].
-===== 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.
-<WRAP center round important 60%>
-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.
-</WRAP>
-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èles((A créer, donc...)).
-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 :
-<code>====== Titre de niveau 1 ======</code>
-  * 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 [[wiki:syntaxe:tag|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.
-<code>{{tag>tag1,tag2,tag3}}</code>
-Pour le reste il faut maîtriser un peu la [[wiki:syntaxe:accueil|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 [[wiki:syntaxe:base#mise_en_forme_de_texte_basique|paragraphe]]), et les [[wiki:syntaxe:base#blocs_non_analyses|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.
-{{tag>Wiki Syntaxe Tutoriel Aide}}