Fr/FlightGear wiki:Manual of Style

From FlightGear wiki
Jump to navigation Jump to search

Version traduite le 21 novembre 2022 Pending Pending 50}% completed

Cet article est en cours de traduction.


Shortcut
FGW:MOS

Le manuel de style est un guide pour tous les articles du wiki FlightGear. Il aide les éditeurs à rédiger des articles avec un langage clairs et précis, une mise en page et un formatage homogènes. Le but est de rendre l'utilisation de ce wiki plus facile et plus intuitive. Un langage, un style et une mise en forme homogènes favorisent la clarté et la cohésion. La rédaction doit être claire et concise. Le style direct et simple fonctionne mieux; évitez l'ambiguïté, le jargon et les formulations vagues ou inutilement complexes.

Débattez des problèmes de style sur la page de discussion.

Titres, en-têtes et sections des articles

Titres des articles

  • Servez-vous de la casse de la phrase, pas la casse du titre. La lettre initiale d'un titre est en majuscule (sauf dans de rares cas, comme eBay par exemple), mais sinon, les majuscules ne sont employées que là où elles sont utilisées dans une phrase normale (Liste des aéroports développés, pas Liste des Aéroports Développés). De plus, gardez à l'esprit que le logiciel wiki met automatiquement en majuscule la première lettre d'un espace de noms ou d'un titre de page dans son URL.
  • Les titres doivent être suffisamment précis pour définir sans ambiguïté la portée thématique de l'article (par exemple, Boeing 747, pas 747).
  • Les caractères # < > [ ] | { } sont réservés par le logiciel wiki et ne peuvent pas être utilisés dans le texte.

Organisation des sections

Un article doit commencer par une section d'introduction, qui ne doit pas contenir de titres de section. Le reste peut être divisé en sections, chacune avec un titre de section (voir ci-dessous) qui peut être imbriqué dans une hiérarchie. S'il y a au moins quatre titres de section dans l'article, une table des matières navigable est générée automatiquement et affichée entre le titre principal et le premier titre.

Titres de section

Des signes égal (=) sont utilisés pour marquer le texte inclus comme en-tête de section : == Titre == pour une section principale ; === Titre === pour le niveau suivant (une sous-section); et ainsi de suite jusqu'à la sous-section de niveau le plus bas, avec ===== Titre =====. (Le niveau de titre le plus élevé techniquement possible est = Titre =; mais ne l'utilisez pas dans les articles, car il est réservé au titre de niveau supérieur généré automatiquement en haut de la page contenant le titre de l'intégralité de l'article.) Des espaces entre les les signes égal et le texte du titre sont facultatifs et n'affectent pas la façon dont le titre est affiché. Le titre doit être saisi sur une ligne distincte. Inclure une ligne vierge au-dessus de l'en-tête, et éventuellement une ligne vierge en dessous, pour la lisibilité dans la fenêtre d'édition (mais pas deux ou plusieurs lignes vierges consécutives, ce qui ajoutera un espace blanc visible inutile dans la page rendue.)

Les dispositions des titres d'article (ci-dessus) s'appliquent également aux titres de section (par exemple, les titres sont en casse de phrase, pas en casse de titre). Les points suivants s'appliquent spécifiquement aux titres de section :

  • Les titres ne doivent normalement pas contenir de liens, en particulier lorsqu'une partie seulement d'un titre est liée.
  • Les titres de section et de sous-section doivent de préférence être uniques dans une page ; sinon, les liens de section peuvent mener au mauvais endroit et les résumés de modification automatiques peuvent être ambigus.
  • Les citations ne doivent pas être placées dans ou sur la même ligne que les titres de section et de sous-section.
  • Les titres ne doivent pas contenir d'images.

Les majuscules

La casse des phrases, au lieu de la casse des titres, est utilisée dans les titres d'articles wiki et les en-têtes de section ; voir les titres des articles et les titres des sections ci-dessus. Pour l'utilisation des majuscules dans les éléments de liste, voir Listes à puces et numérotées. D'autres points concernant les majuscules sont résumés ci-dessous.

N'utilisez pas de majuscules pour accentuer

Utilisez des italiques, pas des majuscules, pour indiquer une mise en évidence.

Incorrect: It is not only a LITTLE learning that is dangerous.
Correct: It is not only a little learning that is dangerous.

Objets de calendrier

Les mois, les jours de la semaine et les jours fériés commencent par une majuscule (Juin, Lundi).

Corps célestes

Lorsqu'ils sont utilisés de manière générale, les mots soleil, terre et lune ne prennent pas de majuscules (Le soleil pointait au-dessus du sommet de la montagne), sauf lorsque le terme désigne un corps astronomique spécifique (La Lune tourne autour de la Terre).

Points cardinaux

Ne mettez pas de majuscules aux directions telles que le nord, ni leurs formes associées (Suivez la route du nord), sauf lorsqu'elles font partie de noms propres (tels que Pôle Sud).

Mettez une majuscule aux noms de régions s'ils ont atteint le statut de nom propre, y compris les noms conventionnels informels (Californie du Sud ou Sahara Occidental). Ne mettez pas de majuscules dans les noms descriptifs des régions qui n'ont pas atteint le statut de noms propres, comme le sud de la Pologne.

(Les directions composites peuvent ou non comporter un trait d'union, selon le style adopté dans l'article. L'Asie du Sud-Est et le nord-ouest sont plus courants en français que l'Asie du Sud Est ou le nord ouest. Dans les cas tels que dialogue nord-sud et orientation est-ouest, un tiret demi-cadratin est utilisé).

Abréviations

Écrivez à la fois la version complète et l'abréviation à la première occurrence

  • Lorsqu'une abréviation doit être utilisée dans un article, donner d'abord l'expression en entier, suivie immédiatement de l'abréviation entre parenthèses (parenthèses rondes). Dans la suite de l'article l'abréviation peut alors être réemployée seule :

L'instrument landing system (ILS) est un système d'approche aux instruments au sol., à la première mention du système d'atterrissage aux instruments ; et Il existe trois catégories d'ILS, lors d'une mention ultérieure.

  • N'appliquez pas de majuscules initiales dans une version complète tout simplement parce que les majuscules sont utilisées dans l'abréviation.
Correct: There are two types of flight rules: visual flight rules (VFR) and instrument flight rules (IFR).
Incorrect: There are two types of flight rules: Visual Flight Rules (VFR) and Instrument Flight Rules (IFR).

Esperluette

L'esperluette (&) remplace le mot et (c'est une forme du et latin). Dans le texte normal, et doit être utilisé à la place : version 1 et 2, et non version 1 & 2. Les esperluettes peuvent être utilisées avec cohérence et discrétion dans les tableaux, les infobox et les contextes similaires où l'espace est limité.

Italiques

Accentuation

L'italique peut être utilisé avec parcimonie pour souligner les mots dans les phrases (alors que le gras n'est normalement pas utilisé à cette fin). Généralement, plus un article est mis en avant, moins il est efficace.

Citation en italique

Les citations doivent toujours être clairement indiqués comme étant des citations. Pour les baliser, utilisez uniquement des guillemets (pour les citations courtes) ou des blocs de citations (pour les longues), et non des italiques. (Voir Citations) Cela signifie que :

  1. une citation n'est pas en italique à l'intérieur de guillemets ou d'un bloc de citation simplement parce qu'il s'agit d'une citation ;
  2. les italiques ne remplacent pas la mise en forme approprié des citations.

Citations

Lorsque la même citation a été employée ailleurs dans l'article, évitez de la dupliquer, ce qui est considéré comme un style médiocre.

La citation doit être représentative de l'ensemble du document source ; les éditeurs doivent être très prudents pour éviter une fausse représentation de l'argument dans la source. Lorsqu'une citation présente un langage rhétorique à la place d'un ton plus neutre et impartial préféré pour les encyclopédies, cela peut être une méthode détournée pour insérer un traitement non neutre d'un sujet controversé dans le récit du wiki sur le sujet, et doit être évitée.

Les citations doivent généralement être insérées dans le texte de l'article, afin de ne pas entraver le rythme, la fluidité et l'organisation de l'article. Les citations plus longues peuvent avoir besoin d'être mises à part, généralement grâce à l'utilisation de modèles de texte wiki tels que {{Quote}} ou {{Quotation}}. Des citations plus longues peuvent également être masquées dans la référence (note de bas de page) pour faciliter la vérification par d'autres éditeurs sans sacrifier la lisibilité. Pour les guillemets (citations du texte de l'article utilisées pour mettre en évidence une section), le modèle {{Cquote}} peut être appliqué. Les citations utilisées uniquement comme sources pour soutenir les déclarations contenues dans l'article peuvent être ajoutées avec une balise <ref> contenant une référence formatée avec le modèle {{cite web}}. Dans ce cas, ajoutez {{Appendix}} à la fin de la page afin que les citations puissent être affichées de manière uniforme.

Texte original

Les citations doivent être attribuées de manière vérifiable et le libellé du texte cité doit être fidèlement reproduit. S'il y a une erreur significative dans la déclaration d'origine, utilisez [sic] pour montrer que l'erreur n'a pas été commise par les éditeurs du wiki. Cependant, les fautes d'orthographe et de typographie insignifiantes doivent simplement être corrigées sans commentaire (par exemple, corriger essentielement par essentiellement), à moins que la faute soit textuellement significative.

Utilisez des points de suspension pour indiquer des omissions dans le texte cité. Les omissions légitimes incluent les mots superflus, non pertinents ou entre parenthèses. N'omettez pas de texte lorsque cela supprimerait un contexte important ou modifierait le sens du texte.

Conformité typographique

Dans la plupart des cas, il n'est pas souhaitable de dupliquer la mise en forme d'origine. Celle-ci et les autres éléments purement typographiques du texte cité doivent être adaptés aux conventions du wiki sans commentaire à condition que cela ne change pas ou n'obscurcisse pas le sens du texte. Ce sont des altérations qui ne font aucune différence lorsque le texte est lu à haute voix, telles que :

  • Changer la capitalisation pour que les phrases commencent par des majuscules.
  • Lorsque vous mentionnez une citation qui contient elle-même une citation, les guillemets simples peuvent être remplacés par des guillemets doubles, et vice versa. Voir la section ci-dessous.
  • Supprimez les espaces superflus avant la ponctuation tels que les points et les deux-points.
  • Conservez généralement le gras et l'italique (voir Italique, ci-dessus), mais la plupart des autres styles doivent être modifiés.
  • Donnez la version complète de l'abréviations.

Citations imbriquées

Pour les citations imbriquées, utilisez des guillemets doubles (les plus à l'extérieur) pour la première citation puis, en travaillant vers l'intérieur, alternez des guillemets simples avec des guillemets doubles.

Attribution

L'auteur d'une citation d'une phrase complète ou plus doit être nommé ; cela se fait dans le texte principal et non dans une note de bas de page. Un lecteur ne devrait pas avoir à suivre une note de bas de page pour savoir à qui appartient une citation.

Liens

Dans la mesure du possible, évitez les liens à l'intérieur des citations, qui pourraient l'encombrer, violer le principe de laisser les citations inchangées et induire en erreur ou créer de la confusion chez le lecteur.

Citations en bloc

Formatez une citation longue (environ plus de 40 mots ou quelques centaines de caractères, ou composée de plus d'un paragraphe, quelle que soit sa longueur) comme une citation en bloc, que le logiciel du wiki mettra en retrait à partir des deux marges. Ne mettez pas les blocs de citations entre guillemets (et surtout évitez les guillemets décoratifs en usage normal, tels que ceux fournis par le modèle {{cquote}} qui sont réservés aux guillemets tirés ; sections citées ailleurs dans le même article wiki). Les citations en bloc peuvent être ajoutées avec les modèles {{quote}} ou {{quotation}}.

Surutilisation des citations

De longues citations envahissent l'article lui-même et détournent l'attention d'autres informations. De nombreuses citations directes peuvent être réduites en longueur en fournissant un contexte approprié dans le texte environnant. Un résumé ou une paraphrase d'une citation est souvent préférable là où la formulation originale pourrait être améliorée. Envisagez de réduire la longueur d'une citation en la paraphrasant, en intégrant de plus petites portions de citation dans le texte de l'article, ou les deux.

La surutilisation se produit lorsque une citation est utilisée sans pertinence. Cela signifie qu'une citation est visuellement sur la page, mais sa pertinence n'est expliquée nulle part.

Recommandations particulières

  • Utiliser trop de guillemets est incompatible avec le style d'écriture encyclopédique.
  • Pour une question de style, les boîtes de citation (quotebox) doivent généralement être évitées car elles attirent particulièrement l'attention sur l'opinion d'une source et présentent cette opinion comme si le projet l'approuvait. Au lieu d'utiliser des boites de citation pour souligner sa notoriété, expliquez son importance avant d'introduire la citation ou dans une introduction à la citation.
  • Le wiki n'est pas une liste ou un référentiel de sujets vaguement associés tels que des citations.
  • N'insérez pas à demandes un avis sur les pages de discussion, fotum et Village pump !
  • Une citation qui n'est pas directement liée au sujet de l'article ou qui ne soutient pas directement l'information telle qu'elle est présentée ne doit pas être intégrée à l'article.
  • Intercalez les citations avec une prose originale qui commente ces citations au lieu de construire des articles à partir de citations avec peu ou pas de prose originale.
  • Des citations plus longues peuvent être masquées dans la référence sous forme de note de bas de page pour faciliter la vérification par d'autres éditeurs sans sacrifier la lisibilité.

Ponctuation

Apostrophes

L'utilisation de l'apostrophe droite (ou de machine à écrire) ( ' ) est recommandée, par opposition à l'apostrophe bouclée (ou typographique) ( ’ ).

Guillemets

Double ou simple

Encapsulez les citations entre guillements (Bob said, "Jim ate the apple."). Encapsulez les citations imbriquées dans une autre citation entre apostrophes (Bob said, "Did Jim say 'I ate the apple' after he left?").

Block quotes

As already noted above, we use quotation marks or block quotes (not both) to distinguish long quotations from other text. Multiparagraph quotations are always block-quoted. The quotations must be precise and exactly as in the source (except for certain allowable typographical changes, also noted above). The source should be cited clearly and precisely.

Crochets et parenthèses

These rules apply to both round brackets ( ), often called parentheses, and square brackets [ ].

If a sentence contains a bracketed phrase, place the sentence punctuation outside the brackets (as shown here). However, where one or more sentences are wholly inside brackets, place their punctuation inside the brackets. There should be no space next to the inner side of a bracket. An opening bracket should usually be preceded by a space, for example. This may not be the case if it is preceded by an opening quotation mark, another opening bracket, or a portion of a word.

There should be a space after a closing bracket, except where a punctuation mark follows (though a spaced dash would still be spaced after a closing bracket) and in unusual cases similar to those listed for opening brackets.

If sets of brackets are nested, use different types for adjacent levels of nesting; for two levels, it is customary to have square brackets appear within round brackets. This is often a sign of excessively convoluted expression; it is often better to recast, linking the thoughts with commas, semicolons, colons, or dashes.

Avoid adjacent sets of brackets. Either put the parenthetic phrases in one set separated by commas, or rewrite the sentence.

Square brackets are used to indicate editorial replacements and insertions within quotations, though this should never alter the intended meaning. They serve three main purposes.

Phrases et parenthèses

  • If any sentence includes material that is enclosed in square or round brackets, it still must end—with a period, or a question or exclamation mark—after those brackets. This principle applies no matter what punctuation is used within the brackets.
  • However, if the entire sentence is within brackets, the closing punctuation falls within the brackets. (This sentence is an example.) This does not apply to matter that is added (or modified editorially) at the beginning of a sentence for clarity, which is usually in square brackets.

Points de suspension

An ellipsis (plural ellipses) is used to indicate an omission of material from quoted text or some other omission, perhaps of the end of a sentence, often in a printed record of conversation. The ellipsis is represented by ellipsis points: a set of three unspaced periods, surrounded by square brackets [...].

Dates et heures

Moment de la journée

Time of day is normally expressed in figures rather than being spelled out. Context determines whether the 12- or 24-hour clock is used.

  • 12-hour clock times are written in the form 11:15 a.m. and 2:30 p.m., or the form 11:15 am and 2:30 pm, with a space before the abbreviation.
  • 24-hour clock times are written in the form 08:15, 22:55, with no suffix. Note that 00:00 refers to midnight at the start of a date, and 24:00 to midnight at the end of a date.

Jours

  • For full dates, use the format 10 June 1921 or the format June 10, 1921. Similarly, where the year is omitted, use 10 June or June 10. For choice of format, see below.
  • Do not use numerical date formats such as 03/04/2005, as this could refer to 3 April or to March 4. If a numerical format is required (e.g. for conciseness in long lists and tables), use the YYYY-MM-DD format: 2005-04-03.

Choix du format

  • All the dates in a given article should have the same format (day-month or month-day). These requirements do not apply to dates in quotations or titles.
  • Otherwise, do not change an article from one form to another without good reason.

Mois

  • For month and year, write June 1921, with no comma.
  • Abbreviations for months, such as Feb, are used only where space is extremely limited. Such abbreviations should use three letters only, and should not be followed by a period (full stop) except at the end of a sentence.

Années et périodes plus longues

  • Do not use the year before the digits (1995, not the year 1995), unless the meaning would otherwise be unclear.
  • Decades are written in the format the 1980s, with no apostrophe. Use the two-digit form ('80s) only with an established social or cultural meaning. Avoid forms such as the 1700s that could refer to 10 or 100 years.

Current

Use of the term "current" should be avoided. What is current today may not be tomorrow; situations change over time. Instead, use date- and time-specific text.

Incorrect: FlightGear 3.0 is currently the latest version ...
Correct: As of February 2014, FlightGear 3.0 is the latest version ...

Nombres

  • In general, write whole numbers from one to nine as words, write other numbers that take two words or fewer to say as either figures or words (with consistency within each article), and write all other numbers as figures: 1/5 or one-fifth, 84 or eighty-four, 200 or two hundred, but 3.75, 544, 21 million.
  • In general, use a comma to delimit numbers with five or more digits to the left of the decimal point. Numbers with four digits are at the editor's discretion: 12,345, but either 1,000 or 1000.
  • In general, use decimals rather than vulgar fractions with measurements.
  • Write out "million" and "billion" on the first use. After that, unspaced "M" can be used for millions and "bn" for billions: 70M and 25bn.
  • Write 3%, three percent, or three per cent, but not 3 % (with a space) or three %. "Percent" is American usage, and "per cent" is British usage. In ranges of percentages written with an en dash, write only one percent sign: 3–14%.

Unités de mesure

  • The main unit in which a quantity is expressed should generally be an SI unit or non-SI unit officially accepted for use with the SI.
  • In a direct quotation, always keep the source units. If a conversion is required, it should appear within square brackets in the quote, or else an obscure use of units can be explained in a footnote.
  • Where space is limited (such as tables, infoboxes, parenthetical notes, and mathematical formulas) use unit symbols. In main text it is usually better to spell out unit names, but symbols may also be used when a unit (especially one with a long name) is used repeatedly. However, spell out the first instance of each unit in an article (for example, the typical batch is 250 kilograms ... and then 15 kg of emulsifier is added), except for unit names that are hardly ever spelled out (e.g. the degree Celsius). Most unit names are not capitalized. Use "per" when writing out a unit, rather than a slash: meter per second, not meter/second.
  • Potentially unfamiliar unit symbols should be introduced parenthetically at their first occurrence in the article, with the full name given first: for example, His initial betatron reached energies of 2.3 megaelectronvolts (MeV), while subsequent betatrons achieved 300 MeV.
  • When dimensions are given, each number should be followed by a unit name or symbol (e.g. write 1 m × 3 m × 6 m, not 1 × 3 × 6 m).
  • When they form a compound adjective, values and unit names should be separated by a hyphen: for example, a five-day race.
  • Unit symbols are preceded by figures, not by spelled-out numbers. Values and unit symbols are separated by a non-breaking space. For example, 5 min. The percent sign, and units of degrees, minutes, and seconds for angles and coordinates, are unspaced.
  • Standard unit symbols do not require a full stop (period). However non-standard abbreviations should always be given a full stop.
  • No s is appended, e.g. km, in, lb, not kms, ins, lbs.
  • Write powers of unit symbols with HTML, e.g. 5 km<sup>2</sup> not Unicode superscripts and subscripts.
  • For quantities of bytes and bits, specify whether the binary or decimal meanings of K, M, G, etc. are intended.

Grammaire et usage

First-person pronouns

Wiki articles must not be based on one person's opinions or experiences. The use of I, my, or similar forms is restricted to user pages and quotations. Also avoid we, us, and our: We should note that some critics have argued against our proposal (personal rather than encyclopedic).

Vocabulaire

Contractions

Uncontracted forms such as do not or it is are the default in encyclopedic style; don't and it's are too informal.

Termes étrangers

Foreign words should be used sparingly.

Pas d'usage courant en anglais

Use italics for phrases in other languages and for isolated foreign words that are not current in English.

Usage courant en anglais

Loanwords and borrowed phrases that have common usage in English (vice versa) do not require italics. A rule of thumb is not to italicize words that appear unitalicized in major English-language dictionaries.

Langage technique

Some topics are intrinsically technical, but editors should try to make them understandable to as many readers as possible. Minimize jargon, or at least explain it. For unavoidably technical articles a separate introductory article may be the best solution. Avoid excessive wikilinking (linking within the wiki) as a substitute for parenthetic explanations such as the one in this sentence. Do not introduce new and specialized words simply to teach them to the reader when more common alternatives will do. When the notions named by jargon are too complex to concisely explain in a few parenthetical words, write one level down. For example, consider adding a brief background section with {{main}} tags pointing to the full treatment article(s) of the prerequisite notions; this approach is practical only when the prerequisite concepts are central to the exposition of the article's main topic, and when such prerequisites aren't too numerous.

Éléments géographiques

Places should generally be referred to consistently by the same name as in the title of their article. Exceptions are made if there is a widely accepted historical English name appropriate to the given context. In cases where such a historical name is used, it should be followed by the modern name in round brackets (parentheses) on the first occurrence of the name in applicable sections of the article. This resembles linking; it should not be done to the detriment of style. On the other hand, it is probably better to provide such a variant too often than too rarely. If more than one historical name is applicable for a given context, the other names should be added after the modern English name, that is: "historical name (modern name, other historical names)".

Images

  • Infoboxes, images, and related content in the lead must be right-aligned.
  • Use captions to clarify the relevance of the image to the article (see Captions, below).
  • Each image should be inside the major section to which it relates (within the section defined by the most recent level 2 heading or at the top of the lead), not immediately above the section heading.
  • Avoid sandwiching text between two images that face each other, and between an image and an infobox or similar.
  • The thumbnail option may be used ("thumb"), or another size may be fixed. The default thumbnail width is 220 pixels; users can adjust this in their preferences. Lead images should be no wider than "upright=1.35" (by default this is 300 pixels).
  • Avoid referring to images as being on the left or right. Image placement is different for viewers of the mobile version of the wiki and might change in the future. Instead, use captions to identify images.

Évitez de saisir des informations textuelles sous forme d'images

Textual information should almost always be entered as text rather than as an image. True text can be colored and adjusted with CSS tags and templates, but text in images cannot be. Images are not searchable and are slower to download. Any important textual information in an image should also appear in the image's alt text, caption, or other nearby text.

Légendes

Photographs and other graphics should always have captions, unless they are "self-captioning" images or when they are unambiguous depictions of the subject of the article.

Mise en forme des légendes

  • Captions normally start with a capital letter.
  • Most captions are not complete sentences, but merely sentence fragments that should not end with a period. If any complete sentence occurs in a caption, all sentences and any sentence fragments in that caption should end with a period.
  • The text of captions should not be specially formatted (with italics, for example), except in ways that would apply if it occurred in the main text.
  • Captions should be succinct; more information about the image can be included on its description page, or in the main text.
  • Captions for technical charts and diagrams may be substantially longer than those for other images. Captions for technical images should fully describe all the elements of the image, and the image's significance.

Listes à puces et numérotées

  • Do not use lists if a passage is read easily as plain paragraphs.
  • Use proper wikimarkup- or template-based list code (see Help:Formatting#Lists and indentation).
  • Do not leave blank lines between items in a bulleted or numbered list unless there is a reason to do so, since this causes the wiki software to interpret each item as beginning a new list.
    • Indents (such as this) are permitted if the elements are "Children" items
  • Use numbers rather than bullets only if:
    • A need to refer to the elements by number may arise; or
    • The sequence of the items is critical.
  • Use the same grammatical form for all elements in a list, and do not mix sentences and sentence fragments as elements.
    • For example, when the elements are:
      • Complete sentences, each one is formatted with sentence case (its first letter is capitalized) and a final period (full stop).
      • Sentence fragments, the list is typically introduced by a lead fragment ending with a colon.
      • Titles of works, they retain the original capitalization of the titles.
      • Other elements, they are formatted consistently in either sentence case or lower case.

Liens

Wikilinks

Make links only where they are relevant and helpful in the context: Excessive use of hyperlinks can be distracting and may slow the reader down. Redundant links clutter the page and make future maintenance harder. High-value links that are worth pursuing should stand out clearly.

Linking to sections: A hash sign (#) followed by the appropriate heading will lead to a relevant part of a page. For example, [[FlightGear#History]] links to a particular section of the article FlightGear.

Initial capitalization: The wiki software does not require that wikilinks begin with an upper-case character. Only capitalize the first letter where this is naturally called for.

Linking in discussion pages: When adding a wikilink to a discussion page, it is preferable to use permalinks instead of ordinary links, since the content may have changed a lot before the next reader reads the comment. To highlight a specific edit, it might also be useful to link to a diff.

External links

Do not use external links in the body of an article. Articles can include an external links section at the end, pointing to further information outside the wiki as distinct from citing sources. The standard format is a primary heading, ==External links==, followed by a bulleted list of links. Identify the link and briefly indicate its relevance to the article: avoid linking to commercial and unrelated web sites, in essence spam. For example:

* [http://flightgear.org Official website]
* [https://sourceforge.net/p/flightgear/codetickets/ Bug tracker]

These will appear as:

Divers

Gardez le balisage simple

The simplest markup is often the easiest to edit, the most comprehensible, and the most predictable. Markup may appear differently in different browsers. Use HTML and CSS markup sparingly; in particular, do not use the CSS float or line-height properties because they break rendering on some browsers when large fonts are used.

An HTML entity is sometimes better than the equivalent Unicode character, which may be difficult to identify in edit mode; for example, &Alpha; is understood where Α (the upper-case form of Greek α) may not be.

Utiliser des modèles

Make use of existing templates whenever possible to ensure articles are styled in a uniform way. See the Templates Help page for a quick introduction to templates.

Problèmes de mise en forme

Modifications in font size, blank space, and color (see Color coding, below) are an issue for the wiki site-wide style sheet, and should be reserved for special cases only.

Typically, the use of custom font styles will:

  • reduce consistency, since the text will no longer look uniform;
  • reduce usability, since it might be impossible for people with custom style sheets (for accessibility reasons, for example) to override it, and it might clash with a different skin as well as inconvenience people with color blindness (see below); and
  • cause disputes, since other editors may disagree aesthetically with the choice of style.

Outside article text, different font sizes are routinely used in navigation templates and infoboxes, tables (especially in larger ones), and some other contexts where alternatives are not available (such as table captions). Specify font sizes relatively (for example in CSS with font-size: 80%) rather than absolutely (like font-size: 8pt).

Code de couleurs

Information should be accessible to all. Do not use color alone to mark differences in text: they may be invisible to people with color blindness. Also, black-and-white printouts, older computer displays with fewer colors, and monochrome displays (older PDAs and cell phones) cannot show such distinctions.

Choose colors that can be distinguished by the readers with the commonest form of colorblindness (red–green), such as maroon and teal; and additionally mark the differences with change of font or some other means (maroon and alternative font face, teal). Avoid low contrast between text and background colors. Viewing the page with Wickline can help with the choice of colors.

In addition to vision accessibility problems, usage of only color to encode attributes in tables instead of a separate sortable column, disables the use of the powerful wiki sortability feature on that attribute for all readers. Even for readers with unimpaired color vision, excessive background shading of table entries impedes readability and recognition of wikilinks. Background color should be used only as a supplementary visual cue, and should be subtle (consider using lighter, less-dominant pastel hues) rather than a glaring spotlight.

Commentaires invisibles

Editors use invisible comments to communicate with each other in the body of the text of an article. These comments are visible only in the wiki source—that is, in edit source mode, not in read mode.

Invisible comments are useful for flagging an issue or leaving instructions about part of the text, where this is more convenient than raising the matter on the talk page. They should be used judiciously, because they can clutter the wiki source for other editors. Check that your invisible comment does not change the formatting, for example by introducing white space in read mode.

To leave an invisible comment, enclose the text you intend to be read only by editors between <!-- and -->. For example: <!--If you change this section title, please also change the links to it on the pages ...-->

Référence

This document contains a selection of relevant sections from Wikipedia:Manual of Style This is a link to a Wikipedia article.

Contenu connexe