YAML を INI に変換

YAML の最上位にあるキーの下にオブジェクトがぶら下がっている場合、そのキーが INI の `[section]` になります。INI は 1 階層しか持てない形式なので、YAML 側の階層をそのまま表現することはできません。

最上位が単純な値であれば、セクションの外にある設定としてそのまま書き出されます。

セクションの内側にさらにオブジェクトが入っている場合、そのキーはドットでつないだ 1 つのキー名として書き出されます。これはこのサイトの表計算系の書き出しで使われているのと同じ「平らにする」処理です。

深く入れ子になった YAML ほど、キー名が長くなります。INI は本来こうした深い構造を想定していない形式なので、複雑な YAML を INI にする場合は、キー名が読みにくくなることを見込んでおいてください。

YAML ファイルにある `#` で始まるコメント行は、読み込みの時点で構造には反映されず、値としてのみ解析されます。設定の意味を説明する注釈があった場合、その説明文は INI には引き継がれません。

重要な注釈がある場合は、変換前に控えておくか、変換後の INI に手作業で書き足す必要があります。

YAML の `true` や `123` といった値は、INI の中ではただのテキストとして書き出されます。INI という形式自体が型を持たないためです。

再び別の形式に読み込む際に、そのテキストがどう解釈されるかは、読み込む側のツール次第です。

YAML の配列も、オブジェクトの入れ子と同様に、添字を含んだドット区切りのキー名に平らにされます。`items: [a, b]` であれば `items.0` と `items.1` という 2 つのキーになります。

INI で配列を自然に表現する標準的な方法はなく、この平坦化は妥協点です。配列を多用した YAML では、キーの数がその分だけ増えることを見込んでおいてください。

解析と平坦化はブラウザーの中で行われ、YAML ファイルがサーバーへ送られることはありません。開発者ツールのネットワークタブを開いたまま試せば確認できます。

設定ファイルは通常小さいため、容量の上限を気にする場面はほとんどありません。無料枠は 1 ファイルあたり 100 MB です。