Différences

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

--- fr:wikitools:redac:1erarticle [2013/06/11 11:44] – modification externe 127.0.0.1
+++ fr:wikitools:redac:1erarticle [2021/12/03 18:19] (Version actuelle) – modification externe 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 !
+Vous avez envie d'ajouter un article sur un des wiki de Khaganat ? Excellente idée ! Vous avez lu les [[fr:wikitools:redac:premiers_pas]] et les [[fr:wikitools:redac:principe_redac]] mais ça ne suffit pas ? Voici la marche à suivre pour créer votre premier article en étant sûr de ne pas se tromper !
-===== Vérifier qu'on ne fait pas n'importe quoi =====
+===== Est-ce que l'article existe déjà ? =====
 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.
+S'il existe des pages parlant déjà de ces sujets : complétez-les. Si ça mérite quand même de créer un autre article, [[fr:wikitools:syntaxe:base#internes|liez]] ces pages à celle que vous allez créer.
+S'il n'y a rien... très bien, on peut passer à la création.
 ==== Créer, oui, mais pas n'importe où ====
+Si vous avez lu les [[fr:wikitools:redac:principe_redac]], vous savez que chaque wiki a une fonction. Pas la peine de mettre une histoire dans le Wikhan, ou de parler de la façon de paramétrer le client de jeu sur la Mediateki. Chaque wiki a d'ailleurs ses propres règles de rédaction, listées sur cette page aussi.
 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.
+[[doku>fr:dokuwiki|Dokuwiki]] (notre moteur de wiki) a une organisation un peu particulière. Les pages sont rangées dans des [[doku>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éé.
+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éé. Sur le Wikhan et l'UM1, les articles se font sous l'espace de nom de la langue. Par exemple une page sur le Khan en français sera à l'adresse /fr:khan. Si vous voulez faire la fiche en anglais ce sera /en:khan.
-Il y a un nom de page spécial : "//accueil//", qui si elle est créé sera la page de l'espace de nom.
+Les espaces de noms sont séparés par deux points.
-mon_espace_de_nom:mon_espace_secondaire:accueil
-Au niveau des conventions, écrivez la page //accueil// des espaces de nom de cette façon :
+Pour en savoir encore plus sur l'organisation d'un dokuwiki, visitez [[doku>fr:page|cette page]].
-<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]].
+Les catégories sont représentées par les [[fr:wikitools:syntaxe:tag|tags]]. C'est une balise à ajouter à la fin d'un article, et vous pouvez mettre cet article dans une ou plusieurs catégories. Mettez toujours un ou plusieurs tags à votre article ; encore une fois, les "principes de rédactions" de chaque wiki vous donnent les infos sur quels tags utiliser pour ne pas s'y perdre.
 ===== 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.
+Pour créer une nouvelle page au bon endroit, allez sur une page située dans le même espace de nom, puis dans votre barre d'adresse, changez la fin par le nom identifiant votre article.
 L'adresse se termine par quelque chose ressemblant à ça :
-  cat1:cat2:exemple
+  fr: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
+  fr: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.
+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 thème du wiki, 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.
+Lorsque c'est possible, préférez un nom parlant pour toutes les langues. //XMPP// est un bon nom, par exemple, alors que //Syteme_de_chat// l'est beaucoup moins. Cela facilite le boulot des traducteurs par la suite.
 </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.
+Si vous avez fait une erreur en créant la page (nom mal pensé ou mauvais espace de nom), pas de panique, c'est facile à corriger. Recréez 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...)).
+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((Aucun sur le Wikhan actuellement, mais il y en a déjà sur [[um1>|l'UM1]].)).
 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 :
+  * 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... Dans l'éditeur, c'est l’icône {{http://khaganat.net/dokuwiki/lib/images/toolbar/h1.png?|}} dont la balise est :
 <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 [[fr:wikitools: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.
+  * 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 [[fr:wikitools:syntaxe:tag|catégories]] sont aussi appelées 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 [[fr:wikitools:syntaxe:start|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é.
+Pour le reste il faut maîtriser un peu la [[fr:wikitools:syntaxe:start|syntaxe]] (suivez le guide, tout est détaillé !). Les options de mise en page les plus courantes sont listées 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 [[fr:wikitools:syntaxe:base#mise_en_forme_de_texte_basique|paragraphe]]), et les [[fr:wikitools: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.
+Deux choses importantes à savoir : un retour à la ligne n'est pas pris en compte (il en faut deux et ça fait un [[fr:wikitools:syntaxe:base#mise_en_forme_de_texte_basique|paragraphe]]), et les [[fr:wikitools: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, il suffit de faire un retour à la ligne de plus. Pour le second, évitez les indentations ou utilisez les listes à puces.
-{{tag>Wiki Syntaxe Tutoriel Aide}}
+{{tag>Wiki Syntaxe Tutoriel}}