Conventions de style

De Wicri Manuel

Le respect des conventions de style qui suivent est très vivement recommandé pour l'ensemble du réseau Wicri, et, en particulier, pour l'ensemble des wikis "communautaires", notamment le wiki Wicri/Wicri, les wikis régionaux (Wicri/Lorraine, Wicri/Alsace...) et thématiques (Wicri/Ticri, Wicri/Biomasse, Wicri/Bois, Wicri/Eau, Wicri/Sols urbains et Wicri/terre. Les conventions peuvent être différentes sur certains wikis spécialisés, dans le cadre d'un usage particulier : elles seraient alors spécifiées aux utilisateurs.

L'objectif est de maintenir une ligne visuelle commune, et d'assurer la plus grande clarté aux contributeurs et aux visiteurs.

Choix et forme du titre

Le titre d'un article est, dans la plupart des cas, au singulier, et n'est pas constitué par un acronyme. De la même façon, il ne contient pas d'article défini. Ainsi, on n'intitulera pas un article "Le CNRS", mais Centre national de la recherche scientifique.

Exceptions :

  • Certains titres peuvent comporter des acronymes, notamment lorsqu'il s'agit de compléter une information en apportant des éléments nécessaires à la compréhension et que le nom complet viendrait allonger exagérément l'ensemble
  • L'acronyme pourra également être privilégié lorsqu'il est plus représentatif du contenu de la page ; ainsi, la page destinée à présenter AMETIST porte le nom de la revue, et pas l'expression complète
  • Le pluriel sera utilisé lorsqu'il s'agit véritablement de mots et/ou de locutions qui ne s'emploient couramment qu'au pluriel, ou lorsque le nom officiel d'un organisme est au pluriel :
    • États-Unis
    • Sciences humaines et sociales en France

Les majuscules et leur utilisation

La convention veut que les majuscules soient réservées, dans les titres et dans les articles, aux débuts de phrase et aux noms propres. Ainsi, on écrira, comme dans l'exemple précédent Centre national de la recherche scientifique. Cela signifie que l'on n'utilisera pas systématiquement de majuscules dans les noms complets issus de sigles, contrairement à ce que l'on peut souvent trouver. En revanche, elles seront naturellement conservées dès lors qu'il s'agit d'un nom propre. Ainsi, on écrira l'Institut Élie Cartan de Nancy (IECN), le Centre de recherche en automatique de Nancy (CRAN) et l'Institut national polytechnique de Lorraine (INPL), mais on notera le Laboratoire d'énergétique et de mécanique théorique et appliquée (LEMTA) et le Laboratoire des sciences du génie chimique (LSGC).

Il est à noter également que les majuscules, lorsqu'elles sont employées, sont accentuées. Pour cela, une aide a été positionnée en bas de cadre d'écriture, grâce à laquelle les différentes majuscules accentuées sont accessibles directement.

Introduction

L'introduction doit être brève (2, 3 lignes maximum), mais indiquer clairement et précisément de quoi traite l'article, de la manière la plus factuelle possible. Il est recommandé de rappeler dès l'introduction le nom de l'article, en général en gras, comme cela a été fait au début de cette page.

Si l'article est consacré à un organisme, et qu'il est d'usage de nommer ou de déterminer celui-ci par un acronyme (CNRS, Ifremer, PRST...), celui-ci sera introduit en notant d'abord le nom complet, suivi, entre parenthèses, de l'acronyme. Cette démarche sera utilisée à chaque fois qu'un nouveau sigle apparaît. Si un lien doit être établi, il le sera sur le nom complet. Ainsi, les choses se présenteront de la façon suivante :

Acronymes et redirections

L'acronyme est parfois plus fréquemment employé que le nom complet (CNRS est plus usité que Centre national de la recherche scientifique), ce qui se traduit par le fait que les recherches seront probablement majoritairement effectuées sur CNRS. Pour que les utilisateurs arrivent sur la bonne page, il est important d'établir une "redirection", de CNRS vers la page Centre national de la recherche scientifique.

Le bandeau d'aide en bas de fenêtre d'écriture

Pour cela, la procédure est la suivante :

  • effectuer une recherche sur CNRS (colonne de gauche, rubrique "Rechercher")
  • si CNRS n'a pas été renseigné, le texte suivant apparaît : "Aucune page intitulée « CNRS » n’existe. Vous pouvez créer cet article"
  • cliquer sur créer cet article
  • dans la page qui s'ouvre, il faut établir la redirection, en utilisant l'aide en bas de page qui fait directement apparaître la bonne ligne de commande (#REDIRECT[[]])
  • il suffit d'inscrire, entre les crochets, le nom de la page (Centre national de la recherche scientifique) vers laquelle la redirection est établie
  • publier

Le développement

La structure de l'article doit apparaître nettement, idéalement par l'utilisation de titres intermédiaires. La démarche est simple :

  • le premier intertitre est généré automatiquement en l'inscrivant entre "==" : ==Le développement== permet d'obtenir le résultat ci-dessus.
  • les intertitres suivants sont générés de façon identique, la hiérarchie étant liée au nombre croissant de signes "=" ("===" au deuxième niveau, "====" au troisième...).