Help:MediaWiki help policy/fr

Manuel de MediaWiki : I. Lecteurs – II. Éditeurs – III. Administrateurs

Index | Guide pour le manuel | Principes éditoriaux | MediaWiki | +/-

This page is kept for historical interest. Any policies mentioned may be obsolete. If you want to revive the topic, you can use the talk page or start a discussion on the community forum.

Cette page présente les différents problèmes relatifs à l'élaboration du manuel de MediaWiki, par rapport à l'internationalisation, la portabilité et les problèmes de style.

L'espace de nom "Aide:" (ou "Help:", etc.) est réservé pour l'aide du logiciel MediaWiki ; il faut donc éviter d'y écrire du contenu relatif à Wikimedia. Pour ceci, reportez-vous à la page principale.

Le but : que chaque page principale d'aide, dans n'importe quelle langue, soit sur Meta. Ainsi, cette page peut être copiée avec très peu de modifications sur les différents wiki. Pour les différences de contenu, utiliser des modèles.

Les pages d'aide ne sont pas forcément écrites par les développeurs. Si vous remarquez un comportement inhabituel ou étrange du logiciel, ne partez pas du principe que c'est voulu : reportez-le sur bugzilla, et mettez un lien sur la page d'aide appropriée.

Les développeurs sont encouragés à ajouter des détails techniques sur les pages d'aide, grâce à leur connaissance du fonctionnement du logiciel, à ajouter des liens vers SourgeForge, etc.

Internationalisation

Il y a un espace de nom différent pour chaque langue.

Actuellement, les espaces de nom suivants existent :

ca Catalan: [1] -
da Danois: [[help:Contents/da|]] [2]
de Allemand: [[help:Contents/de|]] [3]
en Anglais: Help Help talk [4] (avec aussi des liens vers des pages en d'autres langues, à déplacer)
eo Esperanto: [5]
es Espagnol: [6]
fr Français: [[help:Help/fr|]] [7]
it Italien: [[help:Contents/it|]] [8]
ja Japonais: [9]
nl Néerlandais: [[help:Contents/nl|]] [10]
no Norvégien: [11]
pl Polonais: [12]
pt Portugais: [13]
ru Russe: [14]
sv Suédois: [15]
zh Chinois: [16]

La sommaire en Bulgare Помощ:Съдържание est pour l'instant dans l'espace principal.

Voir aussi Wikimedia COTW/Help#Namespaces.

Liens internes

Pour que les liens vers les autres pages d'aide fonctionnent, il faudrait que l'espace de nom soit le même sur Meta et sur le wiki de destination.

Par exemple, l'espace de nom Aide sur les projets allemands est "Hilfe:", ce qui peut être vérifié avec des liens comme w:de:help:a, b:de:help:a, etc. : "help" est automatiquement converti dans le nom local.

Mais par exemple pour les projets en néerlandais, l'espace de nom est appelé "Help:", mais sur Meta il devient "NL_Help:". Il faut alors une autre méthode pour que les liens d'une page d'aide à une autre marchent dans tous les projets. Une méthode consiste à utiliser des liens comme [[{{NAMESPACE}}:Naamruimte]].

On peut utiliser des modèles, comme Template:h:l pour créer les liens :

{{h:l|a}} donne a.
{{h:l|Contenu}} donne Contenu.
{{h:l|Principes éditoriaux}} donne Principes éditoriaux.

{{h:l|a|b}} donne b.
{{h:l|Contenu|b}} donne b.
{{h:l|Principes éditoriaux|b}} donne b.

Ceci montre que l'existence ou non des pages marche, et aussi si l'on est déjà sur la page en question.

Garder les informations spécifiques aux projets à part

Pour toutes les langues et projets, le texte wiki sur la page d'aide est le même, les différences de contenu sont obtenues grâce aux modèles.

Les copies exactes du texte wiki sur un autre projet ont les mêmes liens, et les enlever des pages d'aide importées ne serait pas pratique, en particulier pour les mises à jour. Par contre, un modèle non existant s'affiche comme un lien pour éditer la page de ce modèle. Ainsi, au moins un modèle vide devra être créé sur le projet en question, pour y inclure des références propres au projet.

Un conflit de nom survient quand on modèle utilisé sur une page d'aide est déjà utilisé sur un autre projet. Il y a aussi des problèmes que le projet différencie les pages avec la première lettre en majuscule.

Ainsi, les noms utilisés pour les modèles sont restreints : le nom complet de modèle commence par "Template:h:" (sur Meta et d'autres, mais pas pour tous les projets, le h est en majuscule), et les liens utilisent le h minuscule. Chaque projet devrait réserver ces noms pour l'aide.

En fait, les seuls liens sont {{h:h|paramètre}}, {{h:f|enname=paramètre }} (et le modèle correspondant mais désapprouvé {{h:f|langs=|enname=paramètre }}), {{h:|paramètre }} et {{h:1}}. La page Aide:Modèle es une exception puisqu'elle utilise des modèles d'exemple ; elle ne devrait pas être copiée telle quelle sur un projet. La page Aide:Contenu est aussi une exception, c'est une page composite.

Tous les projets devraient créer des modèles avec ces quatre noms, même si c'est pour spécifier qu'aucun contenu n'est désiré.

Les différentes constructions ci-dessous utilisent le fait que un nom de modèle et un paramètre peuvent tous deux dépendre d'un paramètre ou d'une variable ; en particulier, dans les appels de modèles, les noms de modèles sont exprimées avec les variables {{NAMESPACE}} et {{PAGENAME}}.

Template:h:h

{{h:h|paramètre }} se trouve en haut de chaque page d'aide et se rapporte à Template:h:h. Sur Meta, il crée une boîte en haut, qui dépend de la langue, définie par Template:h:h_{{NAMESPACE}}

(voir la liste, qui inclut les redirections)

Le paramètre de Template:h:h est habituellement utilisé pour afficher une barre latérale (dont le contenu est un modèle, avec le nom donné en paramètre, nommé selon les règles habituelles de nommage). En général, cette barre sert à afficher des liens vers d'autres pages de la même partie du manuel.

Template:h:f

{{h:f|enname=nom de la page en anglais }} se trouve en bas de chaque page d'aide et se rapporte au modèle Template:h:f. Sur Meta, il donne un cadre en bas, qui varie selon la langue, défini par Template:h:f {{NAMESPACE}}:

Sur Meta, les liens interlangues sont donnés dans Template:H-langs:{{{enname}}}.

Le lien vers le modèle peut être copié pour toutes les traductions des pages d'aide, sans changement.

Voir la page Help:Help page footer templates#Interlanguage links pour une liste des modèles déjà existants de la forme Template:H-langs:xxx et la valeur du paramètre enname.

Le pied de page est inclus par {{h:f|enname=nom de la page en Anglais }}

Attention : Consulter la page Help:Help page footer templates, un changement est en cours pour la façon d'appeler le modèle.

Liste des pages utilisant le modèle h:f.

Template:h:

{{h:|paramètre }} peut être mis n'importe où sur la page et se rapporte à Template:h:. Il est utilisé pour référencer du contenu spécifique à Meta (valeur du paramètre). D'autres projets peuvent choisir quoi faire avec ce modèle :

Le laisser vide
Y mettre un marqueur
Montrer le texte comme sur Meta
Montrer le texte comme sur Meta avec un marqueur.

Utilisation des modèles dans d'autres projets

Si le modèles h:l est utilisé sur une page pour des liens internes dans le même espace de nom, alors le projet de destination devrait copier le modèle Template:h:l.
Le contenu qui devrait être le même sur toutes les pages d'aide d'un projet peut être mis dans les modèles locaux h:h et h:f. Si le paramètre de langue n'est pas utilisé sur les autres projets, alors h:g peut rediriger sur h:f.
Le contenu additionnel dans certaines pages peut être obtenu par :
- l'utilisation de {{PAGENAME}} : chaque page d'aide peut avoir son propre contenu. Par exemple, si la Wikipédia anglophone, ils sont appelés Template:ph:{{PAGENAME}}, appelés par h:f, et placés en bas de la page, au-dessus des liens vers les autre pages d'aide du projet. Voir par exemple w:Help:Variable. Un inconvénient est que, pour toutes les pages d'aide sans contenu additionnel, un modèle vide doit être créé. w:en:Template:h:f n'a pas de paramètre, les deux paramètres dans l'appel de h:f sont alors ignorés.
- si la page d'aide d'un sujet a besoin de'informations spécifique au projet, un appel à h:1 peut être utilisé, mais avec précuations, car les projets qui ne blanchissent pas h:1 lui-même (mais qui n'ont pas besoin de contenu additionnel) doivent créer un modèle vide associé à cette page, puisque ce modèle n'est pas spécifique à Meta mais aux projets Wikimedia en général.

Catégories

Les catégories devraient être écrites avec le mot anglais "Category:", ce qui marche avec tous les projets, voir Automatic conversions of page names. Cependant, notez qu'il n'y a qu'un seul espace Category sur Meta, il faut donc éviter de mettre deux langues ensemble dans une catégorie, au cas où deux mots seraient identiques.

Style

Noms de page

Utiliser des noms courts. Par exemple, Aide:Édition est mieux qui Aide:Comment éditer une page. Souvenez-vous que vous allez créer des liens vers cette page à l'avenir, donc il vaut mieux choisi un nom court et descriptif. En général, 20 caractères semble être une limite supérieure.

La plupart des liens utiliseront un "pipe" (|) de la forme [[Help:Editing/fr|Édition]]. A l'heure actuelle, il n'y a pas de moyen de faire autrement, mais une solution est en cours pour cacher automatiquement le "Aide:".

Portabilité

Liens en dehors de l'espace de nom

Pour s'assurer qu'un wiki qui importe ces pages n'a pas de liens cassés :

Les liens de cet espace de nom vers d'autres espaces ou d'autres projets utilisent cette convention ou des liens externes.

Exemples :

Aide:Modèle marche, si la page a été copiée.
Translation pointera sur la page de ce nom sur le wiki en question, et ne marchera pas si une telle page n'existe pas.
m:Translation pointera vers http://meta.wikimedia.org/wiki/translation, si les liens interwiki ont été configurés dans le wiki, incluant m: vers Meta-Wikipedia; il marchera même si la page n'a pas été importée sur le wiki.
w:en:HTML point vers http://en.wikipedia.org/wiki/HTML, si le lien interwiki w: a été configuré pour pointer vers Wikipédia, comme c'est le cas pour les projets Wikimedia.

Anciennes versions de MediaWiki

Si une page est mise à jour pour une version plus récente de MediaWiki, vous pouvez créer une sous-page avec le nom de l'ancienne version, et déplacer les anciennes instructions vers cette page.

Espace "Discussion Aide:"

Les pages "Discussion Aide:" sont pour :

discuter à propos de la documentation
discuter des caractéristiques en question du logiciel

Discussion à propos des améliorations du logiciel

Pour demander une amélioration du logiciel ou rapporter un bogue, aller sur https://bugzilla.wikipedia.org/

Si le bug est réparé, ou la nouvelle fonctionnalité incluse, une nouvelle page d'aide peut être créée, mais il faut préciser quelle version du logiciel est concernée.

N'utilisez pas les pages de "Aide:" pour les discussions, mais les pages de discussion associées. Vous pouvez faire des liens vers les bugs avec {{bugzilla|n° du bug}}.

En développement

ed

(permet l'édition facile d'un modèle. Premier paramètre : nom du modèle. Deuxième paramètre : texte après le mot "edit")
{{ed|Modèle|ce modèle}} donne : Edit ce modèle

modifier

Traduction française de "ed", donne le texte "modifier"...

edi

Dans ce cas, l'affichage se résume à "+/-" seulement. Un seul paramètre, le nom du modèle.
{{edi|nom du modèle}} donne +/-

Voir aussi

Help:Help page footer templates