diff options
Diffstat (limited to 'packages/web/src/content/docs/ru/formatters.mdx')
| -rw-r--r-- | packages/web/src/content/docs/ru/formatters.mdx | 84 |
1 files changed, 36 insertions, 48 deletions
diff --git a/packages/web/src/content/docs/ru/formatters.mdx b/packages/web/src/content/docs/ru/formatters.mdx index 25232365a..771327aac 100644 --- a/packages/web/src/content/docs/ru/formatters.mdx +++ b/packages/web/src/content/docs/ru/formatters.mdx @@ -7,54 +7,42 @@ opencode автоматически форматирует файлы после --- -## Встроенный +## Built-in opencode поставляется с несколькими встроенными форматировщиками для популярных языков и платформ. Ниже приведен список форматтеров, поддерживаемых расширений файлов, а также необходимых команд или параметров конфигурации. -| форматтер | Расширения | Требования | -| ------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -| правительство | .идти | Доступна команда `gofmt` | -| смешивание | .ex, .exs, .bias, .heex, .bend, .neex, .sface | Доступна команда `mix` | -| красивее | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml и [подробнее](https://prettier.io/docs/en/index.html) | Зависимость `prettier` в `package.json` | -| биом | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml и [подробнее](https://biomejs.dev/) | Конфигурационный файл `biome.json(c)` | -| зигзаг | .zig, .zon | Доступна команда `zig` | -| clang-формат | .c, .cpp, .h, .hpp, .ino и [подробнее](https://clang.llvm.org/docs/ClangFormat.html) | Конфигурационный файл `.clang-format` | -| ктлинт | .кт, .ктс | Доступна команда `ktlint` | -| ерш | .py, .pyi | Команда `ruff` доступна в конфигурации | -| ржавчина | .rs | Доступна команда `rustfmt` | -| грузовой контейнер | .rs | Доступна команда `cargo fmt` | -| уф | .py, .pyi | Доступна команда `uv` | -| рубокоп | .rb, .rake, .gemspec, .ru | Доступна команда `rubocop` | -| стандартный RB | .rb, .rake, .gemspec, .ru | Доступна команда `standardrb` | -| htmlbeautifier | .erb, .html.erb | Доступна команда `htmlbeautifier` | -| воздух | .Р | Доступна команда `air` | -| дротик | .dart | Доступна команда `dart` | -| ocamlformat | .мл, .мли | Доступна команда `ocamlformat` и файл конфигурации `.ocamlformat`. | -| терраформировать | .tf, .tfvars | Доступна команда `terraform` | -| светиться | .блеск | Доступна команда `gleam` | -| никсфмт | .nix | Доступна команда `nixfmt` | -| шфмт | .sh, .bash | Доступна команда `shfmt` | -| пинта | .php | Зависимость `laravel/pint` в `composer.json` | -| oxfmt (экспериментальный) | .js, .jsx, .ts, .tsx | Зависимость `oxfmt` в `package.json` и [экспериментальная переменная окружения flag](/docs/cli/#experimental) | -| ормол | .hs | Доступна команда `ormolu` | +| Formatter | Расширения | Требования | +| -------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | +| gofmt | .go | Доступна команда `gofmt` | +| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Доступна команда `mix` | +| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml и [подробнее](https://prettier.io/docs/en/index.html) | Зависимость `prettier` в `package.json` | +| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml и [подробнее](https://biomejs.dev/) | Конфигурационный файл `biome.json(c)` | +| zig | .zig, .zon | Доступна команда `zig` | +| clang-format | .c, .cpp, .h, .hpp, .ino и [подробнее](https://clang.llvm.org/docs/ClangFormat.html) | Конфигурационный файл `.clang-format` | +| ktlint | .kt, .kts | Доступна команда `ktlint` | +| ruff | .py, .pyi | Команда `ruff` доступна в конфигурации | +| rustfmt | .rs | Доступна команда `rustfmt` | +| cargofmt | .rs | Доступна команда `cargo fmt` | +| uv | .py, .pyi | Доступна команда `uv` | +| rubocop | .rb, .rake, .gemspec, .ru | Доступна команда `rubocop` | +| standardrb | .rb, .rake, .gemspec, .ru | Доступна команда `standardrb` | +| htmlbeautifier | .erb, .html.erb | Доступна команда `htmlbeautifier` | +| air | .R | Доступна команда `air` | +| dart | .dart | Доступна команда `dart` | +| ocamlformat | .ml, .mli | Доступна команда `ocamlformat` и файл конфигурации `.ocamlformat`. | +| terraform | .tf, .tfvars | Доступна команда `terraform` | +| gleam | .gleam | Доступна команда `gleam` | +| nixfmt | .nix | Доступна команда `nixfmt` | +| shfmt | .sh, .bash | Доступна команда `shfmt` | +| pint | .php | Зависимость `laravel/pint` в `composer.json` | +| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | Зависимость `oxfmt` в `package.json` и [экспериментальная переменная окружения flag](/docs/cli/#experimental) | +| ormolu | .hs | Доступна команда `ormolu` | Поэтому, если ваш проект имеет `prettier` в вашем `package.json`, opencode автоматически его использует. --- -## Как это работает - -Когда opencode записывает или редактирует файл, он: - -1. Проверяет расширение файла по всем включенным средствам форматирования. -2. Запускает соответствующую команду форматирования файла. -3. Автоматически применяет изменения форматирования. - -Этот процесс происходит в фоновом режиме, обеспечивая сохранение стилей кода без каких-либо действий вручную. - ---- - -## Настроить +## Configure Вы можете настроить форматтеры через раздел `formatter` в конфигурации opencode. @@ -67,18 +55,18 @@ opencode поставляется с несколькими встроенным Каждая конфигурация форматтера поддерживает следующее: -| Свойство | Тип | Описание | -| ------------- | ------------------- | ----------------------------------------------------------------------------------- | -| `disabled` | логическое значение | Установите для этого параметра значение `true`, чтобы отключить форматтер. | -| `command` | нить[] | Команда для форматирования | -| `environment` | объект | Переменные среды, которые необходимо установить при запуске средства форматирования | -| `extensions` | нить[] | Расширения файлов, которые должен обрабатывать этот форматтер | +| Свойство | Тип | Описание | +| ------------- | -------- | ----------------------------------------------------------------------------------- | +| `disabled` | boolean | Установите для этого параметра значение `true`, чтобы отключить форматтер. | +| `command` | string[] | Команда для форматирования | +| `environment` | объект | Переменные среды, которые необходимо установить при запуске средства форматирования | +| `extensions` | string[] | Расширения файлов, которые должен обрабатывать этот форматтер | Давайте посмотрим на несколько примеров. --- -### Отключение форматтеров +### Disabling Formatters Чтобы глобально отключить **все** средства форматирования, установите для `formatter` значение `false`: @@ -104,7 +92,7 @@ opencode поставляется с несколькими встроенным --- -### Пользовательские форматтеры +### Custom Formatters Вы можете переопределить встроенные средства форматирования или добавить новые, указав команду, переменные среды и расширения файлов: |