TOML

Qu’est-ce qu’un fichier TOML ?

Un format de configuration qui reste lisible sans hériter des pièges d’indentation du YAML.

Ce qu’est TOML

TOML est un format texte que n’importe quel éditeur ouvre. Il est utilisé pour la retouche.

L’extension est .toml et le nom complet Tom's Obvious Minimal Language. L’un et l’autre comptent moins que ce que le fichier peut contenir, et c’est le sujet du reste de cette page.

D’où vient TOML

Il remonte à 2013. La spécification est TOML 1.0.

L’âge est utile à connaître pour une raison pratique : plus un format est ancien, plus les programmes ont eu le temps de l’apprendre.

La spécification est publique

N’importe qui peut l’implémenter sans demander l’autorisation ni payer de licence. C’est pourquoi ce format apparaît dans tant de programmes, et pourquoi des fichiers écrits il y a vingt ans s’ouvrent encore.

Rien n’est jeté

TOML enregistre son contenu à l’identique. Le réenregistrer ne change rien : vous pouvez l’ouvrir, le modifier et le réenregistrer autant de fois que vous voulez sans accumuler de dégâts, et c’est ce qui en fait un format de travail plutôt qu’un format de livraison.

On peut y laisser des notes

TOML a une syntaxe de commentaires, et c’est la différence entre un fichier qu’une personne entretient et un fichier qu’un programme écrit. Les commentaires sont la première chose perdue en convertissant vers un format qui n’en a pas, et rien ne vous prévient.

Ce qui ouvre TOML

Visual Studio Code le lit, comme la plupart des programmes du même genre.

Quand un fichier ne s’ouvre pas, le format est rarement en cause : le plus souvent, c’est le programme qui est plus ancien que lui. Convertir vers quelque chose de plus ancien est le contournement fiable, et c’est à cela que sert le reste de ce site.

L’ouvrir dans un navigateur

Aucun navigateur ne le lit.

C’est de loin la raison la plus fréquente de le convertir : non pas que le format soit mauvais, mais que l’endroit où vous voulez montrer le fichier ne sache pas le lire.

C’est un format de travail

TOML est fait pour être ouvert et modifié. Gardez le fichier dans ce format tant que le travail dure, et exportez depuis lui chaque fois qu’une version finie est nécessaire.

Les données, au même endroit

Identifiants et origine du format TOML.
Extension.toml
Type de médiaapplication/toml
Première publication2013
SpécificationTOML 1.0

Convertir TOML en autre chose

Convertir autre chose en TOML

Formats à envisager à la place de TOML