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.
| 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 [19/09/2013 18:23] captnfab [Participer à la documentation du site Debian Facile.] |
atelier:atelier [22/09/2013 11:46] captnfab [Comment aider à améliorer le WiKi] |
||
|---|---|---|---|
| Ligne 3: | Ligne 3: | ||
| 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. | 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. | ||
| - | Pensez à lire le paragraphe [[#contribution_et_licence | contributions et licence]] afin de vérifier que vous êtes en accord avec la politique de partage de la connaissance de DF. :) | + | ===== Prérequis ===== |
| + | |||
| + | ==== Licence ==== | ||
| + | |||
| + | 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. :) | ||
| ==== Créer un compte et se connecter ==== | ==== Créer un compte et se connecter ==== | ||
| - | Tout d'abord, 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//. | + | 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//. |
| + | |||
| + | ==== Syntaxe du wiki ==== | ||
| + | |||
| + | 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. | ||
| + | |||
| + | * [[syntaxe|La syntaxe de Dokuwiki]] | ||
| + | * [[bac-a-sable | Le bac à sable pour vous entrainer à rédiger sur le Wiki]] | ||
| + | |||
| + | === Insérer une image dans le wiki === | ||
| + | |||
| + | 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 +. | ||
| + | |||
| + | * [[tuto: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}} | ||
| + | |||
| + | |||
| + | ===== Création et modification des pages ===== | ||
| ==== Modifier une page existante ==== | ==== Modifier une page existante ==== | ||
| Ligne 19: | Ligne 73: | ||
| ==== Créer une nouvelle page dans le wiki ==== | ==== Créer une nouvelle page dans le wiki ==== | ||
| - | Pour créer une nouvelle page, rien de plus simple. Le dossier [[atelier:chantier:]] du wiki est là pour ça. | + | 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. |
| - | Imaginons que vous vouliez créer une page concernant le logiciel ''hello'', dans ce cas, la page du wiki doit se nommer ''hello''. Pour la créer, allez à l'adresse qu'elle aura une fois créée, c'est à dire ''http://wiki.debian-facile.org/atelier:chantier:hello'', puis cliquez sur **Créer cette page**. | + | |
| - | C'est également à cette adresse que vous devrez aller pour modifier votre page. | + | |
| + | Entrez le nom de la page ici et valider : {{NEWPAGE>atelier:chantier}} | ||
| + | |||
| + | \\ | ||
| 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. | 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. | ||
| - | ==== Modèles de page ==== | + | === Modèles de page === |
| <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 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. | ||
| Ligne 46: | Ligne 101: | ||
| Merci également de suivre les conventions suivantes : | Merci également de suivre les conventions suivantes : | ||
| - | * On utilise ''apt-get'' plutôt qu'''aptitude'' autant que possible. | + | * 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 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. | * 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 !// | //N'hésitez pas à demander conseil aux modos et rédacteurs habitués !// | ||
| - | |||
| - | ==== Syntaxe du wiki ==== | ||
| - | |||
| - | Une aide à la syntaxe est disponible ici [[http://wiki.debian-facile.org/wiki:syntax]] | ||
| - | |||
| - | === Insérer une image dans le wiki === | ||
| - | |||
| - | 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 +. | ||
| - | |||
| - | * [[tuto:insertion_image| Images dans le wiki]] La méthode pas à pas. | ||
| - | |||
| - | === Aide DocuWiki === | ||
| - | |||
| - | Pour plus d'informations, consultez la page d'aide à la syntaxe et entraînez-vous si besoin dans le bac-à-sable. | ||
| - | * [[syntaxe|La syntaxe de Dokuwiki]] | ||
| - | * [[bac-a-sable | Le bac à sable pour vous entrainer à rédiger sur le Wiki]] | ||
| ===== Comment aider à améliorer le WiKi ===== | ===== Comment aider à améliorer le WiKi ===== | ||
| Ligne 72: | Ligne 111: | ||
| 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. | 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. | ||
| - | ==== Utilisation des tags ==== | + | Pour voir l'[[:atelier:qa | état du wiki, c'est ici !]] |
| - | + | ||
| - | 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 : | + | |
| - | {{tag>mon-tag}} | + | |
| - | + | ||
| - | 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}} | + | |
| ==== Contributions et licence ==== | ==== Contributions et licence ==== | ||
| <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 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> | ||
| - | |||
| - | ==== Tâches à faire ==== | ||
| - | |||
| - | === Tutos à créer === | ||
| - | 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]] | ||
