# Форматиране на TOML

Форматирайте TOML конфигурационни файлове, като Cargo.toml, pyproject.toml и други настройки на приложения, с TOML приставката Prettier. Форматиращият инструмент уеднаквява интервалите около знаците за равенство, вградените таблици и масивите, разделя таблиците с празен ред, запазва всички коментари и съобщава синтактичните грешки с ред и колона, така че разработчиците да могат безопасно да подредят конфигурацията преди commit.

## Често задавани въпроси

### Кой механизъм форматира TOML?

Инструментът използва Prettier 3 с prettier-plugin-toml 4.1 на сървъра. Той чете документи TOML 1.0 и ги извежда в единен стил.

### Какво се променя в резултата?

Между ключовете и стойностите и знака за равенство се поставя по един интервал, а вградените таблици и масивите се форматират равномерно. Допълнителните празни редове се премахват, а всеки раздел с таблица се отделя от предходния с празен ред.

### Запазват ли се коментарите?

Да. Коментарите на отделен ред и коментарите след стойности остават на мястото си, така че поясненията в конфигурационните файлове се запазват.

### Ще бъдат ли сортирани ключовете или таблиците?

Не. Ключовете, таблиците и масивите от таблици запазват първоначалния си ред, което е важно за файловете, които хората четат от начало до край.

### Могат ли кавичките около низовете да се променят?

Низовете с единични кавички може да бъдат пренаписани с двойни, ако стойността не съдържа обратна наклонена черта или двойна кавичка, без да се променя самата стойност. Низовете, които изискват буквално цитиране, запазват единичните си кавички.

### Как се обработват дългите масиви?

Масивите, които се побират в ширината за печат, остават на един ред. Масивите със завършваща запетая или надхвърлящи ширината се отпечатват с по един елемент на ред.

### Какво се случва при невалиден TOML?

Форматирането спира и инструментът показва съобщението на анализатора с реда и колоната, например когато липсва стойност след знак за равенство. Дублираните ключове и другият невалиден TOML се съобщават по същия начин.

### Мога ли да променя отстъпа?

Да. Изберете отстъп от 2 или 4 интервала или табулации за вложени масиви и ширина на реда за печат от 40 до 200 знака; по подразбиране е 80.

### Колко голям може да бъде файлът?

До 1 MB текст на заявка — много повече от обичайния размер на конфигурационните файлове. Форматирането спира след 10 секунди.

### Съхранява ли се конфигурацията ми?

Не. Конфигурационните файлове може да съдържат тайни, затова съдържанието се обработва само в паметта и никога не се запазва или записва в логове.

Вашата реклама тук?

[Пишете ни](mailto:hi@dennn.is?subject=%D0%A0%D0%B5%D0%BA%D0%BB%D0%B0%D0%BC%D0%B0%20%D0%B2%20OneClick%20Pro)

[Реклама Комплект плъгини за агенти за WordPress.](https://sleekwp.com/?ref=oneclickpro)