Outils YAML

Formateur YAMLDes configurations plus lisibles

Deux espaces et tous les documents par défaut. Les vues Structure et Ancres renvoient aux lignes de la source ; la copie fournit toujours du YAML.

Formateur YAML

YAML source

Résultat

Votre saisie reste dans cet onglet ; aucun contenu n’est envoyé à un serveur.

Options

Résultat périmé. Relancez le formatage.

Le Formateur YAML aide à relire une configuration sans effacer les commentaires qui expliquent ses réglages. Il conserve les ancres, les alias et les écritures numériques d’origine, tout en produisant un résultat distinct du texte saisi.

Pour formater YAML, choisissez deux ou quatre espaces. Le validateur YAML contrôle le flux complet avant de permettre l’export d’un seul document. L’indentation YAML, la structure et les références peuvent ainsi être examinées séparément.

Pourquoi utiliser ce Formateur YAML ?

Garder le contexte des réglages

Une valeur isolée ne raconte pas pourquoi elle a été choisie. Les commentaires accompagnent donc le résultat, tout comme les nombres précis et les références. La mise en page peut évoluer : conserver ces éléments ne signifie pas reproduire chaque espace ni chaque ligne vide.

Deux représentations du même document, avec indentation modifiée et repères de commentaires, nombres et références conservés.

Isoler un document sans masquer les autres

Le contrôle porte sur toutes les parties du flux. Une erreur dans une partie non sélectionnée bloque aussi le résultat, plutôt que de laisser croire que le fichier entier est valide. Après correction, une sélection explicite permet d’exporter un document ou l’ensemble.

Deux documents séparés avec leurs références internes ; un seul rejoint la zone de sortie.

Les détails utiles avant l’export

01

Choisir le moment du contrôle

Le mode automatique attend 350 ms après une modification. Désactivez-le pour afficher le bouton de formatage ; Ctrl/Cmd+Entrée lance aussi le traitement. Tant que le résultat ne correspond pas au texte et aux options actuels, copie et téléchargement restent indisponibles. Exemple et Effacer ouvrent un aperçu avec le nombre de lignes. Appliquer remplace la saisie ; le rétablissement restaure une fois la source, le résultat et les options.

02

Retrouver la bonne ligne

Les numéros de ligne des vues Structure et Ancres désignent la saisie d’origine. Ne les cherchez pas dans le résultat réindenté. Les longues listes affichent 50 éléments à la fois, avec une commande pour poursuivre la lecture.

03

Distinguer affichage et sélection

L’option Document décide du contenu exporté. Les onglets de résultat changent seulement sa présentation. Même depuis la vue des ancres, copier ou télécharger produit le YAML sélectionné, et non le résumé affiché.

Lire les données et leurs liens

Une écriture numérique conservée

Les grands entiers, décimales, exposants et valeurs spéciales autorisées telles que .inf gardent leurs tokens d’origine. La sortie ne repose pas sur une conversion des nombres en flottants JavaScript qui pourrait les arrondir.

Des ancres consultables

Chaque définition et chaque alias porte sa position dans la source et son numéro de document. Les références valides restent des références ; les cycles autorisés ne sont pas développés en arbres de données potentiellement infinis.

Un contrôle des clés en double

Le Formateur YAML refuse les clés scalaires de même valeur sémantique dans une même table. Écrire un nombre autrement ne permet pas de contourner ce contrôle. Aucun choix silencieux de la dernière valeur ne remplace les données précédentes.

Un export à l’échelle du document

Après validation globale, gardez tout le flux ou sélectionnez une seule partie. La saisie complète reste disponible pour revenir à une autre sélection. Aucun découpage ne remplace le texte original.

Ce que le contrôle accepte et refuse

Un seul modèle : YAML 1.2 Core
Les autres directives de version et les tags non pris en charge sont refusés. Les clés peuvent être des chaînes, nombres, booléens ou null, mais pas des collections ni des alias. La clé << reste une clé ordinaire : aucune fusion implicite n’est exécutée.
Une erreur bloque tout le flux
Une syntaxe incorrecte ou une clé en double dans n’importe quel document empêche l’export. Le formateur ne devine pas la bonne indentation et ne remplace pas les tabulations pour réparer la source. Corrigez le texte puis relancez le contrôle.
Les références restent locales
Un alias doit retrouver une ancre définie auparavant dans le même document. Les références inconnues ou entre documents sont refusées ; les références valides ne sont pas développées. Le contrôle syntaxique ne vérifie ni les champs Kubernetes ni les schémas Compose ou CI.
Des limites explicites
Maximum : 500 000 unités UTF-16 en entrée, 100 documents, profondeur 100, 50 000 nœuds et 2 000 000 unités en sortie. Un dépassement arrête le traitement sans export tronqué. Ni tri, minification, conversion JSON, import de fichier ou chargement par URL ne sont proposés.

Questions sur le Formateur YAML

Le formatage peut-il modifier les valeurs ?

Le résultat suit YAML 1.2 Core. Les tokens numériques d’origine sont conservés, tandis que les chaînes peuvent être réécrites sous une autre forme valide. La présentation change ; ce n’est pas une copie identique octet par octet, ni une migration automatique depuis YAML 1.1.

Le contenu YAML part-il vers un serveur ?

Non. L’analyse se fait dans l’onglet ouvert. Il n’y a pas de champ pour transmettre un fichier ou charger une configuration distante. Vous décidez vous-même de récupérer le résultat avec la copie ou le téléchargement.

Quelle taille de fichier peut-on traiter ?

Le plafond d’entrée est de 500 000 unités UTF-16, et non un poids de fichier en octets. S’ajoutent 100 documents, une profondeur de 100 et 50 000 nœuds. La sortie est limitée à 2 000 000 unités. Le traitement s’arrête si une de ces limites est dépassée.

Comment retrouver une erreur de syntaxe ?

Le Formateur YAML indique la ligne et la colonne concernées dans la source. Vérifiez la ponctuation, l’indentation et les clés voisines ; une erreur peut provenir d’une ligne précédente. Le message reste visible dans la page pour vous aider à corriger le texte.

Faut-il ouvrir un compte ?

Non, aucun compte n’est nécessaire. Le même espace de travail permet de tester l’exemple, modifier l’indentation, examiner les références et récupérer le résultat sans procédure d’inscription.

Une difficulté à signaler ?

Relisez votre prochaine configuration

Ouvrez l’exemple du Formateur YAML pour comparer les documents et vérifier ce que contiendra votre export.