ATTENTION : PAGE EN COURS DE TRADUCTION
La version originale en anglais date du 3 mars 2008
Cette page fournit des conseils pour les personnes désirant éditer le contenu de wiki.debian.org.
Vous trouverez ici une introdution [:DebianWiki/EditorQuickStart:?QuickStart] pour les nouveaux contributeurs.
Si vous cherchez une aide sur les formats de "moinmoin wiki", lisez les pages moinmoin's ["SommaireDeL'Aide"] (dans le menu latéral). Le ["RésuméDeLaSyntaxe"] est pratique. Vous pouvez vous entrainer dans le ["BacÀSable"].
Si vous n'êtes pas d'accord avec le contenu ci-dessous, vous pouvez le transformer en commentaire et commencer une nouvelle discussion dans la pade de [:DebianWiki/ConventionsDiscussion:discussion].
?TableOfContents(2)
?Anchor(compte)
votre compte
Votre nom d'utilisateur devrait être au format "PrénomNom" ("IrcSurnom" ou le login de Debian developer sont aussi utilisés).
N'oubliez pas de paramétrer votre fuseau horaire dans votre page ["?UserPreferences"]
votre page d'accueil Wiki
Vous pouvez utiliser le modèle de page HomepageTemplate quand vous créez votre page d'accueil. Vous trouverez ici des idées pour cette page, puisées dans différentes pages existantes.
- Votre nom complet.
- Votre page d'accueil hors de ce wiki.
- Votre adresse électronique.
Votre localisation (ville et pays) utile pour le fuseau horaire et plus .
- Si vous utilisez IRC, indiquez votre serveur habituel, votre canal et votre surnom.
Si vous êtes un Développeur Debian (DD), donnez votre login + un lien vers http://qa.debian.org/developer.php?login=foobar@debian.org
Sinon vous pouvez mettre un lien vers http://bugs.debian.org/from:toto@foo.com
- Listez les sujets qui vous intéressent (sans vous limiter à Debian.)
- Créez une liste à faire/fait
- Inidiquez (quelques unes de) vos contributions à des projets open source (travail sur les bugs ; écrits/traductions ; développement/maintien...)
Assurez vous d'ajouter une Catégorie Homepage au bas de votre page d'accueil.
Souscrire à des pages
- Vous pouvez souscrire à des pages qui vous intéressent.
?Anchor(mot de passe perdu)
mot de passe perdu
Si vous perdez votre mot de passe wiki.debian.org, allez sur la page ["?UserPreferences"], ensuite suivez les instructions (tapez votre email, puis cliquez sur ?GetText(Mail me my account data)...)
?Anchor(style-f)
Style d'écriture/ Étiquette Wiki
Voici les cinq styles principaux d'une page Wiki
[:TreeMode:LeModeArborescence] (en anglais)
[:DocumentMode:LeModeDocument] (en anglais)
[:ThreadMode:LeModeFil] (en anglais)
[:NewsMode:LeModeInformation] (en anglais)
[:CategoryHomepage:LaCategoriePageDAccueil] (en anglais)
Vous trouverez des éléments d'explications pour chaque type de style sur leurs pages dédiées.
Essayez de conserver un équilibre quand vous écrivez, c'est à dire un équilibre visuel. Évitez de prendre partie. Si vous trouvez que vos commentaires sont discutables, signez les. Ainsi d'autres contributeurs se sentiront plus libres d'exprimer leur désaccord.
- Ne cherchez pas à créer une entrée Wiki pour chaque terme. Savoir quand créer une nouvelle page est la difficulté du style Wiki.
RetravaillerImpitoyablement Il n'y a aucune page de l'univers Wiki qui soit terminée. Tout le contenu peut être amélioré. Voir RefactoringWikiPages (en anglais) pour des idées intéressantes.
Si le sujet du wiki est vraiment long, alors il peut être intéressant de donner un résumé du contenu dans le paragraphe final. S'il est difficile d'écrire ce dernier, alors il faudrait éventuellement penser à scinder le sujet en plusieurs parties ou à le regrouper avec d'autres sujets. C'est courant quand le [:ThreadMode:LeModeFil] (en anglais) erre hors sujet.
voir aussi la page GoodStyle (en anglais).
?Anchor(liens)
Liens
N'abusez pas des liens hypertexte. Le lecteur ne va pas savoir quel lien est utile et lequel ne l'est pas. Vous pouvez également placer des liens dans le pied de page [#footer "See also"] mais n'en abusez pas.
Supposons que votre page est nommée correctement "lien titre" = "nom de page".
Si un lien est dans un paragraphe, il peut changer de format : en minuscules, séparé par des espaces, et raccourci si le contexte est clair. Exemple : [:ExempleLong/NomDePage:nom de page] .
Un lien qui n'est pas dans un paragraphe, comme une liste de liens Voir aussi, devrait être laissée intacte. ["NomDePage"] (Ne changez pas le nom en [:NomDePage:Autre titre].
- Lien pointant vers une page dans une autre langue, ajouter "(en langue)", par exemple
[:DE/EtwasInDeutsch:QuelqueChoseEnFrançais] (en allemand)
Voir aussi : l'aide moinmoin ["?AideSurLesLiens"] (en anglais)
?Anchor(liens-internes)
Liens internes
Liens internes (dans ce wiki)
["PageToto"] est normalement la syntaxe préférée.
[:SomeParentPagewith/TotoPage:TotoPage] est fréquemment utilisé pour atteindre les sous-pages.
[:EditorGuide:editor guide] peut-être utilisé dans une phrase pour la rendre plus lisible.
Dans tous les cas, assurez vous que le nom du lien est compréhensible pour les visiteurs, ainsi il ou elle peut atteindre ce qu'il ou elle attend (de préférence, le lien devrait être le même que le titre de la page).
Pour un lien à l'intérieur d'une page, vous devez définir une cible en utilisant[[Anchor(foo)]] (voir ["HelpOnMacros"] (en anglais), puis utilisez[#toto Chapitre foo] ou[:Toto#toto:Chapitre Toto ].
?Anchor(lien-vers-www)
Lien vers des sites extérieurs
La meilleur façon de créer un lien vers un document externe est :
[http://www.debian.org/doc/] - Dossier Officiel de la documentation.
(évitez la notation} car la cible n'est pas transparente pour les visiteurs. Par contre, vous pouvez l'utiliser quand le contexte est explicite, par exemple : John Doe fournit un script appelé [http://www.johndoe.org/test.sh test.sh].)
- Groupez les liens externes dans la dernière section de la page.
Appelez cette section Liens externes.
La page d'accueil se trouve dans Liens externes (ou les sections Voir aussi de la page s'il n'y a pas de section liens externes)
Utilisez le format ["InterWiki"] (en anglais) pour créer un lien vers packages.debian.org, bugs.debian.org, RFC and Wikipedia.
?Anchor(liens-depuis-www)
Liens depuis des sites externes
Si une page (importante) de ce wiki se trouve référencée dans une page extérieure, il peut être intéressant de la marquer avec CategoryPermalink (en anglais). Ainsi personne ne la supprimera par inadvertance.
?Anchor(formating)
Formating
La traduction des autres sections est en cours et sera actualisée régulièrement. N'hésitez pas à améliorer les sections déjà traduites.