French/Comment éditer le Wiki

From DPWiki
Jump to: navigation, search

Vous pouvez éditer pratiquement toutes les pages sur le wiki de DP, y compris cette page-ci.

Commencer à éditer

Avant d'éditer un acticle, il faut être logé sur le wiki. A priori il faut utiliser le même login et mot de passe que sur le site principal.

Nota: si votre identifiant sur DP contient un caractère souligné "_", vous devez envoyer un email à db-req at pgdp dot net avant votre première connexion au wiki.

Avant de se lancer pour la première fois à modifier des articles, il est également conseillé de faire un essai sur le bac à sable.

Tout article se modifie en cliquant sur le lien Edit, dans la barre grise en haut de l'écran. On voit alors le code source de la page, dans un cadre de texte éditable. Lorsqu'il s'agit d'une longue page, on peut modifier uniquement un paragraphe d'une longue page en cliquant sur le lien Edit à hauteur de la première ligne du paragraphe, sur la droite.

Le code source contient à la fois le texte de la page, et certaines indications de marquage pour représenter des liens, des caractères gras, etc. Tout ce qui n'est pas reconnu par le système comme étant une marque de formatage (les plus fréquentes sont décrites plus bas) apparaîtra tel quel dans dans le rendu final de la page. Les retours à la ligne dans le code source correspondent à de nouveaux paragraphes.

Tant que vous ne cliquez pas sur le bouton Save Page (enregistrer la page), aucune modification n'est effectuée sur la page de départ. Vous pouvez utiliser le bouton Show Preview pour voir à quoi ressemblerait la page une fois sauvée (c'est à dire pour voir le rendu final, et non le code source) mais sans modifier la page de départ. N'oubliez pas d'enregistrer la page quand vous êtes satisfait du rendu, pour ne pas perdre votre travail sur cette page. Avant d'enregistrer la page, n'oubliez pas de remplir le champ destiné à contenir une description brève des changements effectués.

Comment accéder à un manuel plus complet

Il y a sûrement des instructions en français quelque part sur internet. Voici le manuel en anglais, hébergé en-dehors du site DP. Certaines choses décrites dans les autres wiki ne sont pas activées ici, et par ailleurs nous avons des extensions qui nous sont propres et qui n'existent pas nécessairement ailleurs.

Formater et organiser le texte

Gras et italiques

Du texte entre ''deux'' guillemets simples s'affiche en italiques, et entre '''trois''' en caractères gras. En combinant les deux, du texte entre '''''cinq''''' guillemets apparaît en gras italique.

Indentation

En mettant un deux-points au début du paragraphe, on l'indente:

ceci est un paragraphe indenté avec un ':'.
Ceci est indenté avec deux '::'.

Un espace devant le paragraphe crée une sorte de bloc de citation pour insérer du code:

example
     de bloc
 où toutes les lignes
   sont indentées d'au moins un espace

Sections et titres

On utilise des signes "égal" (=) pour créer des titres (et par la même occasion, une sous-section sous ce titre).

En général on utilise des titres de niveau 2 ==Comme ceci== pour les titres principaux dans une page, et les niveaux suivants (3 ou plus) pour les divisions plus fines.

S'il y a plus de quatre titres sur une page, par défaut une table des matières apparaît automatiquement.

Table des matières

  • __NOTOC__ en tête de page empêche l'apparition d'une table des matières par défaut;
  • __FORCETOC__ en tête de page force l'apparition d'une table des matières juste avant le premier titre dans la page, même s'il y a moins de quatre titres;
  • La mention __TOC__ quelque part dans la page force la présence de la table des matières à l'endroit de la mention, même s'il y a moins de quatre titres dans la page.

Il y a également des Templates spéciales. Par exemple:

  • {{TOC Compact A-Z}} ajoute une table des matières d'une ligne pointant sur des sections nommées A, B, C, ... Z;
  • {{TOC Compact Month28}} pour des sections nommées 1st, 2nd, ... 28th;
  • de même pour {{TOC Compact Month29}} {{TOC Compact Month30}} et {{TOC Compact Month31}}

Le détail est ici.

Listes

On fait une liste non ordonnée avec des astérisques:

* papier
* caillou
* ciseaux

qui produit ceci:

  • papier
  • caillou
  • ciseaux


On fait une liste ordonnée avec des caractères dièze (#):

# envelopper le caillou dans le papier
# essayer de couper le tout avec les ciseaux
# constater que la paire de ciseaux est fichue

qui produit ceci:

  1. envelopper le caillou dans le papier
  2. essayer de couper le tout avec les ciseaux
  3. constater que la paire de ciseaux est fichue


On peut imbriquer des listes:

* Non ordonné A
*# Ordonné A.1
*# Ordonné A.2
* Non ordonné B
*# Ordonné B.1
*#* De nouveau non ordonné!
*# Ordonné B.2

qui produit ceci:

  • Non ordonné A
    1. Ordonné A.1
    2. Ordonné A.2
  • Non ordonné B
    1. Ordonné B.1
      • De nouveau non ordonné!
    2. Ordonné B.2

Nota: Attention à ne pas laisser de lignes vides dans une liste. Une ligne vide signifie un nouveau bloc, ce qui a pour effet dans une liste de recommencer la numérotation au début.


Les listes avec définitions mettent en jeu des point-virgules et des signes deux-points:

;bidule-truc: un machin qui tient du truc et du bidule.

produit ceci:

bidule-truc
un machin qui tient du truc et du bidule.

Les liens

Liens externes

Il suffit d'utiliser un jeu de [crochets] simples pour insérer un lien en dehors du wiki DP: on ajoute l'URL du lien, suivie par un espace, suivie par le texte par lequel on veut que le lien s'affiche.

Exemple: [http://www.pgdp.net Distributed Proofreaders] devient: Distributed Proofreaders.

Liens internes

On utilise des [[crochets en double]] pour lier vers une autre page du wiki. Ainsi [[Main Page]] pointe vers Main Page, la page principale du Wiki.

Pour faire apparaître un lien avec un texte différent, on sépare le texte du lien lui-même avec un caractère barre verticale '|': Par exemple [[Main Page|la page principale]] pointe vers la page principale.

Pour lier vers une section particulière de la page, on utilise un dièze '#'. Par exemple [[French/Jargon#DP|ce lien]] crée ce lien.

Quand on pointe vers une autre section de la même page, on peut mettre directement le dièze '#' sans le nom de la page: [[#Liens internes|liens internes]] pointe sur la section des liens internes.

On peut créer un lien sans que la page pointée par le lien n'existe. Les liens vers des pages inexistantes apparaissent en rouge comme ceci: Une page inexistante (sauf évidemment si quelqu'un crée une page nommée "Une page inexistante").

Liens spéciaux

Nous avons nos raccourcis pour pointer sur du contenu propre au site DP. Il est conseillé d'utiliser ces liens dans la mesure du possible, car cela facilite une mise à jour ultérieure en cas de maintenance ou d'évolution du site.

Forum

  • [[forumpost:169435]] pour le 'post' de forum numéro forumpost:169435 (on récupère le numéro qui est après ?p=XXXX dans l'URL du post);
  • [[forumtopic:4321]] pour le fil de discussion numéro forumtopic:4321 (on récupère le numéro qui est après ?t=XXXX dans l'URL du fil de discussion). Accessoirement c'est ici le forum de discussion de l'équipe "En français".

Message privé

Pour créer un lien permettant d'envoyer un message privé, faire: [[pm:numéro|pseudo]], où le numéro est le nombre en &u=XXXX dans l'URL de message privé.

Pages du site DP principal

On peut pointer vers toute page dont l'URL commence par http://www.pgdp.net/c/XXXXX en utilisant le raccourci [[dp:XXXXX]]. Par exemple:

Il existe d'autres racourcis, et notamment:

  • [[round:P2]] round:P2, un lien vers la page P2.
  • [[pool:PP]] pool:PP, un lien vers le pool PP.
  • [[projectpage:projectID40a3ec003c577|Travels in China]] produit un lien vers la page du projet Travels in China
  • On peut également afficher des détails du projet ainsi: <projectinfo id="projectID40a3ec003c577">%title% dans l'état %state%</projectinfo> qui donne:

    Travels in China dans l'état Completed and Posted to Project Gutenberg

(voir aussi DPWiki:Magic tags pour plus de détail).

  • [[dpuser:Dr Gutenstein]] pointe vers la page des détails de l'utilisateur dpuser:Dr Gutenstein
  • [[team:Team Colorado]] pointe vers la page de l'équipe team:Team Colorado
  • [[task:500]] pointe sur la tâche task:500 dans le système de suivi des bugs et tâches de développement.

Divers

On peut insérer automatiquement son pseudo et/ou la date en utilisant des tildes:

  • trois tildes ~~~ insèrent le pseudo: Lvl
  • quatre tildes ~~~~ insèrent le pseudo et la date: Lvl 13:03, 5 May 2008 (PDT)
  • cinq tildes ~~~~~ insèrent uniquement la date d'édition: 13:03, 5 May 2008 (PDT)

Certaines notations HTML sont également supportées ici. Par exemple <code>...</code> affiche du code source dans une police particulière (également <b> pour le gras, <i> pour les italiques, ...).

Comme de nombreux caractères ont des significations particulières en syntaxe wiki, pour saisir des caractères spéciaux comme ~, [, etc. on peut les entourer par <nowiki>...</nowiki>. En dernier recours, on a toujours la possibilité de spécifier des caractères par leur entité HTML, comme par exemple &lt; (<).

Images

On peut insérer des images en faisant [[image:truc.png|légende]]. Il faut au préalable avoir chargé l'image sur le wiki en utilisant le formulaire Upload File.

"Transclusion"

La Transclusion permet de copier du texte depuis une autre page, afin d'éviter de maintenir du texte en double.

Le Jargon utilise cette technique.

J'utilise également cela pour noter les passages à revoir lorsque je fais une premiere version d'une page wiki. J'ajoute {{:French/En chantier}} à l'endroit à améliorer, ce qui inclut la partie de cette page destinée à l'inclusion, en l'occurrence ceci:
Chantier.png
En allant plus tard dans la page French/En chantier elle-même, le lien What links here affiche toutes les pages incluant cette mention. Lvl 14:15, 5 May 2008 (PDT)

Voir plus de détails dans la version anglaise.

Créer une page

Imaginons que vous voulez ajouter une information qui ne se trouve pas bien à sa place dans l'une des pages existantes. La meilleure façon de créer une page est d'insérer un lien vers la page à créer depuis une autre page.

L'autre façon est de saisir directement l'URL, par exemple http://www.pgdp.net/wiki/Nouvelle_Page, et de cliquer sur le lien Edit this page.

Sous-pages

On peut regrouper les pages liées à un même sujet en créant une structure arborescente similaire aux répertoires de fichiers, et en utilisant '/' dans le nom de page.

Par exemple, depuis la page Series By Multiple Authors , on peut pointer vers la sous-page "Series By Multiple Authors/English Men of Letters" en ajoutant le lien [[/English Men of Letters]]. La sous-page a automatiquement en tête un lien vers la page du dessus, pour mieux s'y retrouver.

Convention de nommage des pages

Pour les pages dont le nom est préfixé par "French/", afin d'éviter les problèmes de majuscules je vous propose d'utiliser cette convention:

  1. le nom est en minuscule, sauf la première lettre qui est en majuscule:
    • exemple "French/Conditions d'accès" (et non "French/Conditions D'Accès" ou "French/conditions d'accès")
  2. si le début du nom est un acronyme, on le met alors tout en majuscules:
    • exemple "French/PNG" (et non "French/Png")
  3. néanmoins si le nom est un nom sensible à la casse (par exemple, un identifiant d'utilisateur DP), on ne change pas sa capitalisation:
    • exemple "French/dp-feedback" (et non "French/DP-feedback")

Voici la liste de toutes les pages dans "French/".

Déplacer/renommer une page

Il faut utiliser le bouton Move.

Détruire une page

Pour détruire une page, il suffit d'ajouter {{delete}} en haut de cette page. Cela n'efface pas directement la page, mais ça l'inclut dans une liste de page qui sera à terme effacée par un administrateur.

Ajoutez une raison (en anglais, de préférence) pour laquelle cette page doit être détruite, sous le {{delete}} (et non dans le descriptif de changement), sauf pour les cas vraiment évidents.

Voir aussi sur DPWiki:Deleting and Merging comment fusionner deux pages, en redirigeant l'une des pages vers l'autre.

Obtenir de l'aide!

Posez les questions sur ce forum, ou envoyez un message à lvl.