summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src/content/docs/pl/formatters.mdx
diff options
context:
space:
mode:
Diffstat (limited to 'packages/web/src/content/docs/pl/formatters.mdx')
-rw-r--r--packages/web/src/content/docs/pl/formatters.mdx130
1 files changed, 130 insertions, 0 deletions
diff --git a/packages/web/src/content/docs/pl/formatters.mdx b/packages/web/src/content/docs/pl/formatters.mdx
new file mode 100644
index 000000000..d2a0181fb
--- /dev/null
+++ b/packages/web/src/content/docs/pl/formatters.mdx
@@ -0,0 +1,130 @@
+---
+title: Formatery
+description: OpenCode używa formaterów specyficznych dla języka.
+---
+
+OpenCode automatycznie formatuje pliki po ich zapisaniu lub edycję przy użyciu formaterów przesyłanych dla języka. Dzięki temu wygenerowany kod będzie używany ze stylami kodu Twojego projektu.
+
+---
+
+## Wbudowany
+
+OpenCode zawiera kilka wbudowanych formaterów dla nauki języków i frameworków. Zawiera listę formaterów, rozszerzonych plików oraz rozszerzenia i konfiguratory, których potrzebujesz.
+
+| Formater | Rozszerzenia | Wymagania |
+| -------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| gofmt | .idź | Komenda `gofmt` dostępna |
+| ryzyko | .ex, .exs, .eex, .heex, .leex, .neex, .sface | Komenda `mix` dostępna |
+| ładniejsza | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://prettier.io/docs/en/index.html) | Zależność `prettier` w `package.json` |
+| biom | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml i [więcej](https://biomejs.dev/) | `biome.json(c)` plik konfiguracyjny |
+| zyg | .zig, .zon | Komenda `zig` dostępna |
+| formatuj brzęk | .c, .cpp, .h, .hpp, .ino i [więcej](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` plik konfiguracyjny |
+| ktlint | .kt, .kts | Komenda `ktlint` dostępna |
+| kryza | .py, .pyi | Komenda `ruff` dostępna w konstrukcji |
+| rustfmt | .rs | Komenda `rustfmt` dostępna |
+| załadunek | .rs | Komenda `cargo fmt` dostępna |
+| UV | .py, .pyi | Komenda `uv` dostępna |
+| rubocop | .rb, .rake, .gemspec, .ru | Komenda `rubocop` dostępna |
+| standardowe | .rb, .rake, .gemspec, .ru | Komenda `standardrb` dostępna |
+| htmlupiększacz | .erb, .html.erb | Komenda `htmlbeautifier` dostępna |
+| powietrze | .R | Komenda `air` dostępna |
+| strzałka | .dart | Komenda `dart` dostępna |
+| formatuj ocaml | .ml, .mli | Dostępna opcja `ocamlformat` i plik konfiguracyjny `.ocamlformat` |
+| terraforma | .tf, .tfvars | Komenda `terraform` dostępna |
+| blask | .blask | Komenda `gleam` dostępna |
+| nixfmt | .nix | Komenda `nixfmt` dostępna |
+| shfmt | .sh, .bash | Komenda `shfmt` dostępna |
+| kufel | .php | Zależność `laravel/pint` w `composer.json` |
+| oxfmt (eksperymentalny) | .js, .jsx, .ts, .tsx | wykonanie `oxfmt` w `package.json` i [flaga eksperymentalna zmienna env](/docs/cli/#experimental) |
+| ormolu | .hs | Komenda `ormolu` dostępna |
+
+Jeśli więc Twój projekt zawiera `prettier` w `package.json`, OpenCode automatycznie przejdź do podmiote.
+
+---
+
+## Jak to działa
+
+Kiedy OpenCode zapisuje lub edytuje plik:
+
+1. Badanie pliku dotyczącego wszystkich danych formaterów.
+2. Uruchamia decyzje wykonawcze formatujące na plik.
+3. Automatycznie stosuje zmiany formatowania.
+
+Dziesięć procesów zachodzi w tle, konieczne jest zachowanie stylów kodu bez konieczności wykonania czynności czynnościowych.
+
+---
+
+## Skonfiguruj
+
+Można dostosować formatery za pomocą sekcji `formatter` w konstrukcji OpenCode.
+
+```json title="opencode.json"
+{
+ "$schema": "https://opencode.ai/config.json",
+ "formatter": {}
+}
+```
+
+obsługiwane formatyzator Zobacz elementy:
+
+| Nieruchomość | Wpisz | Opis |
+| ------------- | -------- | ------------------------------------------------------- |
+| `disabled` | wartość logiczna | Ustaw tę opcję na `true`, aby wyłączyć formater |
+| `command` | ciąg[] | Polecenie uruchomienia formatowania |
+| `environment` | obiekt | Zmienne ustawienia do ustawień podczas uruchamiania programu formatującego |
+| `extensions` | ciąg[] | Rozszerzenia plików, które powinny opuścić ten formater |
+
+Spójrzmy na kilka przykładów.
+
+---
+
+### Wyłączanie formaterów
+
+Aby globalnie wyłączyć **wszystkie** formatery, ustaw `formatter` na `false`:
+
+```json title="opencode.json" {3}
+{
+ "$schema": "https://opencode.ai/config.json",
+ "formatter": false
+}
+```
+
+Aby wyłączyć **określony** formater, ustaw `disabled` na `true`:
+
+```json title="opencode.json" {5}
+{
+ "$schema": "https://opencode.ai/config.json",
+ "formatter": {
+ "prettier": {
+ "disabled": true
+ }
+ }
+}
+```
+
+---
+
+### Niestandardowe formatery
+
+Może wystąpić, gdyby nastąpiło nowe, uruchomienie, zmienne udostępnienie i udostępnienie plików:
+
+```json title="opencode.json" {4-14}
+{
+ "$schema": "https://opencode.ai/config.json",
+ "formatter": {
+ "prettier": {
+ "command": ["npx", "prettier", "--write", "$FILE"],
+ "environment": {
+ "NODE_ENV": "development"
+ },
+ "extensions": [".js", ".ts", ".jsx", ".tsx"]
+ },
+ "custom-markdown-formatter": {
+ "command": ["deno", "fmt", "$FILE"],
+ "extensions": [".md"]
+ }
+ }
+}
+```
+
+Symbol zastępczy **`$FILE`** w poleceniu pochodziony z formatowanego pliku.