Traduction(s): English - Español - Français - Indonesia - Русский

(!) Discussion


Cette page fournit des conseils pour les personnes désirant éditer le contenu de wiki.debian.org.

Vous trouverez ici une introduction 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 entraîner 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 page de discussion.

votre compte

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.

Assurez-vous d'ajouter une Catégorie Homepage au bas de votre page d'accueil.

Souscrire à des pages

mot de passe perdu

Si vous perdez votre mot de passe wiki.debian.org, allez sur la page userprefs, ensuite suivez les instructions (tapez votre email, puis cliquez sur Mail me my account data...)

Style d'écriture/ Étiquette Wiki

Voici les cinq styles principaux d'une page Wiki

Vous trouverez des éléments d'explication 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.

voir aussi la page GoodStyle (en anglais).

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 "See also" mais n'en abusez pas.

Supposons que votre page est nommée correctement "lien titre" = "nom de page".

Voir aussi : l'aide moinmoin ?AideSurLesLiens (en anglais)

Liens internes

Liens internes (dans ce wiki)

  1. ["PageToto"] est normalement la syntaxe préférée.

  2. [:SomeParentPagewith/TotoPage:TotoPage] est fréquemment utilisé pour atteindre les sous-pages.

  3. [: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 (elle) peut atteindre ce qu'il (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]].

Lien vers des sites extérieurs

La meilleure façon de créer un lien vers un document externe est :

(évitez la notation  [[http://www.toto.com|nom du lien]]  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é test.sh.)

Utilisez le format InterWiki (en anglais) pour créer un lien vers packages.debian.org, bugs.debian.org, RFC and Wikipedia.

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.

Format

Entête

Pied de page

une section de FAQ

Une section FAQ typique peut avoir le format suivant :

Q. Comment peut-on XXXX
A1) Vous pouvez XXXX en effectuant les actions YYY.
A2) Vous pouvez XXXX en effectuant les actions ZZZ.

exemple : (remarquez l'espace en début de ligne)

 Q. Comment peut-on XXXX :: A1) Vous pouvez XXXX en effectuant les actions YYY.
 :: A2) Vous pouvez XXXX en effectuant les actions ZZZ.

Table des matières

Quand un article est long, il peut être intéressant de créer une table des matières. Vous trouverez un exemple au début de cette page !

exemple : (remarquez comment la table est indentée avec un espace)

 <<TableOfContents(2)>>

Entête pour homonymes

Quelquefois un nom de page peut correspondre à plusieurs sujets. Si vous ne pouvez pas trouver de solution à ce problème, vous pouvez insérer un encadré au début de la page :

Homonyme: Cet article traite des Conférences Debian.
Pour le système de gestion de la configuration Debian, voir debconf.

Documentation Debian Officielle

Souvent, le contenu d'un article du Wiki Debian est aussi traité dans la Documentation Debian "officielle" (ou sur un autre site de "référence"). La page du Wiki peut être utile pour un travail de groupe. Dans ce cas c'est une bonne idée d'ajouter un lien vers le site de référence en haut de la page.

Exemple de présentation de lien vers une page officielle, concernant notre sujet.

La licence du logo est décrite dans : Portal/IDB#debian-official-doc-modif-fpiat.

Extraits de page

Un extrait de page peut être réutilisé (ce n'est pas seulement valable pour le code) ! Si vous remarquez qu'une partie d'un paragraphe doit être répétée sur plusieurs pages, vous pouvez réutiliser (inclure) un extrait de page à chaque fois. (N'en abusez pas ! Ne dupliquez pas du contenu partout !)

Vous trouverez un exemple sur installer Debian sur ou sur la phiolsophie de installer Debian sur (en anglais). Remarquez aussi comment la page est incluse sans un tableau (mais n'utilisez pas cette astuce pour outrepasser les limites des formats de moinmoin : voir Format complexe).

Format avancé / Format complexe

EVITEZ d'utiliser des formats avancés comme des tableaux, des inclusions, etc.

Image, Media et pièces jointes

Voir aussi: moinmoin's aide sur les liens (en anglais).

## attachements :
##  openlogo-100.jpg  Copyright:1999 "Software in the Public Interest" from http://www.debian.org/logos/openlogo-100.jpg

Emplacement de la pièce jointe

Où doit-on placer une image en pièce jointe ?
Il peut être intéressant de joindre une image dans une page principale (au cas où elle serait réutilisée dans des pages annexes).
Pour les pages de traduction, joindre l'image à la version anglaise (les images internationalisées/localisées devraient être jointes aux pages internationalisées/localisées).

Screenshots

Si vous utilisez une capture d'écran (screenshot) pour montrer l'interface d'un logiciel, Il est préférable d'utiliser celle de http://screenshots.debian.net/ :

Example:

Position des images

http://www.debian.org/logos/openlogo-nd-75.jpg

Il est possible de placer une image sur la droite de la page, avec la propriété float:right de CSS :

||<tablestyle="float:right; width:100px; background:transparent; margin: 0 0 1em 1em;" style="padding:0.5em; border-style:none;"> {{http://www.debian.org/logos/openlogo-nd-75.jpg}} ||

Signalement 'Work needed'

Utilisation des catégories

{i} ?CategoryRedondante : ?une page redondante, ?une autre page redondante

Utilisation des signalements

voir WikiTag (en anglais)

Remarque: ne pas utiliser les 'processing instruction' qui sont #obsolètes, car cela évite d'autres éditions de la page, comme entre autres, réparer un lien périmé. Si vous cherchez une page qui devrait être améliorée/supprimée, utilisez plutôt un signalement approprié.

Pages

URL / convention de nommage de page

Créer une page

Avant de créer une page vous devez vous poser quelques questions :

Si vous décidez de continuer :

Voir aussi : l'aide sur la création de page de moinmoin (en anglais).

Renommer une page

Les URIs cools ne changent pas (w3). Cependant, parfois, il peut être intéressant de renommer une page quand son nom ne correspond pas parfaitement au sujet qui y est traité.

Avant de renommer une page :

Si vous décidez de renommer la page :

Attention : Si vous pensez qu'il faut créer une redirection, mieux vaut peut-être ne pas changer le nom de cette page !

Supprimer une page

Lisez les remarques de Renommer une page, car elles s'appliquent ici aussi.

Si vous pensez qu'une page doit être supprimée, vous pouvez :

Fusionner et partitionner des pages

C'est une bonne idée, il est conseillé de :

Rediriger des pages

Dans certains cas, vous pouvez vouloir créer une page de redirection (qui va rediriger automatiquement le navigateur vers la bonne page).

exemple :

#redirect PageDeDestination
allez sur ["PageDeDestination"]

Si la page a été déplacée, vous pouvez utiliser :

Remarque : la fonction #refresh est ou n'est pas activée sur ce Wiki.

Catégories

L'aide de moinmoin pour utiliser des catégories (en anglais).

La liste des catégories utilisées dans ce Wiki est : CategoryCategory.

Portail

Les portails sont des pages qui contiennent des liens vers des articles. Ils permettent de structurer un thème. Ils sont complémentaires de la structure offerte par CategoryCategory et de l'outil intégré de recherche.

Les pages portails devraient être basées sur le modèle PortalTemplate.

N'utilisez pas Edit(GUI) car il risque de détériorer le contenu de certaines pages. L'édition graphique pose problème (en anglais).

Définir un article comme portail

Si vous voulez que votre article devienne un portail, suivez les instructions suivantes :

Base de données Image

Vous pouvez centraliser les images et les logos que vous voulez utiliser dans des portails vers Portal/IDB. C'est utile pour garder une présentation homogène.

Traductions

Le début de chaque paque montre les liens vers les traductions - Voir entête et le modèle standard de page comme exemple.

Les principes:

Synchroniser le contenu

Quelques recommandations :

Rappelez-vous : les liens vers la même page dans les autres langues sont inclus en haut de chaque page. Voir header et DefaultTemplate pour l'exemple.

Traducteurs Wiki

Les personnes impliquées dans la traduction des pages du Wiki Debian peuvent (devraient) ajouter CategoryWikiTranslator au bas de leur page d'accueil.

Aider wiki.debian.org

Tout le monde peut aider à améliorer wiki.debian.org :

Debian a aussi besoin de compétences en dehors du domaine des TIC (droit ; marketing ; organisation d'événements ; relation avec la presse et beaucoup d'autres ; lever des fonds).

Voir aussi : http://www.debian.org/intro/help.

Promouvoir l'usage de wiki.debian.org

Le meilleur moyen et le plus simple de promouvoir ce Wiki est de :

  1. l'utiliser.
  2. y ajouter du contenu utile. Gardez à l'esprit le ?Critère de contenu (en anglais).

  3. Quand quelqu'un pose une question dans une mailing list, un forum,un canal irc :
    1. Dirigez-le/la vers un document Debian officiel (www.debian.org/* , man page, README, etc.) mieux
      suggérez des améliorations aux auteurs et aux mainteneurs si nécessaire.

    2. ou mettez à jour la page Wiki pour qu'elle réponde à sa question, puis dirigez-le/la vers cette page. 2nd meilleur choix

Foire Aux Questions

Est-il possible de lister toutes les pages de ce Wiki ?

index des titres

Est-il possible de mieux structurer le Wiki Debian, sans articles orphelins ?

La structure est surestimée. Voir http://c2.com/cgi/wiki?LimitsOfHierarchies (en anglais).

Y a-t-il un moyen de voir seulement les articles orphelins ?

pages orphelines (Ce lien est cassé : les liens de la forme [[NomDePage|Titre Du Lien]] ne sont pas pris en compte).
De plus, Il n'y a rien de mal dans les pages orphelines : les visiteurs peuvent/doivent utiliser la recherche !

Garder les traces des changements

* Pour accéder à la liste des changements récents, ciquez sur le lien RecentChanges dans le menu, accessible n'importe où sur ce wiki (limité à 7 jours pour les visiteurs ; 90 jours pour les utilisateurs connectés).

  • La page History of a page (le nombre de modifications de la liste est limité mais normalement suffisant pour la plupart des pages.)

  • La liste des contributions d'un utilisateur (autant que je sache, moinmoin ne permet pas de visualiser les contributions d'un auteur. Voir les deux options plus haut).

  • Souscrire aux pages : vous pouvez souscrire à une page pour être averti par courriel quand elle est modifiée (vérifiez votre UserPreferences, dans la barre de menu.).

Information technique

Ce Wiki utilise le logiciel moinmoin , version 1.7 (wiki information sur la configuration). Il tourne actuellement sur machine sponsorisée par Dembach Goo Informatik GmbH & Co KG (matériel, hébergement et connectivité).