« Guideline editoriel » : différence entre les versions

De EduTech Wiki
Aller à la navigation Aller à la recherche
Ligne 109 : Ligne 109 :
* 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.  
* 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.
* Eviter au maximum l'utilisation des balises HTML et CSS.
  En partiuclier,  éviter les balises CSS <code>float</code> ou <code>line-height</code> car elles peuvent poser problèmes.
  En particulier,  éviter les balises CSS <code>float</code> ou <code>line-height</code> car elles peuvent poser problèmes.
* En outre, minimiser l'utilisation des markup permet une édition plus aisée.
* 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.
* Eviter d'utiliser des couleurs ou encore des tailles de polices différentesd'un endroit du texte à l'autre.

Version du 14 mars 2006 à 23:03

Afin de conserver a ce wiki sa cohérence, voici quelques règles de base qui peuvent vous aider


Adaptation des règles de style du wikipédia
en cours .... 
note pour K : les partie non encore traduites sont en travaillées dans le train et mises en ligne ce soir encore...


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)

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.

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 faut pour le nom de l'article comme pour les titres qui le compose).

Majuscules

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

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.

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é)

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)

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

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

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.

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]]

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

.

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.

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.

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 <!-- This is a comment. --> world

est affiché comme:

hello world

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

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.

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.