Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format
PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
atelier:atelier [22/09/2013 22:37] captnfab [Prérequis] |
atelier:atelier [22/09/2013 22:38] captnfab [Création et modification des pages] |
||
---|---|---|---|
Ligne 43: | Ligne 43: | ||
* [[:atelier:template-tuto|Tuto type]] (déjà présent par défaut dans le cadre de composition) | * [[:atelier:template-tuto|Tuto type]] (déjà présent par défaut dans le cadre de composition) | ||
* [[:doc:media:gimp:liste-des-tp|Tuto type pour Gimp]] (pour la création d'un nouveau tuto pour Gimp) | * [[:doc:media:gimp:liste-des-tp|Tuto type pour Gimp]] (pour la création d'un nouveau tuto pour Gimp) | ||
+ | ===== Comment bien rédiger ===== | ||
- | ==== Conseils de rédaction ==== | + | ==== Syntaxe du wiki ==== |
- | Vous êtes laissés très libre quant au style de la rédaction des tutos. Voici tout de même une liste de conseils qui permettront une meilleure intégration et un suivi facilité de votre page. | + | Les pages du wiki se rédigent en syntaxe DokuWiki. Consultez la page d'aide à la syntaxe et entraînez-vous si besoin dans le bac-à-sable. |
- | Lors de la rédaction de votre page, | + | * [[syntaxe|La syntaxe de Dokuwiki]] |
+ | * [[bac-a-sable | Le bac à sable pour vous entrainer à rédiger sur le Wiki]] | ||
- | * pensez à faire simple et généraliste pour faciliter son adaptation aux futures versions de Debian | + | === Insérer une image dans le wiki === |
- | * pensez à utiliser les balises <nowiki><code> <code user> <code root> etc.</code></nowiki> à bon escient | + | |
- | * évitez toute redite ou documentation en doublon, c'est une plaie infâme lors des mises à jour | + | Si vous voulez insérer une image dans le wiki, celle-ci doit impérativement être hébergée chez Debian-Facile, sans quoi, elle pourrait être retirée par son hébergeur à tout moment. Assurez-vous également que cette image est sous GPL3 ou +. |
+ | |||
+ | * [[:atelier:insertion-image| Images dans le wiki]] La méthode pas à pas. | ||
+ | |||
+ | ==== Tags et retours sur le forum ==== | ||
+ | |||
+ | Pour assurer le suivi et la maintenance des tutos, nous utilisons deux canaux distincts : | ||
+ | * Un sujet dans le forum pour les annonce, commentaires, retours et suggestions. | ||
+ | * Un système de tag pour indiquer l'état du tuto aux modérateurs. | ||
+ | |||
+ | === Retour sur le forum === | ||
+ | |||
+ | L'en-tête des tutos contient la ligne suivante : | ||
+ | <nowiki> * Commentaires sur le forum : [[:url-a-changer | Lien vers le forum concernant ce tuto]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))</nowiki> | ||
+ | |||
+ | Elle est destinée à recevoir le lien vers le sujet du forum permettant les retours. C'est à vous de créer le sujet dans la section [[http://debian-facile.org/viewforum.php?id=26|DebianDocs(wiki) et Projet-df(git)]] du forum et de compléter l'en-tête du tuto. | ||
+ | |||
+ | === Tags === | ||
+ | |||
+ | Pour faciliter le suivi d'un tuto, il est important de maintenir ses tags à jour. | ||
+ | On place les tags d'un tuto dans l'en-tête ou juste en dessous de la ligne de titre, via la syntaxe suivante : | ||
+ | <nowiki> * Suivi : {{tag>en-chantier à-tester à-placer}}</nowiki> | ||
+ | |||
+ | S'il y a plusieurs tags, ils peuvent être listés séparés par des espaces : | ||
+ | {{tag>mon-tag1 mon-tag2 mon-tag3}} | ||
+ | |||
+ | | Pour marquer un tuto comme | rajouter le tag | | ||
+ | | À créer | ''à-créer'' | | ||
+ | | En chantier | ''en-chantier'' | | ||
+ | | À tester | ''à-tester'' | | ||
+ | | À placer | ''à-placer'' | | ||
+ | | À compléter | ''à-compléter'' | | ||
+ | | À corriger | ''à-corriger'' | | ||
+ | | Obsolète | ''obsolète'' | | ||
+ | |||
+ | Par exemple, pour un nouveau tuto, il faut veiller à ce que soit présente la ligne | ||
+ | {{tag>en-chantier à-tester à-placer}} | ||
- | Merci également de suivre les conventions suivantes : | ||
- | * On utilise ''apt-get'' plutôt qu' ''aptitude'' autant que possible. | ||
- | * On n'utilise pas d' ''apt-url'', c'est tabou, ça tue des chatons à coup de cuillère en bois. | ||
- | * On limite au maximum l'utilisation des dépôts externes, ou alors on prévient des dangers de sécurité qu'ils amènent. | ||
- | //N'hésitez pas à demander conseil aux modos et rédacteurs habitués !// | ||
===== Comment aider à améliorer le WiKi ===== | ===== Comment aider à améliorer le WiKi ===== |