# Référence : langages colorés > Description neutre des fichiers que Turbo Go colore, de la façon dont il décide, et de ce que reconnaît chaque scanner. ## Reconnaissance L'**extension** d'un fichier décide dès qu'elle fait partie de celles-ci : | Extension | Langage | | --- | --- | | `.go` | Go | | `.toml` | TOML | | `.yaml`, `.yml` | YAML | | `.md`, `.markdown` | Markdown | | `.js`, `.mjs`, `.cjs` | JavaScript | | `.html`, `.htm` | HTML | | `.xml`, `.xsd`, `.xsl`, `.xslt`, `.svg`, `.plist`, `.csproj`, `.pom` | XML | | `.sh`, `.bash`, `.zsh` | Shell | | `.dockerfile`, `.containerfile` | Dockerfile | Les extensions sont comparées sans tenir compte de la casse, et seule la dernière compte : `main.go.backup` n'est pas du Go. Un fichier dont l'extension ne décide de rien est ensuite cherché par son **nom**. Seuls les fichiers sans extension exploitable en ont besoin : | Nom | Langage | | --- | --- | | `Dockerfile`, `Containerfile` | Dockerfile | Un nom correspond sur sa totalité ou sur la partie précédant le premier point, sans tenir compte de la casse — ainsi `Dockerfile`, `dockerfile` et `Dockerfile.dev` sont tous reconnus, tandis que `Dockerfile.md` est du Markdown, puisque l'extension est consultée en premier. Un fichier qu'aucun des deux tableaux ne revendique est un **script shell** si sa première ligne est un shebang nommant un shell — `sh`, `bash`, `zsh`, `dash` ou `ksh`, comme élément de chemin ou comme argument d'`env`. C'est ce qui colore `configure`, un hook git, ou un script que quelqu'un a renommé. | Première ligne | Résultat | | --- | --- | | `#!/bin/sh` | Shell | | `#!/usr/bin/env bash` | Shell | | `#!/usr/bin/env -S bash -e` | Shell | | `#!/usr/bin/env python3` | Non coloré | | Tout ce qui ne commence pas par `#!` | Non coloré | L'ordre est fixe — extension, puis nom, puis première ligne — et le premier qui décide l'emporte : un fichier `.go` commençant par un shebang reste du Go. Tout le reste est affiché en texte brut. Ce n'est pas une erreur — ouvrir un PNG dans l'éditeur n'est pas une faute, c'est simplement non coloré. ## Classes Tous les scanners produisent le même vocabulaire de classes, et chacune correspond à une clé de thème. | Classe | Clé de thème | Produite par | | --- | --- | --- | | `identifier` | `syntax.identifier` | Go, TOML, JavaScript, shell, YAML, Dockerfile | | `keyword` | `syntax.keyword` | Go, JavaScript, shell, HTML (doctype), XML, Dockerfile | | `type` | `syntax.type` | Go, TOML (en-têtes de table), YAML (étiquettes) | | `builtin` | `syntax.builtin` | Go, JavaScript, shell (builtins et expansions), YAML (ancres et alias), Dockerfile (variables) | | `constant` | `syntax.constant` | Go, TOML, JavaScript, shell, YAML, HTML et XML (entités) | | `function` | `syntax.function` | Go, JavaScript, shell (la commande) | | `string` | `syntax.string` | tous | | `char` | `syntax.char` | Go | | `number` | `syntax.number` | Go, TOML, JavaScript, shell, YAML, Dockerfile | | `comment` | `syntax.comment` | Go, TOML, JavaScript, shell, HTML, YAML, XML, Dockerfile | | `operator` | `syntax.operator` | Go, TOML, JavaScript, shell, HTML, YAML (en-têtes de scalaire de bloc), XML, Dockerfile | | `punctuation` | `syntax.punctuation` | Go, TOML, JavaScript, shell, Markdown, YAML, Dockerfile | | `heading` | `syntax.heading` | Markdown | | `tag` | `syntax.tag` | HTML, XML | | `attribute` | `syntax.attribute` | HTML, XML, Dockerfile (options) | | `emphasis` | `syntax.emphasis` | Markdown | | `link` | `syntax.link` | Markdown | ## Go Tokenisé par `go/scanner`, le lexer qu'utilise la chaîne d'outils Go elle-même. Voir [Coloration et complétion](../explanation/colouring-and-completion.md). ## TOML | Reconnu | Comme | | --- | --- | | `# commentaire` | comment | | `[table]`, `[[array]]` | le nom en type, les crochets en punctuation | | `clé =` | identifier, puis operator | | `"basique"`, `'littérale'`, `"""multi-ligne"""`, `'''multi-ligne'''` | string | | `true`, `false` | constant | | nombres, dates, heures, `inf`, `nan` | number | ## YAML Un fichier compose, un manifeste Kubernetes et un workflow d'intégration continue sont tous cela : il n'y a pas de dialecte séparé, parce qu'un dialecte serait le schéma de quelqu'un d'autre à maintenir en phase. | Reconnu | Comme | | --- | --- | | `# commentaire` | commentaire | | `clé:` suivie d'une espace ou de la fin de ligne | la clé en identifiant, le deux-points en ponctuation | | `"entre guillemets": 1`, `'apostrophes': 1` | la clé citée en identifiant | | `- ` ouvrant une entrée de séquence | ponctuation | | `"…"`, `'…'` | chaîne | | `true`, `false`, `yes`, `no`, `on`, `off`, `null` | constante, quelle que soit la casse | | nombres, dates et heures écrits sans guillemets | nombre | | `&ancre`, `*alias` | builtin | | `!!str`, `!Custom` | type | | `---`, `...` | toute la ligne en ponctuation | | `{`, `}`, `[`, `]`, `,` | ponctuation | | `\|`, `>`, avec leurs indicateurs de coupe et d'indentation | l'en-tête en opérateur, le corps en chaîne | **Un deux-points n'est un séparateur que si une espace ou la fin de ligne le suit.** `image: nginx:1.27` est une clé et une seule valeur, et `url: http://example.com/x` une clé et une seule URL — colorer les deux-points intérieurs en séparateurs mettrait chaque étiquette d'image et chaque URL en trois couleurs. **L'étendue d'un scalaire de bloc est décidée par l'indentation**, pas par un délimiteur. La première ligne de contenu après `|` ou `>` fixe l'indentation du bloc ; toute ligne indentée au moins autant lui appartient, et la première qui ne l'est pas y met fin. **Une ligne vide à l'intérieur d'un bloc y reste** : un scalaire littéral conserve ses lignes vides, et terminer le bloc au premier saut de paragraphe couperait en deux un script shell dans un fichier d'intégration continue. **Un `#` a besoin d'une espace devant lui pour ouvrir un commentaire**, si bien que `colour: ff#00aa` est un seul scalaire. | Non reconnu | Parce que | | --- | --- | | Le schéma d'un fichier compose, d'un manifeste ou d'un workflow | Colorer `services:` autrement qu'une clé quelconque revient à transporter le schéma de quelqu'un d'autre, qui se périme le jour où il ajoute une clé | | Les flux multi-documents comme documents distincts | `---` est coloré, mais rien n'est réinitialisé à cet endroit ; rien dans la coloration ne dépend des frontières de documents | | Si un mot nu est une chaîne ou un nombre pour un analyseur | `1.2.3` est une version pour un lecteur et une chaîne pour YAML ; l'analyseur colore ce à quoi cela ressemble | ## Markdown | Reconnu | Comme | | --- | --- | | `# Titre` … `###### Titre` | toute la ligne en heading | | `**gras**`, `__gras__`, `*italique*`, `_italique_` | emphasis | | `` `code` `` | string | | `[texte](cible)`, `![alt](src)` | l'ensemble en link | | `- `, `* `, `+ `, `1. `, `1) ` | le marqueur en punctuation | | `>` | punctuation | | `---`, `***`, `___` | punctuation | | clôtures ` ``` ` et `~~~` | tout le bloc, lignes d'ouverture et de fermeture comprises, en string | Un bloc clôturé est **d'une seule couleur quel que soit le langage annoncé** : ```` ```go ```` ne colore pas son contenu en Go. La suite de marqueurs qui ouvre un bloc doit être fermée par le même caractère : une clôture en accents graves ne se ferme pas par des tildes. Une clôture non fermée colore jusqu'à la fin du fichier. La suite de marqueurs qui ouvre une emphase doit être fermée par une suite de même longueur, de sorte que `**gras**` fasse un seul span et non deux italiques. ## JavaScript | Reconnu | Comme | | --- | --- | | `const`, `let`, `function`, `class`, `async`, `await`, `import`, `export`, … | keyword | | `true`, `false`, `null`, `undefined`, `NaN`, `Infinity`, `this` | constant | | `console`, `document`, `window`, `Array`, `Object`, `Promise`, `Math`, `JSON`, … | builtin | | un nom immédiatement suivi de `(` | function | | `"…"`, `'…'` | string | | `` `…` ``, interpolations comprises, sur plusieurs lignes | string | | `//` jusqu'à la fin de la ligne, `/* … */` sur plusieurs lignes | comment | | `42`, `3.14`, `0x1f`, `0b1010`, `0o777`, `1_000_000`, `1e6`, `10n` | number | | suites de `+-*/%=<>!&|^~?:` | operator | | `()[]{},;.` | punctuation | **Les littéraux d'expression régulière ne sont pas reconnus.** Distinguer `/x/g` d'une division exige de savoir si le token précédent pouvait terminer une expression ; une mauvaise supposition colore le reste de la ligne comme une chaîne, ce qui est pire que de laisser une regex à la couleur d'un opérateur. Les globales sont reconnues par leur nom : un fichier qui masque `Math` la voit quand même colorée comme un builtin — la même règle que les identifiants prédéclarés de Go. ## HTML | Reconnu | Comme | | --- | --- | | ``, `/>` | tag | | noms d'attributs, dont `data-*`, `xlink:href`, `@click`, `v-bind.prop` | attribute | | `=` | operator | | `"…"`, `'…'` | string | | ``, sur plusieurs lignes | comment | | `&`, `©` | constant | | `` et les autres déclarations | keyword | Le texte entre balises n'est pas coloré. Une esperluette isolée sans `;` dans les 32 caractères qui suivent est laissée telle quelle, parce que c'est du texte légal. **Le contenu de `