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 [22/09/2013 22:10] bendia [Prérequis] |
atelier:atelier [23/09/2013 06:40] smolski [Création et modification des pages] |
||
|---|---|---|---|
| Ligne 12: | Ligne 12: | ||
| 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//. | 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//. | ||
| + | ===== Création et modification des pages ===== | ||
| + | |||
| + | |||
| + | === 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> | ||
| + | |||
| + | |||
| + | ==== Modifier une page existante ==== | ||
| + | |||
| + | Avant de créer une page dans le wiki, __afin de ne pas créer de doublon__, vérifier TOUJOURS par une petite recherche qu'elle n'existe pas déjà. \\ | ||
| + | Si la page existe, vous pouvez la modifier pour l'améliorer ou la mettre à jour. \\ | ||
| + | |||
| + | <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 dans cette section du forum (sans oublier de le reporter aussi dans l'en-tête **url** de la page du wiki).</note> | ||
| + | |||
| + | Si la page du Wiki n'existe pas //Taïaut//, créez-là dans l'atelier ! \\ | ||
| + | Voir ci-dessous : | ||
| + | |||
| + | ==== Nouvelle page du wiki ==== | ||
| + | |||
| + | Pour créer une nouvelle page, rien de plus simple : \\ | ||
| + | Dans la page [[atelier:chantier:]] remplissez la case de création avec seulement le nom du tuto puis cliquer sur créer. \\ | ||
| + | Il ne vous restera plus qu'à la rédiger et à l'enregistrer. \\ | ||
| + | En cours de rédaction, toutes les pages sont automatiquement listées par ordre alphabétique et restent disponiblent aux ajouts et corrections sur la page chantier ! 8-) | ||
| + | |||
| + | Le tuto terminée ou considérée publiable, indiquez-le sur le forum à la rubrique [[http://debian-facile.org/viewforum.php?id=26 | DebianDocs(wiki) et Projet-df(git)]] et un modérateur se chargera de le placer définitivement //pile poil// dans l'[[arborescence]] du wiki. :-) | ||
| + | |||
| + | === Modèles de page === | ||
| + | |||
| + | <note important>Utiliser obligatoirement les tutos type, car ils contiennent la structure de base et les **méta-données nécessaires** pour la bonne organisation du wiki. | ||
| + | </note> | ||
| + | |||
| + | 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, nous avons créé un modèle particularisé pour certains logiciel vous permettant de faire des pages TP plus simplement. \\ | ||
| + | Ces modèles sont listés ci-dessous et sont à copier/coller en lieu et place de la totalité du modèle par défaut : | ||
| + | |||
| + | * [[:atelier:template-tuto|Tuto type généraliste]] (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 TP tuto pour Gimp) | ||
| + | * //Autres tutos type à la demande...// | ||
| + | ===== Comment bien rédiger ===== | ||
| + | |||
| + | ==== Conseils de rédaction et conventions ==== | ||
| + | |||
| + | 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. | ||
| + | |||
| + | Lors de la rédaction de votre page, | ||
| + | |||
| + | * pensez à faire simple et généraliste pour faciliter son adaptation aux futures versions de Debian | ||
| + | * 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 | ||
| + | |||
| + | 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 !// | ||
| + | |||
| ==== Syntaxe du wiki ==== | ==== Syntaxe du wiki ==== | ||
| Ligne 61: | Ligne 121: | ||
| - | ===== Création et modification des pages ===== | ||
| - | |||
| - | ==== Modifier une page existante ==== | ||
| - | |||
| - | 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. | ||
| - | |||
| - | <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> | ||
| - | |||
| - | Si la page du Wiki n'existe pas encore, il faudra la créer : | ||
| - | |||
| - | ==== 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, il liste d'ailleurs les pages en cours de rédaction. | ||
| - | |||
| - | 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. | ||
| - | |||
| - | === 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> | ||
| - | |||
| - | 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 : | ||
| - | |||
| - | * [[: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) | ||
| - | |||
| - | ==== Conseils de rédaction ==== | ||
| - | |||
| - | 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. | ||
| - | |||
| - | Lors de la rédaction de votre page, | ||
| - | |||
| - | * pensez à faire simple et généraliste pour faciliter son adaptation aux futures versions de Debian | ||
| - | * 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 | ||
| - | |||
| - | 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 ===== | ||
| Ligne 112: | Ligne 127: | ||
| Pour voir l'[[:atelier:qa | état du wiki, c'est ici !]] | Pour voir l'[[:atelier:qa | état du wiki, c'est ici !]] | ||
| + | ===== Statistiques sur le Wiki ===== | ||
| - | ==== Contributions et licence ==== | + | Les statistiques du wiki sont (seront) accessibles ici : [[:atelier:stats]]. |
| - | + | ||
| - | <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> | + | |
| - | + | ||
