Guideline editoriel

De EduTech Wiki
Aller à : navigation, rechercher

Afin de conserver a ce wiki sa cohérence, voici quelques règles de base, adaptées de celles utilisées pour wikipédia.

1 Les nouveaux articles

  • Ne pas créer de page sans la mettre en lien avec une autre page.Une page wiki sans lien est perdue
  • Pour nommer les pages, la première lettre est automatiquement mise en majuscule et les espaces transformés en underscores par le wiki (ce que l'utilisateur ne voit pas forcément)
  • Avant de commencer un article, cherchez dans le wiki si la thématique n'est pas déjà traitée sous un autre nom.
  • Si l'impression persiste que malgré des similitudes avec un article existant, il faut créer un articile similaire, il faut le mettre en lien avec le premier.
  • S'il s'agit de formuler différemment le mot ou concept clé d'un article, on peut faire une redirection vers ce dernier. Par exemple: pour rediriger vers un article A depuis un article B. Mettre dans l'article B:
#REDIRECT [[Article A]]

L'utilisateur sera redirigé directement vers l'article B.

  • Eviter de traiter deux thèmes dans un seul article. SAuf dans le cas où ceux-ci appuyent ou exemplifie un cas, qui est alors le sujet central de l'article.
  • Eviter de redéfinir longuement un terme s'il se trouve ailleurs dans le wiki. Dans ce cas, soit il est opportun de rappeler le sens du terme succintement car on désire que le lecteur reste sur la page, soit on met le dit terme en lien vers l'article qui lui est consacré.

2 Les catégories

  • Il convient de classer chaque nouvel article dans une catégorie. Pour ce faire vous pouvez choisir une catégorie existante, ou si vous en trouver la justification, créer une nouvelle catégorie.
  • Par exemple, pour introduire votre article dans une catégorie telle que Instructional design models, vous mettez dans votre article :
[[Category:Instructional design models]]


3 Modification d'un article existant

  • Il convient de toujours spécifier le pourquoi d'une modification. Pour ce faire, donner une brève description de la nature des changements (200 caractères maximum) dans la case Résumé disposée sous la zone d'édition.

4 Les liens

  • Ne pas mettre de liens dans les sous-titre, les titres de sections,...
  • Nommer les liens, qu'ils soient internes ou externes.
  • Le wiki est un hypertexte, il est donc bon de mettre un maximum en lien les pages qui doivent l'être par l'intermédiaires de mots clés qui les lient.

5 Les titres

  • Utiliser les == (deux symboles égal)pour faire les titres et non pas la triple apostrophe qui met en gras.
  • On commence avec "==", puis le titre, puis "==" pour fermer.
  • Mettre uniquement la première lettre d'un titre en majscule, et laisser toutes les autres en minuscules, sauf si l'on a affaire à un nom propre
  • Eviter les liens dans les titres. A la place, répétez le titre en première phrase et mettez celle-ci en lien.
  • Eviter d'abuser des sous-titres
  • Eviter les déterminants (Le, La, Les,...) dans les titre.
  • Eviter les répétitions du nom de l'article dans les titres.
  • Et tant que possible, éviter de modifier les titres, car d'autres articles y font peut-être référence (cela vaut pour le nom de l'article comme pour les titres qui le composent).

6 Majuscules

Eviter d'utiliser des majuscules pour appuyer l'effet de la phrase, préférez l'italique

7 Italique

  • Utiliser la double apostrophe '' pour faire de l'italique: ''This is italic.'' devient This is italic.
  • L'italique est utilisé pour appuyer, mettre l'accent sur certains mots. Il faut donc l'utiliser avec modération
  • Mais on utilise également pour comparer des mots, mot à mot, ou des lettres.
    • écrire se dit aussi rédiger.
    • La lettre la plus utilisée en français est le e.

8 Citations

  • les citations ne se mettent pas en italique, sauf dans le cas des points cités ci dessus
  • Pour Citer, commencer la ligne par un double point :
  • si vous relevez une partie du texte en le mettant en italique, mentionnez le sous la citation. P.ex.
A vaincre sans périls, on triomphe sans gloire
(italique rajouté)

9 Le double point

Le double point ( : ) ne devrait pas avoir d'espace avant lui :

  • Il le tenta deux fois: en 1941 et en 1943(correct)
  • Il le tenta deux fois : en 1941 et en 1943(incorrect)

10 Acronymes et abbréviations

  • Ne jamais supposer que le lecteur comprend les acronymes et les abbréviations que vous utilisez.
  • L'usage veut que vous mettiez la première référence en toute lettre (voire pointant vers une page de définition le cas échéant) et montriez l'acronyme ou l'abréviation juste après. Par exemple :
le Problem-Based Learning (PBL) est utilisé dans l'éducation pour...
  • Il peut être utile de ré-inscrire l'acronyme ou l'abbréviation en toute lettre plusieurs fois par articles longs, lorsque le lecteur peut se perdre ou oublier ce à quoi cela se rapportait

11 Tabulation Simple

Chaque ligne débutant avec un espace vide devient une police de taille fixe et peut être utilisée pour une tabulation simple.

un      deux   trois
alpha   beta   gamma

Une ligne qui commence avec un espace et ne contient rien d'autre devient une ligne blanche

12 Pronoms et termes courants

  • les abbéviations communes telles que "tjs", "qq", "p.ex.", .. ainsi que les latines comme "i.e.", "e.g.", ou "n.b." devraient être évitées au profit d'une formulation complète qui permet une lecture plus fluide du texte.
  • De même, les articles ne doivent pas être basés sur l'avis de la personne ou ses expériences. Ainsi, éviter d'écrire le texte à la première personne (je) et de parler de l'autre à la seconde personne (tu). Sauf s'il s'agit d'une citation qui doit alors être retrasncrite telle quelle.
  • toutefois on peut tolérer qu'une formulation utilise un pronom pour parler d'une entité abstraite. Le "on" peut s'avéré adéquat.

13 Images

  • Les articles avec une seule image devraient la positionner en haut de l'article, aligné à droite. Ceci dit, c'est une règle souple et une autre position de l'image peut s'avérer justifiée.
  • Le langage d'affichage d'une image ressemble plus ou moins à ceci:
[[Image:monimage.jpg|120px|right|thumb|Insérer une légende ici]]

14 Légendes

  • Les photos et graphiques devraient porter une légende en dessous.
  • Les légendes ne doivent pas être en italique sauf si elle sont des titres de livres ou de matériel relié.
  • Une légende commence toujours par une majuscule.

15 Liste à puces

On utilise les règles suivantes pour les listes à puce:

  • Lorsque lon utilise des phrases complètes, utiliser de la ponctuation et mettre un point à la fin.
  • Les phrases incomplètes ne nécessitent pas de ponctuation terminale.
  • Ne pas mélanger les styles; utiliser des phrases complètes, ou utiliser des fragments.
  • Chaque entrée débute par une majscule, même s'il s'agit d'une phrase incomplète.

16 Les liens wiki

  • Seulement faire des liens pertinents. Il ne sert à rien, et c'est même dérangeant, de faire des liens sur tout et n'importe qui dans le texte.
  • Les liens doivent apporter quelque chose à l'expérience du lecteur et non rendre l'article plus difficile à lire.
  • Trop de liens perturberont la capacité du lecteur à suivre le fil de l'article.
  • Des liens redondant augmentent le désordre de la page et en rende son maintient futur plus lourd.
  • Contrôler les liens une fois la page écrite afin de s'assurer qu'ils amènent bien le lecteur au concept correct.

17 Commentaire invisibles

  • Eviter de préciser que l'article est incomplet ou nécessite d'être repris.
  • De la même manière, le lecteur ne tirera aucun bénéfice à voir des titre sans contenus.
  • Pour communiquer avec d'autres rédacteurs potentiels, il convient de faire des commentaires invisibles. Pour se faire, entourer le texte du commentaire de <!-- et -->. Par exemple:
hello <!-- Ceci est un commentaire. --> le monde!

est affiché comme:

hello le monde!

De sorte que le commentaire est visible uniquement en regardant la source wiki ou HTML.

18 Liens externes

  • Les liens externes vers des contenus qui sont hors du wiki apparaisent comme des notes en bas de page et peuvent apparaitre comme une liste en bas de l'article.
  • Sauf justification, il ne faut pas qu'ils apparaissent au lecteur sous leur véritable URL, mais doivent être formattés pour décrire le site et le sujet.

19 Divers

  • Lorsque vous ignorez comment effectuer une mise en page précise, le mieux est encore de trouver un exemples ailleurs dans le wiki et d'ouvrir l'article pour impression afin de voir comment il faut faire. Il faut faire attention après à ne pas sauvegarder la page d'exemple.
  • Utiliser la manière la plus simple et économique d'afficher de l'information de manière utile et compréhensible. Les markup (symboles de syntaxes wiki) peuvent provoquer des affichages différents selon le navigateur internet.
  • Eviter au maximum l'utilisation des balises HTML et CSS.
En particulier,  éviter les balises CSS float ou line-height car elles peuvent poser problèmes.
  • En outre, minimiser l'utilisation des markup permet une édition plus aisée.
  • Eviter d'utiliser des couleurs ou encore des tailles de polices différentesd'un endroit du texte à l'autre.