--- title: Lignes directrices générales pour tous les exemples de code slug: MDN/Guidelines/Code_guidelines/General tags: - Code - General - Guide - Directives - MDN Meta translation_of: MDN/Guidelines/Code_guidelines/General --- {{MDNSidebar}} Les directives suivantes concernant les exemples de code s'appliquent à tout le code, qu'il s'agisse de HTML, de CSS, de JavaScript ou d'autre chose. ## Dans cet article - [Indentation, espacement, taille](#indentation_spacing_size) - [Indentation](#indentation) - [Longueur des lignes de code](#code_line_length) - [Hauteur des blocs de code](#code_block_height) - [Directives pour l'affichage des exemples](#guidelines_for_displaying_examples) - [Taille du rendu des exemples](#size_of_rendered_example) - [Utilisation d'images et d'autres médias](#use_of_images_and_other_media) - [Utilisation de la couleur](#use_of_color) - [Mettre en évidence les exemples de bonnes et de mauvaises pratiques](#highlight_good_and_bad_practice_examples) - [Rédaction de sections syntaxiques sur les pages de référence](#writing_syntax_sections_on_reference_pages) ## Indentation, espacement, taille ### Indentation Tout le code doit utiliser 2 espaces pour l'indentation, par exemple : ```html example-good
C'est mon paragraphe.
` et lui donner la coloration syntaxique appropriée. La source du code ressemblera à quelque chose comme ceci : ```js function myFunc() { console.log('Hello!'); };``` Pour en faire un bon exemple, vous insérez `example-good` juste avant le guillemet fermant de l'attribut `class` : ```html
... ``` Pour en faire un mauvais exemple, vous insérez `example-bad` juste avant le guillemet fermant de l'attribut `class` : ```html... ``` Nous aimerions vous encourager à les utiliser. Il n'est pas nécessaire de les utiliser partout, mais seulement lorsque vous signalez spécifiquement les bonnes et mauvaises pratiques dans votre code. ## Rédaction de sections syntaxiques sur les pages de référence Les pages de référence MDN comprennent des sections Syntaxe qui indiquent sans ambiguïté quelle peut/doit être la syntaxe d'une fonctionnalité, par exemple une méthode JavaScript, une propriété CSS, un élément HTML, etc. Des directives pour les rédiger sont données sur le document [Sections syntaxiques](/fr/docs/MDN/Structures/Syntax_sections).