The ScoutWiki Network server was upgraded on November 20th, 2019. The maintenance is now over. Please inform us in Slack or via email support@scoutwiki.org if you encounter any unexpected errors – it's possible the upgrade has missed something. Thanks and happy scoutwiki'ng!

Aide:Style

De Scoutopedia
Sauter à la navigation Sauter à la recherche
Pour commencer
Manuel du parfait
petit Scoutopedien

Bac à sable

Aide technique
Règles générales
Règles techniques


Cette page vise à aider les contributeurs dans la manière de rédiger des textes sur Scoutopedia. Les efforts doivent essentiellement portés sur le ton, qui doit être neutre, impersonnel, clair, précis, compréhensible et non académique, ce qui contribue à l’exactitude des informations et à la bonne présentation des articles. Néanmoins, on ne doit pas négliger de commencer les articles par un résumé introductif, ni d’expliciter le lien du sujet avec le scoutisme.

Structure d'un article

Concernant la mise en page, un bon article débute par une introduction, se poursuit avec une structure claire à base des sections bien hiérarchisées et se termine par des sections d’appendices standardisées telles que des notes, des références et des liens vers des articles approfondissant le sujet.


Wikipedia-logo.png Voir l'article Wikipédia : Aide:Comment rédiger un bon article


Les conseils relatifs au sommaire et aux titres de section sont développés dans l’aide à la présentation. Toutefois, les sections ne sont que le reflet d’un article bien structuré dans l’ordonnancement des idées. Un article ne devrait pas perdre le lecteur dans les détails, car cela peut faire perdre le fil du sujet et masquer la structure essentielle de l’article nécessaire à sa compréhension.


Searchtool.svg Voir l’article détaillé : Aide:Présentation



Résumé introductif

Un article commence par une courte introduction qui précède le sommaire et le corps de l’article. Il devrait être autonome et autosuffisant, si bien qu’un lecteur arrivant sur un article, ignorant tout de son contexte doit savoir de quoi il est sujet.

Le résumé introductif donne une vision globale de l’article en établissant le contexte, résumant les points les plus importants, expliquant l’intérêt du sujet et résumant d’éventuelles controverses s’il y a lieu. De longueur proportionnelle au contenu de l’article, entre deux et quatre paragraphes, le résumé doit être rédigé dans un style accessible et neutre. Il ne doit pas contenir d’informations qui ne soient pas détaillées et correctement sourcées dans le développement de l’article. On met en caractères gras la première mention du sujet de l'article.

Le résumé introductif n’est pas rédigé dans une section et ne contient pas d’ ==En-tête de section==, il les précède. Le premier en-tête de la première section déclenchera l’affichage automatique du sommaire entre le résumé introductif et la première section.


Wikipedia-logo.png Voir l'article Wikipédia : Wikipédia:Résumé introductif


Paragraphes

Les paragraphes doivent être assez courts pour être lisibles et assez longs pour développer convenablement une idée. Les paragraphes trop longs doivent être divisés, tant que les paragraphes voisins continuent à se focaliser sur le sujet.

Les paragraphes d'une seule phrase enthousiasment rarement le lecteur, et doivent être utilisés avec modération. Les articles ne devraient pas consister en un assemblage de ce type de paragraphes trop courts.

Aucun des paragraphes ne doit être une sous-page. On peut en revanche exposer le sujet succinctement avant d'indiquer le lien vers un article plus détaillé.

Taille

Les articles doivent conserver une taille relativement courte. Il faut envisager de découper un article de plus de 100 kb en des articles plus petits, afin d'améliorer la lisibilité et l'édition.

Toutefois, les titres des sections exportées vers un nouvel article doivent être conservés, ainsi qu'un résumé de la section. Les nouveaux articles doivent, quant à eux, être écrits comme des articles autosuffisants mais plus détaillés.


Style informatif et ton

La question du « style encyclopédique » est liée à la nature du projet : comme Wikipédia, Scoutopedia est une encyclopédie collaborative et vise à rapporter et diffuser un savoir de manière factuelle et sans prendre parti. Ses articles doivent être rédigés dans un style adapté à ce but :

  • neutre, c'est-à-dire permettre de comprendre le sujet sans le juger ;
  • impersonnel, en privilégiant le fond sur la forme ;
  • clair, en évitant le jargon et les sous-entendus ;
  • précis, en utilisant les termes exacts ;
  • compréhensible, en évitant les termes trop sophistiqués.



Wikipedia-logo.png Voir l'article Wikipédia : Wikipédia:Style encyclopédique


Neutre

  • Scoutopedia apporte une compréhension, pas un jugement.
  • N’introduisez aucune forme de louange ou de condamnation, ni directement, ni par sous-entendu, et ne cherchez pas à présenter le sujet d’un article sous un jour favorable ou défavorable. Vous avez le droit d’avoir une opinion sur tout, mais aussi le devoir de la laisser hors des articles.
  • Un jugement peut toujours être exposé, mais à condition d’être attribué et pertinent.
  • Réfléchissez aux mots que vous employez, car certains ont des connotations positives ou négatives et doivent donc être évités, à moins qu’il ne s’agisse d’une citation.
  • Soyez factuel et évitez les considérations gratuites. Par exemple, n’écrivez pas qu’une personnalité est « l’une des plus grandes » ou « l’une des plus importantes » de son domaine, mais fournissez des éléments objectifs permettant d’apprécier cette importance.
  • Il ne suffit pas de rédiger de manière neutre pour que le ton de l’article soit neutre : une page déséquilibrée par une abondance d’anecdotes ou de citations à charge viole le principe de neutralité, quand bien même aucune phrase ne serait individuellement orientée.

Impersonnel

  • Privilégiez un style sobre et simple. Évitez les préciosités, la pédanterie, les joliesses de plume, les fioritures, le ton endimanché.
  • Évitez les « nous allons voir », « n’oubliez pas que », « soulignons que » et, d’une manière générale, le je, le on, le nous, le vous (ce problème est fréquemment rencontré dans les articles consacrés à des groupes scouts).
  • Évitez de même les interjections, les verbes à l’impératif, ou les expressions de surprise. En règle générale, bannissez le point d’exclamation.

Clair

  • Exposez clairement ce qui doit être dit, sans sous-entendus, remarques pour les initiés ou allusions obscures. Expliquez le contexte de votre sujet, soit directement dans l’article concerné, soit dans d’autres articles vers lesquels vous ferez des liens internes.
  • Songez aussi que le texte que vous écrivez sera lu par des francophones du monde entier et que ce qui peut être clair dans un pays précis peut ne pas l’être ailleurs.
  • Ne laissez pas une phrase en suspens pour suggérer plus que vous n’écrivez, ou pour faire de l’ironie. Si le complément est neutre et pertinent, exposez-le ; sinon, retirez-le.
  • Évitez d’utiliser des abréviations. N’utilisez pas de sigle sans que l’expression n’ai été employée au préalable sous la forme développée (précisez à sa suite son abréviation entre parenthèses).

Précis

  • Soyez rigoureux et employez toujours le terme le plus exact et le plus approprié. Le flou énerve le spécialiste et trompe le non-spécialiste.
  • Si vous pensez qu’un terme ne sera pas compris par un non-spécialiste, faites un lien interne vers un passage l’expliquant ou une note de bas de page.

Compréhensible

  • Un bon article est aisément lu et compris. Un texte pâtit d’un vocabulaire limité et d’une syntaxe chancelante, mais aussi d’un abus de jargon et de constructions compliquées.
  • Rappelez-vous que trois phrases courtes et claires vaudront toujours mieux qu’une longue phrase bancale et obscure. Évitez les phrases « poupée russe » dans lesquelles vous multipliez les incises, les virgules, les ajouts entre parenthèses.
  • Relisez-vous en pensant au lecteur.


Contexte de lecture

Les lecteurs de Scoutodia ont un profil, une éducation et une vision du monde différentes. Il faut rendre l'article accessible et compréhensible pour le plus de lecteurs possibles. Gardez à l'esprit que les lecteurs lisent les articles pour apprendre. Il est possible que le lecteur ne connaisse rien au sujet : l'article doit donc lui expliquer totalement le sujet, bases comprises.

  • Évitez autant que possible d'utiliser un jargon
  • Prenez en compte le lecteur

Lorsque du jargon est utilisé dans un article, il est souhaitable qu'une brève explication soit donnée lors de la première utilisation d'un terme. Le but est d'avoir un équilibre entre la compréhensibilité et le détail, afin d'offrir au lecteur un gain d'information grâce à l'article.

Évaluer le contexte

Voici quelques pistes de réflexion pour vous aider à évaluer le contexte :

  • Est-ce que l'article a du sens si le lecteur y arrive par le lien Une page au hasard ?
  • Imaginez vous comme une personne quelconque de la planète lisant en français cet article. Pouvez-vous comprendre de quoi l'article parle ?
  • Est-ce que le lecteur peut être tenté de suivre certains liens de la page ?

Construire un réseau

Rappelez-vous que chaque article de Scoutopedia peut être relié à un réseau d'autres sujets. Créer des connexions grâce à des liens internes est un bon moyen d'établir un contexte. Comme Scoutopedia n'est pas une séquence longue et ordonnée d'articles catégorisés avec attention, mais une collection d'articles accessibles aléatoirement et interconnectés les uns aux autres, chaque article doit contenir des liens vers des sujets plus généraux qui servent à catégoriser l'article.

Lorsque vous créez des liens, ne saturez pas la page de liens, et portez attention à ce que vos liens soient pertinents. Il n'est pas nécessaire de lier le même terme une douzaine de fois dans l'article, toutefois il semble raisonnable d'avoir au moins le lien en haut et en bas de l'article, voire une ou deux fois de plus, selon la longueur de l'article.

Évitez que vos articles soient « orphelins ». Lorsque vous écrivez un nouvel article, assurez-vous qu'une ou plusieurs pages pointent vers lui. Minimisez aussi les risques que votre article soit rendu orphelin par le travail d'autrui. Il devrait toujours y avoir une chaîne logique (plus ou moins longue) allant de la page d'accueil à votre article. Essayez de suivre ce chemin pour identifier les articles devant comprendre un lien vers votre article. Ce travail permet souvent de découvrir des éléments à ajouter à l'article. Le travail inverse, consistant à rechercher toutes les pages liées à votre article, et de remonter ainsi vers la page d'accueil est souvent aussi très productif.



Wikipedia-logo.png Voir l'article Wikipédia : Aide:Comment rédiger un bon article


Sommaire aide.svg Sommaire de l'aide – Toutes les pages d'aide de Scoutopedia.