« Guideline editoriel » : différence entre les versions

De EduTech Wiki
Aller à la navigation Aller à la recherche
Aucun résumé des modifications
m (ajout de la catégorie "Aides")
 
(22 versions intermédiaires par 5 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
Afin de conserver a ce wiki sa cohérence, voici quelques règles de base qui peuvent vous aider
Afin de conserver la cohérence de ce wiki, voici quelques règles de base, adaptées de celles utilisées pour [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style wikipédia].


==Les nouveaux articles==
* Pour créer une page wiki, chercher dans la barre de recherche si le nom de votre page existe déjà. Si ce n'est pas le cas, vous pouvez créer votre page en cliquant sur le lien rouge nommé par le nom de votre recherche.
* 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 malgré des similitudes avec un article existant, il faut créer un article 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:
:<nowiki>#REDIRECT [[Article A]]</nowiki>
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 appuient ou exemplifient 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 succinctement 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é.


'''Adaptation des règles de style du wikipédia'''
==Les catégories==
en cours ....
* 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.
note pour K : les partie non encore traduites sont en travaillées dans le train et mises en ligne ce soir encore...
* Par exemple, pour introduire votre article dans une catégorie telle que ''Instructional design models'', vous mettez dans votre article :
:<nowiki>[[Category:Instructional design models]]</nowiki>


 
==Modification d'un article existant==
==Les nouveaux articles==
*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.
* 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==
==Les liens==
Ligne 24 : Ligne 34 :
* Eviter les déterminants (Le, La, Les,...) dans les titre.  
* Eviter les déterminants (Le, La, Les,...) dans les titre.  
* Eviter les répétitions du nom de l'article dans les titres.
* 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).
* 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).


==Majuscules==
==Majuscules==
Ligne 31 : Ligne 41 :
==Italique==
==Italique==
*Utiliser la double apostrophe <code><nowiki>''</nowiki></code> pour faire de l'italique: <code><nowiki>''This is italic.''</nowiki></code> devient ''This is italic.''
*Utiliser la double apostrophe <code><nowiki>''</nowiki></code> pour faire de l'italique: <code><nowiki>''This is italic.''</nowiki></code> devient ''This is italic.''
* L'italique est utilisé pour appuyer, mettre l'accent sur certains mots. Il faut donc l'utiliser avec modération
* 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.   
* Mais on utilise également pour comparer des mots, mot à mot, ou des lettres.   
**''écrire'' se dit aussi ''rédiger''.
**''écrire'' se dit aussi ''rédiger''.
Ligne 37 : Ligne 47 :


==Citations==
==Citations==
* les citations ne se mettent pas en italique, sauf dans le cas des points cités ci dessus
* 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 <code><nowiki> : </nowiki></code>
* Pour Citer, commencer la ligne par un double point <code><nowiki> : </nowiki></code>
* si vous relevez une partie du texte en le mettant en italique, mentionnez le sous la citation. P.ex.
* 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'''
:A vaincre sans périls, on triomphe sans '''gloire'''
:(italique rajouté)
:(italique rajouté)
Ligne 48 : Ligne 58 :
*Il le tenta deux fois : en 1941 et en 1943(incorrect)
*Il le tenta deux fois : en 1941 et en 1943(incorrect)


==Acronymes et abbréviations==
==Acronymes et abréviations==
* Ne jamais supposer que le lecteur comprend les acronymes et les abbréviations que vous utilisez.
* Ne jamais supposer que le lecteur comprend les acronymes et les abré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 :  
* 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...
: 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
* Il peut être utile de ré-inscrire l'acronyme ou l'abréviation en toute lettre plusieurs fois par articles longs, lorsque le lecteur peut se perdre ou oublier ce à quoi cela se rapportait


==Tabulation Simple ==
==Tabulation Simple ==


Chaque ligne débutant avec un espace vide devient une police de taille fixe et pour être utilisée pour une 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
  un      deux   trois
  alpha  beta gamma
  alpha  beta   gamma
   
   
Une ligne qui commence avec un espace et ne contient rien d'autre devient une ligne blanche
Une ligne qui commence avec un espace et ne contient rien d'autre devient une ligne blanche


==Usage and spelling==
==Pronoms et termes courants==
===Usage===
* Les abré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.
*Possessives of singular nouns ending in ''s'' may be formed with or without an additional ''s''. Either form is generally acceptable within Wikipedia. However, if either form is much more common for a particular word or phrase, follow that form, such as with "Achilles' heel".
* 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 retranscrite telle quelle.
*Abbreviations of Latin terms like "i.e.", "e.g.", or "n.b." should be avoided and English terms such as "that is", "for example", or "note" used instead.
* 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.
*If a word or phrase is generally regarded as correct, then prefer it to any other word or phrase that might be regarded as incorrect.  For example, "other meaning" should be used instead of "alternate meaning", since ''alternate'' only means "alternating" in British English (and also according to the [http://www.bartleby.com/61/15/A0231500.html ''American Heritage Dictionary'']).
*Use an unambiguous word or phrase in preference to an ambiguous one.  For example, "other meaning" should be used instead of "alternative meaning", since ''alternative'' commonly suggests "nontraditional" or "out-of-the-mainstream" to an American-English speaker.
 
===Avoid self-referential pronouns===
Wikipedia articles must not be based on one person's opinions or experiences.  Thus, "I" can never be used except, of course, when it appears in a quotation. For similar reasons, avoid the use of "we" and "one." A sentence such as "We/One should note that some critics have argued in favor of the proposal" sounds more personal than encyclopedic.
 
Nevertheless, it might sometimes be appropriate to use "we" or "one" when referring to an experience that ''anyone'', any reader, would be expected to have, such as general perceptual experiences. For example, although it might be best to write, "When most people open their eyes, they see something", it is still legitimate to write, "When we open our eyes, we see something", and it is certainly better than using the [[passive voice]]: "When the eyes are opened, something is seen".
 
It is also acceptable to use "we" in mathematical derivations; for example: "To [[Normalisation_of_a_wavefunction|normalize the wavefunction]], we need to find the value of the arbitrary constant ''A''."
 
===Avoid the second person===
Use of the second person ("you") is discouraged.  This is to keep an encyclopedic tone and also to help clarify the sentence.  Instead, refer to the subject of the sentence, for example:
*"When ''a player'' moves past 'go', ''that player'' collects $200."
**Or: "Players passing 'go' collect $200."
*'''Not:''' "When ''you'' move past 'go', ''you'' collect $200."
This does not apply to quoted text, which should be quoted exactly.
 
==National varieties of English==
{{see also|Wikipedia:Manual of Style (spelling)}}
 
Cultural clashes over grammar, spelling, and capitalisation/capitalization are a common experience on Wikipedia. Remember that millions of people have been taught to use a different form of English from yours, including different spellings, grammatical constructions, and punctuation. For the English Wikipedia, while a nationally predominant form should be used, there is no preference among the major national varieties of English. However, there is certain etiquette generally accepted on Wikipedia, summarized here:
 
* Articles should use the same dialect throughout.
* If an article's subject has a strong tie to a specific region/dialect, it should use that dialect.
* If there's no strong tie, try to find synonyms that can be used in any dialect.
* If no such words can be agreed upon, the dialect of the first significant contributor (not a stub) should be used.
 
The special cases are clarified in the following guidelines.  They are roughly in order; guidelines earlier in this list will usually take precedence over guidelines later:
 
*Proper names should retain their original spellings, for example, ''United States Department of Defense'' and ''Australian Defence Force''.
*Each article should have uniform spelling and not a haphazard mix of different spellings, which can be jarring to the reader. For example, do not use ''center'' in one place and ''centre'' in another in the same article (except in quotations or for comparison purposes).
*Articles that focus on a topic specific to a particular English-speaking country should generally conform to the spelling of that country. For example:
**Article on the ''[[American Civil War]]'': [[American English]] usage and spelling
**Article on Tolkien's ''[[The Lord of the Rings]]'': [[British English]] usage and spelling
**Article on ''[[Uluru]]'' (''Ayers Rock''): [[Australian English]] usage and spelling
**Article on ''[[List of European Union institutions|European Union institutions]]'': British, [[Hiberno-English|Irish]] and Maltese English usage and spelling
**Article on the city of ''[[Montreal]]'': [[Canadian English]] usage and spelling
**Article on ''[[Taj Mahal]]'': [[Indian English]] usage and spelling.
*If the spelling appears in an article name, you should make a [[Wikipedia:Redirect|redirect]] page to accommodate the other variant, as with [[Artefact]] and [[Artifact]], or if possible ''and'' reasonable, a neutral word might be chosen as with [[Glasses]].
*''Words with multiple spellings'': In choosing words or expressions, there may be value in selecting one that does not have multiple spellings if there are synonyms that are otherwise equally suitable. In extreme cases of conflicting names, a contrived substitute (such as [[fixed-wing aircraft]]) is acceptable.
*If an article is predominantly written in one type of English, aim to conform to that type rather than provoking conflict by changing to another. (Sometimes, this can happen quite innocently, so please do not be too quick to make accusations!)
*Consult Wikipedia articles such as [[English plural]] and [[American and British English differences]].
*The English texts of treaties that are signed by both the [[United Kingdom]] and the [[United States]] use [[British English]] usage and spelling by convention.
*If all else fails, consider following the spelling style preferred by the first major contributor (that is, not a stub) to the article.
 
Finally, in the event of conflicts on this issue, please remember that if the use of ''your'' preferred version of English seems like a matter of great national pride to you, the differences are actually relatively minor when you consider the many users who are not native English speakers at all and yet make significant contributions to the English-language Wikipedia, or how small the differences between national varieties are compared with other languages.  There are many more productive and enjoyable ways to participate than worrying and fighting about which version of English to use on any particular page.
 
==Currency==
 
When including a price or currency, only include one. This should be the currency that fits best for that article. An '''incorrect''' example:
 
:The object costs 300USD (160GBP, 280EURO).
 
This would be incorrect as there is no need to include multiple currencies. Also, as exchange rates vary with time, these figures will not remain correct.
 
However, if the figures are there in order to show a geographical variation in the amount (such as the cost of an item at release in different countries), then it can be included as such:
 
:The object was released in the USA for $10, in the UK for £10 and in the rest of Europe for €12.
 
==Pictures==
{{main|Wikipedia:Picture tutorial}}
 
Articles with a single picture are encouraged to have that picture at the top of the article, right-aligned, but this is not a hard-and-fast rule. Portraits with the head looking to the right should be left-aligned (looking into the article).
 
The current image markup language is more or less this:
 
<code><nowiki>[[Image:picture.jpg|120px|right|thumb|Insert caption here]]</nowiki></code>
 
==Captions==
{{main|Wikipedia:Captions}}
 
Photos and other graphics should have captions unless they are "self-captioning", as in reproductions of album or book covers, or when the graphic is an unambiguous depiction of the subject of the article. For example, in a biography article, a caption is not needed for a portrait of the subject pictured alone; however, most entries use the name of the subject and the birth and death years and an approximation of the date when the image was taken: "John Smith (1812&ndash;95) circa 1880" or "John Smith (1812&ndash;95) on January 12, 1880 in Paris". If the caption is a single sentence or a sentence fragment, it does not get a period at the end. If the caption contains more than one sentence, then each sentence should get a period at the end. Captions should not be italicized unless they are book titles or related material. The caption always starts with a capital letter. Remember the full information concerning the image is contained in the image entry, so people looking for more information can click on the photo to see the full details.
 
==Bulleted items==
The following are rules for using lists of bulleted items:
* When using complete sentences, always use punctuation and a period at the end.
* Incomplete sentences don't need terminal punctuation.
* Do not mix sentence styles; use all complete sentences, or use all sentence fragments.
* Each entry begins with a capital letter, even if it is a sentence fragment.
 
==Identity==
This is perhaps one area where Wikipedians' flexibility and plurality are an asset, and where one would not wish all pages to look exactly alike. Wikipedia's [[Wikipedia:Neutral point of view|neutral point of view]] and [[Wikipedia:No original research|no original research]] policies always take precedence. However, here are some nonbinding guidelines that may help:
*Where known, use terminology that subjects use for themselves ([[self-identification]]). This can mean using the term an individual uses for himself/herself, or using the term a group most widely uses for itself. This includes referring to [[transgender]] individuals according to the name and pronoun they use to identify themselves.
*Use specific terminology: People from Ethiopia (a country in Africa) should be described as Ethiopian, not African.
*However, a more general name will often prove to be more neutral or more accurate. For example, a [[List of African-American composers]] is acceptable, though a [[List of composers of African descent]] may be more useful.
*If possible, terms used to describe people should be given in such a way that they [[grammatical modifier|qualify]] other nouns. Thus, ''black people'', not ''blacks''; ''gay people'', not ''gays''; and so forth.
*Do not assume that any one term is the most [[inclusive]] or [[accurate]].
*The term ''Arab'' refers to people and things of ethnic Arab origin. The term ''Arabic'' refers to the Arabic language or [[writing system]] (and related concepts). For example, "Not all Arab people write or converse in Arabic, but nearly all are familiar with Arabic numerals."
 
==Wikilinking==
{{main|Wikipedia:Only make links that are relevant to the context}}
 
Make only [[Wikipedia:links|links]] relevant to the context. It is not useful and can be very distracting to mark all possible words as hyperlinks. Links should add to the user's experience; they should not detract from it by making the article harder to read. A high density of links can draw attention away from the high-value links that you would like your readers to follow up. Redundant links clutter up the page and make future maintenance harder. A link is the equivalent of a footnote in a print medium. Imagine if every second word in an encyclopedia article were followed by "(see:)". Hence, the links should not be so numerous as to make the article harder to read.
 
Not every year listed in an article needs to be wikilinked.  Ask yourself: will clicking on the year bring any useful information to the reader?
 
Do, however, wikilink years, using the <nowiki>[[As of XXXX]]</nowiki> form, when they refer to information that was current at the time of writing; this allows other editors to ensure that articles are kept up to date as time passes.  Dates including a month and day should also be linked in order for user preferences on date formatting to work properly.
{{see also|Wikipedia:As of|Wikipedia:Manual of Style (dates and numbers)|Wikipedia:Build the web}}
 
Check links after they are wikified to make sure they direct to the correct concept; many dictionary words lead to disambiguation pages and not to complete articles on a concept.
 
==Miscellaneous notes==
===When all else fails===
If this page does not specify which usage is preferred, use other resources, such as ''[[The Chicago Manual of Style]]'' (from the [[University of Chicago Press]]) or [[Fowler's Modern English Usage|Fowler's ''Modern English Usage'' (3rd edition)]] (from the [[Oxford University Press]]). Also, please feel free to carry on a discussion on [[Wikipedia talk:Manual of Style]], especially for substantive changes.
 
Even simpler is to look at an article that you like and open it for editing to see how the writers and editors have put it together. You can then close the window without saving changes if you like, but look around while you are there. Almost every article can be improved.
 
===Keep markup simple===
Use the simplest markup to display information in a useful and comprehensible way. Markup may appear differently in different browsers. Use HTML and CSS markup sparingly and only with good reason. Minimizing markup in entries allows easier editing.
 
In particular, do not use the CSS <code>float</code> or <code>line-height</code> properties because they break rendering on some browsers when large fonts are used.
 
===Formatting issues===
Formatting issues such as font size, blank space and color are issues for the Wikipedia site-wide [[Cascading Style Sheets|style sheet]] and should not be dealt with in articles except in special cases. If you absolutely must specify a font size, use a relative size, that is, <code>font-size: 80%</code>; not an absolute size, for example, <code>font-size: 4pt</code>.  


Using color alone to convey information should not be done, but if necessary, try to choose colors that are unambiguous when viewed by a person with [[color blindness]]. In general, this means that red and green should not both be used. Viewing the page with [http://www.vischeck.com/vischeck/vischeckURL.php Vischeck] can help with deciding if the colors should be altered.  It is acceptable to use color as an aid, but the information should still be equally accessible without it.
==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:
<code><nowiki>[[Image:monimage.jpg|120px|right|thumb|Insérer une légende ici]]</nowiki></code>


===Make comments invisible===
==Légendes==
Avoid highlighting that the article is incomplete and in need of further work.  
* 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.


Similarly, there is little benefit to the reader in seeing headings and tables without content.
==Liste à puces==
On utilise les règles suivantes pour les listes à puce:
* Lorsque l'on 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 majuscule, même s'il s'agit d'une phrase incomplète.


If you want to communicate with other potential editors, make comments invisible to the ordinary article reader. To do so, enclose the text which you intend to be read only by editors within <code>&lt;!--</code> and <code>--&gt;</code>.
==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.


For example, the following:
==Commentaire invisibles==
:<code>hello &lt;!-- This is a comment. --&gt; world<br/></code>
* Eviter de préciser que l'article est incomplet ou nécessite d'être repris.
is displayed as:
* 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 <code>&lt;!--</code> et <code>--&gt;</code>. Par exemple:  
:<code>hello &lt;!-- Ceci est un commentaire. --&gt; le monde!<br /></code>
est affiché comme:
:hello <!-- Ceci est un commentaire. --> le monde!


<div style="background-color: white">
De sorte que le commentaire est visible uniquement en regardant la source wiki ou HTML.
:hello <!-- This is a comment. --> world
</div>


So the comment can be seen when viewing the HTML or wiki source.
==Liens externes==
* Les liens externes vers des contenus qui sont hors du wiki apparaissent 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 formatés pour décrire le site et le sujet.


===Legibility===
==Divers==
Consider the [[wiktionary:legible|legibility]] of what you are writing. Make your entry easy to read on a screen. Make judicious use of devices such as bulleted lists and bolding. For more on this, see [http://www.useit.com/alertbox/9710a.html "How Users Read on the Web"] by [[Jakob Nielsen (usability consultant)|Jakob Nielsen]].
* 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 <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.
* Eviter d'utiliser des couleurs ou encore des tailles de polices différentesd'un endroit du texte à l'autre.


==External links==
[[Catégorie: Variées]]
Links to articles outside of Wikipedia appear as internal footnotes and can appear in a list at the bottom of the article. They should not appear as their native [[URL]]s, but should be formatted to describe the website and the topic. <nowiki>  Not written as: See link for an examination of evidence supporting both sides of the argument [http://www.nellgavin.com/boleyn_links/boleynhandwriting.htm]. But should be written as: [http://www.nellgavin.com/boleyn_links/boleynhandwriting.htm Anne Boleyn handwriting] </nowiki>. When wikified, it will appear as: [http://www.nellgavin.com/boleyn_links/boleynhandwriting.htm Anne Boleyn handwriting].
[[Catégorie:Aides]]

Dernière version du 15 octobre 2020 à 14:11

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

Les nouveaux articles

  • Pour créer une page wiki, chercher dans la barre de recherche si le nom de votre page existe déjà. Si ce n'est pas le cas, vous pouvez créer votre page en cliquant sur le lien rouge nommé par le nom de votre recherche.
  • 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 malgré des similitudes avec un article existant, il faut créer un article 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 appuient ou exemplifient 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 succinctement 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é.

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

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.

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

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 abréviations

  • Ne jamais supposer que le lecteur comprend les acronymes et les abré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'abré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 abré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 retranscrite 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 l'on 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 majuscule, 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 <!-- 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.

Liens externes

  • Les liens externes vers des contenus qui sont hors du wiki apparaissent 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 formaté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.