Guide du rédacteur

Ce guide du rédacteur est une référence de style pour le Mozilla Developer Center. Il est conçu pour être un ensemble sympathique de bonnes pratiques plutôt qu’une liste de règles stricte, tout ce qui s’y trouve peut donc être ignoré. Ne soyez pas mécontent ou surpris, par contre, si un autre contributeur arrive par la suite avec ses gros sabots et retravaille votre article pour s’y conformer de plus près.

Naturellement, ce guide s’applique principalement à la traduction française du wiki MDC en anglais. Les traductions dans les autres langues peuvent (et sont encouragées à) avoir leurs propres règles.

Guides de style recommandés

Si vous avez des questions concernant l’usage et le style non traitées ici, nous recommandons la consultation du Guide stylistique de Sun. Vous trouverez d’autres guides sur la page qui leur est consacrée sur traduc.org.

Dictionnaires recommandés

Pour des questions d’orthographe, outre les dictionnaires papier classiques, vous pouvez vous référer au Grand dictionnaire terminologique de l’OQLF pour les termes techniques, et WordReference pour les autres mots.

Vous pouvez utiliser l’ancienne ou la nouvelle orthographe, mais essayez de garder la même au sein du même article (ou de la même série d’articles). Utilisez par exemple « évènement » dans la Référence du DOM Gecko. Utilisez toujours des accents sur les majuscules, un mauvais clavier n’est pas une excuse (le correcteur orthographique intégré à Firefox pourra vous y aider).

Ce guide sera complété au cours du temps, si vous avez des questions particulières qui n’y sont pas traitées, envoyez-les à la liste de discussion ou sur la page de discussion associée à ce guide.

Nommage des pages et capitalisation des titres

  • Les noms de page et de section doivent simplement commencer par une majuscule (au premier mot et sur les noms propres) plutôt que de mettre une majuscule à chaque mot :
    • Correct : « Une nouvelle méthode pour les rollovers JavaScript »
    • Incorrect : « Une Nouvelle Méthode pour les Rollovers JavaScript »

Abréviations latines

Dans les notes et parenthèses

  • Seule l’abréviation et cætera (etc.) doit être utilisée dans les parenthèses et dans les notes. Elle doit toujours se terminer par un seul point. N’utilisez pas les autres abréviations latines (i.e., e.g.) qui ne sont pas comprises par tout le monde ou pas toujours identifiée comme d’origine latine. Utilisez plutôt « comme », « par exemple », « c.-à-d. ».
    • Correct : Les applications Gecko (Firefox, Thunderbird, etc.) peuvent être utilisées …
    • Incorrect : Les applications Gecko (Firefox, Thunderbird, etc…) peuvent être utilisées …
    • Correct : Les navigateurs Gecko (comme Firefox) peuvent être utilisés …
    • Incorrect : Les navigateurs Gecko (e.g. Firefox) peuvent être utilisés …

Dans le texte principal

  • Dans le texte principal (c.-à-d. en dehors des notes et des parenthèses, utilisez un équivalent français complet de ce que désignent ces abréviations.
    • Correct : … pour les navigateurs et d’autres applications.
    • Incorrect : … pour les navigateurs, etc.
    • Correct : les navigateurs comme Firefox peuvent être utilisés …
    • Incorrect : les navigateurs e.g. Firefox peuvent être utilisés …

Signification et équivalents des abréviations latines

Abrév. Latin Français
cf. confer voir
e.g. exempli gratia par exemple
et al. et alii et autres
etc. et cætera et ainsi de suite
i.e. id est c.-à-d., c’est-à-dire, en d’autres mots
N.B. nota bene Notez que…
P.S. post scriptum écrit après

N.B. Beaucoup de gens confondent « e.g. » avec « i.e. », ne les utilisez donc pas en français.

Acronymes et abréviations

Majuscules et points

  • Utilisez des capitales et ne mettez pas les points pour tous les acronymes et abréviations, donc les organisations comme l’ONU.
    • Correct : XUL
    • Incorrect : X.U.L. ; Xul

Expansion

  • À la première mention d’un terme sur une page, introduisez son expansion entre parenthèses, puis sa traduction en français.
    • Correct : « XUL (XML User Interface Language) est le langage XML d’interface utilisateur de Mozilla… »
    • Incorrect : « XUL est le langage XML d’interface utilisateur de Mozilla… »
Exceptions
  • Ne dépliez les acronymes que s’ils ne sont pas supposés familiers du lecteur. En cas de doute, faites l’expansion ou, mieux, faites un lien vers l’article décrivant la technologie.

Pluriels d'acronymes ou d'abréviations

  • N’ajoutez aucun s pour accorder un acronyme ou une abréviation au pluriel (à moins qu’elle soit lexicalisée en un nom commun connu et défini dans les dictionnaires usuels, le plus souvent avec une orthographe modifiée où s’insèrent des voyelles supplémentaires prononçables et transcrites, et qui peut alors être écrit entièrement en minuscules et s’accorder normalement, mais le plus souvent cet usage n’est pas clairement établi et cette transcription est à éviter s’il ne s’agit que d’une transcription phonétique lettre par lettre de l’abréviation et sans racines étymologiques).
    • Correct : des CD-ROM
    • Éviter : des cédéroms
    • Incorrect : des CD-ROMs
    • Incorrect : des CD-ROM's

Pluriels

  • Utilisez les pluriels francisés, pas les formes héritées ou influencées par le latin ou le grec, et conservez au pluriel les accents de francisation.
    • Correct : des syllabus, des scénarios, des alinéas, des folios
    • Incorrect : des syllabi, des scénarii, des alinéæ, des folii

Nombres

Dates

  • Pour les dates (n’incluant pas les dates dans les codes d’exemples) utilisez le format : 1er janvier 1990.
    • Correct : 24 février 2006
    • Incorrect : 24 Février 2006 ; 24/02/2006
  • Vous pouvez également utiliser le format ISO AAAA-MM-JJ.
    • Correct : 2006-02-24
    • Incorrect : 02/24/2006 ; 24/02/2006 ; 02/24/06

Séparateurs de milliers et virgules

  • Utilisez des espaces pour séparer les milliers de plus de quatre chiffres et non des points ou des virgules.
    • Correct : 4000 ; 54 000
    • Incorrect : 4,000 ; 4 000 ; 54000
  • Utilisez la virgule pour séparer la partie décimale d’un nombre, sauf dans les exemples de code.

Ponctuation

Espaces et ponctuation

  • Utilisez une espace (de préférence insécable) avant les signes de ponctuation haute (« : », « ; », « ! », « ? »), ainsi qu’après l’ouverture et avant la fermeture des guillemets français (en chevrons). Idéalement il faudrait une espace fine ( ) et de préférence insécable (&nnbsp; ou  ) mais celles-ci ne s’affichent pas correctement sur tous les systèmes.
  • Ne mettez aucune espace avant une virgule ou un point, ni avant la fermeture des parenthèses, crochets ou accolades, mais après. Faites le contraire pour l’ouverture des parenthèses, crochets ou accolades.

Virgules et énumérations

  • N'utilisez pas de virgule avant un « et » en fin d'énumération.
    • Correct : Nous utiliserons des trains, des avions et des automobiles.
    • Incorrect : Nous utiliserons des trains, des avions, et des automobiles.

Autres ressources

Si vous connaissez d’autres ressources, n’hésitez pas à les ajouter ici.