Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
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.
| Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
|
atelier:atelier [19/09/2013 15:10] kao création de la page acceuil de l'atelier |
atelier:atelier [22/09/2013 22:37] captnfab [Prérequis] |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| ====== Participer à la documentation du site Debian Facile.====== | ====== Participer à la documentation du site Debian Facile.====== | ||
| - | Vous voulez aider DF en participant au WiKi ? Quelle bonne idée vous avez là ! :-) Voici quelques informations pour vous indiquer comment parvenir à vos fins. | + | Vous voulez aider DF((Debian-Facile !)) en participant au WiKi ? Quelle bonne idée vous avez là ! :-) Voici quelques informations pour vous indiquer comment parvenir à vos fins. |
| - | ====Créer un compte==== | + | ===== Prérequis ===== |
| - | Tout d'abord, il vous faudra créer un compte sur le site, si vous n'en possédez pas déjà un. Tout ajout ou modification du wiki demande d'être connecté. \\ | + | |
| - | A noter, que sauf mention contraire, vos contribution à ce wiki seront placé sous les termes de la licence suivante : [[http://www.gnu.org/licenses/fdl-1.3.html | GNU Free Documentation License 1.3]]. | + | |
| - | ====Modifier une page existante==== | + | ==== Licence ==== |
| - | Avant de créer une page, il est important vérifier quelle n'existe pas déjà. Commencez par faire une petite recherche sur ce wiki. Si la page existe, vous êtes libre de la modifier afin de l'améliorer ou tout simplement de la mettre à jour.\\ | + | |
| - | Veuillez tout de même signaler les gros changement, comme une refonte complète de page, dans le forum à la rubrique [[http://debian-facile.org/viewforum.php?id=26 | DebianDocs(wiki) et Projet-df(git)]] en créant un nouveau sujet si nécessaire. | + | Pensez à lire le paragraphe [[#contributions_et_licence | contributions et licence]] afin de vérifier que vous êtes en accord avec la politique de partage de la connaissance de DF. :-) |
| - | Si la page n'existe pas encore, il faudra la créer: | + | ==== Créer un compte et se connecter ==== |
| - | ====Créer une nouvelle page dans le wiki.==== | + | |
| - | Pour créer une nouvelle page, rien de plus simple, indiquez le chemin que vous souhaitez dans votre navigateur internet afin de la placer dans le dossier **atelier**: | + | Afin de pouvoir contribuer, il vous faudra créer un compte sur le forum, si vous n'en possédez pas déjà un. Tout ajout ou modification du wiki demande d'être connecté, ce qui se fait pour l'instant de manière séparée sur le wiki et le forum, mais avec les mêmes //nom d'utilisateur// et //mot de passe//. |
| - | <code>http://wiki.debian-facile.org/atelier:ma-nouvelle-page</code> | + | ===== Création et modification des pages ===== |
| - | Changer le nom :**ma-nouvelle-page** par le nom du logiciel qui vous parez le plus approprié. | + | |
| - | Si cette page n'existe pas déjà, vous pourrez la créer en cliquant sur "Créer cette page" | + | |
| - | Une fois votre page terminé, veuillez signifier que votre page est prête sur le forum à la rubrique [[http://debian-facile.org/viewforum.php?id=26 | DebianDocs(wiki) et Projet-df(git)]]. Un modérateur se chargera de la placer dans l'arborescence du wiki à son emplacement définitif. | ||
| + | === Contributions et licence === | ||
| - | ==== Modèles de page ==== | + | <note info>Toutes vos contribution à ce wiki seront placées sous les termes de la licence suivante : [[http://www.gnu.org/licenses/fdl-1.3.html | GNU Free Documentation License 1.3]] et les droits d'auteurs seront partagés avec l'Association Debian-Facile. Elles ne pourront alors plus être retirées du Wiki sans bonne raison.</note> |
| - | <note important> | ||
| - | Vous ne devez pas créer une page à partir de zéro, mais utiliser comme base l'un de ces tutos type, qui contiennent la structure de base et les méta-données nécessaires à l'organisation du wiki. | ||
| - | </note> | ||
| - | __APRÈS avoir créer la page de votre tuto__ vous pouvez partir d'un des modèles suivant : | + | ==== Modifier une page existante ==== |
| - | * [[manuel:tuto|Tuto type]] (déjà présent par défaut dans le cadre de composition) | + | Avant de créer une page, il est important vérifier quelle n'existe pas déjà. Commencez par faire une petite recherche sur ce wiki. Si la page existe, vous êtes libre de la modifier afin de l'améliorer ou tout simplement de la mettre à jour. |
| - | * [[manuel:tuto_gimp|Tuto type pour Gimp]] (pour la création d'un nouveau tuto pour Gimp) | + | |
| + | <note important>Veuillez tout de même signaler les gros changement, comme une refonte complète de page, dans le forum à la rubrique [[http://debian-facile.org/viewforum.php?id=26 | DebianDocs(wiki) et Projet-df(git)]]. Les pages récentes du wiki disposent déjà d'un tel sujet signalé dans l'en-tête. Si aucun n'est indiqué, vous pouvez en créer un nouveau (sans oublier de l'indiquer dans l'en-tête de la page du wiki).</note> | ||
| - | ==== Syntaxe du wiki ==== | + | Si la page du Wiki n'existe pas encore, il faudra la créer : |
| - | Lors de la rédaction de votre page, pensez à faire simple et généraliste pour faciliter son adaptation aux futures versions de Debian. Une aide à la syntaxe est disponible ici [[http://wiki.debian-facile.org/wiki:syntax]] | + | ==== Créer une nouvelle page dans le wiki ==== |
| - | === Insérer une image dans le wiki === | + | Pour créer une nouvelle page, rien de plus simple. Le dossier [[atelier:chantier:]] du wiki est là pour ça, il liste d'ailleurs les pages en cours de rédaction. Rendez-vous donc sur [[atelier:chantier:]], et créez votre tuto en remplissant son nom et en cliquant sur créer. |
| - | 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 +. | + | Une fois votre page terminé, veuillez signifier que votre page est prête sur le forum à la rubrique [[http://debian-facile.org/viewforum.php?id=26 | DebianDocs(wiki) et Projet-df(git)]]. Un modérateur se chargera de la placer dans l'[[arborescence]] du wiki à son emplacement définitif. |
| - | * [[tuto:insertion_image| Images dans le wiki]] La méthode pas à pas. | + | === Modèles de page === |
| - | === Aide DocuWiki === | + | <note important>Vous ne devez pas créer une page à partir de zéro, mais utiliser comme base l'un de ces tutos type, qui contiennent la structure de base et les méta-données nécessaires à l'organisation du wiki. |
| + | </note> | ||
| - | Pour plus d'informations, consultez la page d'aide à la syntaxe et entraînez-vous si besoin dans le bac-à-sable. | + | Lorsque vous créez une nouvelle page, celle-ci contient déjà un modèle générique de tutos qui convient dans la plupart des cas. Cependant, pour certains logiciels, nous avons créé un modèle particularisé permettant de faire des TP pour celui-ci. Ces modèles sont listés ci-dessous et sont à copier/coller en lieu et place du modèle par défaut : |
| - | * [[http://wiki.debian-facile.org/wiki:syntax|La syntaxe de Dokuwiki]] | + | |
| - | * [[http://wiki.debian-facile.org/playground:playground | Le bac à sable pour vous entrainer à rédiger des Wikis]] | + | |
| - | ===== Comment aider à améliorer le WiKi ===== | + | * [[: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) | ||
| - | Créer une page n'est pas le seul moyen d'aider le Wiki. Plus importante encore est la tâche de maintenir les pages existantes. | + | ==== Conseils de rédaction ==== |
| - | ==== Utilisation des tags ==== | + | 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. |
| - | Pour faciliter le suivi d'un tuto, il est important de maintenir ses tags à jour. | + | Lors de la rédaction de votre page, |
| - | 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 : | + | |
| - | {{tag>mon-tag}} | + | |
| - | S'il y a plusieurs tags, ils peuvent être listés séparés par des espaces : | + | * pensez à faire simple et généraliste pour faciliter son adaptation aux futures versions de Debian |
| - | {{tag>mon-tag1 mon-tag2 mon-tag3}} | + | * 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 | ||
| - | | Pour marquer un tuto comme | rajouter le tag | | + | Merci également de suivre les conventions suivantes : |
| - | | À créer | ''à-créer'' | | + | * On utilise ''apt-get'' plutôt qu' ''aptitude'' autant que possible. |
| - | | En chantier | ''en-chantier'' | | + | * On n'utilise pas d' ''apt-url'', c'est tabou, ça tue des chatons à coup de cuillère en bois. |
| - | | À tester | ''à-tester'' | | + | * 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. |
| - | | À 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 | + | //N'hésitez pas à demander conseil aux modos et rédacteurs habitués !// |
| - | {{tag>en-chantier à-tester à-placer}} | + | |
| - | ==== Tâches à faire ==== | + | ===== Comment aider à améliorer le WiKi ===== |
| - | === Tutos à créer === | + | Créer une page n'est pas le seul moyen d'aider le Wiki. Plus importante encore est la tâche de maintenir les pages existantes. |
| - | Les tutos suivants ont été suggérés par un membre du wiki, mais n'ont pas été créés. | + | |
| - | {{topic>à-créer}} | + | |
| - | + | ||
| - | === Tutos en chantier === | + | |
| - | Les tutos suivant sont en cours de création. | + | |
| - | {{topic>en-chantier}} | + | |
| - | + | ||
| - | === Tutos à tester === | + | |
| - | Les tutos suivants ont été créés mais n'ont pas été testés par quelqu'un d'autre. | + | |
| - | {{topic>à-tester}} | + | |
| - | + | ||
| - | === Tutos à placer === | + | |
| - | Les tutos suivants ne sont pas accessible depuis l'accueil du Wiki, il faut trouver la bonne catégorie où les placer. | + | |
| - | {{topic>à-placer}} | + | |
| - | + | ||
| - | === Tutos à compléter === | + | |
| - | Les tutos suivants gagneraient à être complétés. | + | |
| - | {{topic>à-compléter}} | + | |
| - | + | ||
| - | === Tutos à corriger === | + | |
| - | Les tutos suivants comportent des informations incorrectes. À corriger ou à refaire. | + | |
| - | {{topic>à-corriger}} | + | |
| - | + | ||
| - | === Tutos obsolètes === | + | |
| - | Les tutoriels suivant sont obsolètes, à mettre à jour ou à supprimer. | + | |
| - | {{topic>obsolète}} | + | |
| - | + | ||
| - | === Tuto pas encore taggués (en attente d'être situés) === | + | |
| - | + | ||
| - | * [[tuto:ebook_pour_debutant_qui_debute]] : projet "ebook pour débutant qui débute" | + | |
| - | * [[tuto:ebook_pour_debutant_qui_debute_chap4]] - Utilisation | + | |
| - | * [[tuto:ebook_pour_debutant_qui_debute_bendia1]] - Pourquoi installer Debian | + | |
| - | * [[tuto:ebook_pour_debutant_qui_debute_droits_propriétaires]] - Les bases : Les propriétaires et les droits | + | |
| - | * [[tuto:ebook_pour_debutant_qui_debute_utiliser_gnome]] - Le bureau Gnome | + | |
| - | * [[tuto:ebook_pour_debutant_qui_debute_installation]] - Installer des logiciels | + | |
| - | * [[tuto:ebook_pour_debutant_qui_debute_faq]] - FAQ | + | |
| - | * [[tuto:ebook_pour_debutant_qui_debute_faq]] - FAQ en html | + | |
| - | * [[manuel:shell:refonte]] Ne pas effacer, contient une doc à revoir ! :-) smolski | + | |
| - | * [[tuto:fichiers_bash|Fichiers bash]] : Dépieçage d'un Script LOL devpsp | + | |
| - | * [[manuel:recup_alias]] | + | |
| - | * [[manuel:awesome|Gestionnaire de fenêtres AWESOME]] : Installation - présentation - configuration/personnalisation | + | |
| - | * [[tuto:cle_USB_bootable]] : Création d'une clé USB bootable | + | |
| - | * [[manuel:openvpn_client]] | + | |
| - | * [[manuel:vpn_ssh]] Tuto en cours de **Switch** | + | |
| - | * [[manuel:installation]] : Sommaire des tuto Traitant de l'installation | + | |
| - | * [[tuto:manuel:cut]] | + | |
| - | * [[manuel:installation:par_lan | Installation par le réseau local]] | + | |
| - | * [[manuel:git-df | Le tuto git pour le git-df]] Utilisation de git spécifiquement pour les membres contribuant à des projets df. | + | |
| - | * [[manuel:noyau:experimental | Installation d'un firmware experimental dans wheezy]] TP - Installation d'une carte reseau sur wheezy via la branche experimentale. | + | |
| - | * [[manuel:regexp | Les regexp ou Expressions régulières]] | + | |
| + | Pour voir l'[[:atelier:qa | état du wiki, c'est ici !]] | ||
| + | ===== Statistiques sur le Wiki ===== | ||
| + | Les statistiques du wiki sont (seront) accessibles ici : [[:atelier:stats]]. | ||
