# Форматувальник TOML

Форматуйте файли конфігурації TOML, як-от Cargo.toml, pyproject.toml та інші налаштування програм, за допомогою плагіна Prettier TOML. Форматувальник нормалізує пробіли навколо знаків рівності, у вбудованих таблицях і масивах, розділяє таблиці порожнім рядком, зберігає всі коментарі та повідомляє про синтаксичні помилки з указанням рядка й стовпця, щоб розробники могли безпечно впорядкувати конфігурацію перед фіксацією змін.

## Поширені запитання

### Який механізм форматує 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%BD%D0%B0%20OneClick%20Pro)

[Реклама Набір плагінів для роботи з агентами для WordPress.](https://sleekwp.com/?ref=oneclickpro)