feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-08-03 07:46:42 +02:00 · 2026-07-11 13:52:47 +08:00
parent 00b651c9f8
commit 4963ab3bbd
3620 changed files with 306134 additions and 0 deletions
@@ -0,0 +1,147 @@
+---
+description: "Zmieniaj rozmiar, optymalizuj, zmieniaj prędkość, odwracaj, obracaj i wyodrębniaj klatki z animowanych plików GIF w jednym narzędziu."
+i18n_source_hash: 5e525e80db92
+i18n_provenance: human
+i18n_output_hash: 90168d0b887b
+---
+
+# Narzędzia GIF {#gif-tools}
+
+Zmieniaj rozmiar, optymalizuj, zmieniaj prędkość, odwracaj, wyodrębniaj klatki i obracaj animowane pliki GIF. Zapewnia wiele trybów działania w jednym narzędziu.
+
+## Punkt końcowy API {#api-endpoint}
+
+`POST /api/v1/tools/image/gif-tools`
+
+## Parametry {#parameters}
+
+### Wspólne parametry {#common-parameters}
+
+| Parametr | Typ | Wymagany | Domyślnie | Opis |
+|-----------|------|----------|---------|-------------|
+| mode | string | Nie | `"resize"` | Tryb działania: `resize`, `optimize`, `speed`, `reverse`, `extract`, `rotate` |
+| loop | number | Nie | 0 | Liczba powtórzeń wyjściowego pliku GIF (0 = nieskończenie, 1-100 = skończona liczba pętli) |
+
+### Parametry trybu zmiany rozmiaru {#resize-mode-parameters}
+
+| Parametr | Typ | Wymagany | Domyślnie | Opis |
+|-----------|------|----------|---------|-------------|
+| width | integer | Nie | - | Docelowa szerokość w pikselach (1 do 16384) |
+| height | integer | Nie | - | Docelowa wysokość w pikselach (1 do 16384) |
+| percentage | number | Nie | - | Skalowanie procentowe (1 do 500). Nadpisuje width/height, jeśli ustawione. |
+
+### Parametry trybu optymalizacji {#optimize-mode-parameters}
+
+| Parametr | Typ | Wymagany | Domyślnie | Opis |
+|-----------|------|----------|---------|-------------|
+| colors | number | Nie | 256 | Maksymalna liczba kolorów w palecie (2 do 256) |
+| dither | number | Nie | 1.0 | Siła ditheringu (0 do 1, gdzie 0 wyłącza dithering) |
+| effort | number | Nie | 7 | Poziom wysiłku optymalizacji (1 do 10, wyższy = wolniej, ale mniejszy) |
+
+### Parametry trybu prędkości {#speed-mode-parameters}
+
+| Parametr | Typ | Wymagany | Domyślnie | Opis |
+|-----------|------|----------|---------|-------------|
+| speedFactor | number | Nie | 1.0 | Mnożnik prędkości (0.1 do 10). Wartości > 1 przyspieszają, < 1 spowalniają. |
+
+### Parametry trybu wyodrębniania {#extract-mode-parameters}
+
+| Parametr | Typ | Wymagany | Domyślnie | Opis |
+|-----------|------|----------|---------|-------------|
+| extractMode | string | Nie | `"single"` | Tryb wyodrębniania: `single`, `range`, `all` |
+| frameNumber | number | Nie | 0 | Indeks klatki do wyodrębnienia w trybie `single` (od 0) |
+| frameStart | number | Nie | 0 | Indeks klatki początkowej dla trybu `range` (od 0) |
+| frameEnd | number | Nie | - | Indeks klatki końcowej dla trybu `range` (od 0, włącznie) |
+| extractFormat | string | Nie | `"png"` | Format wyodrębnionych klatek: `png`, `webp` |
+
+### Parametry trybu obracania {#rotate-mode-parameters}
+
+| Parametr | Typ | Wymagany | Domyślnie | Opis |
+|-----------|------|----------|---------|-------------|
+| angle | number | Nie | - | Kąt obrotu: `90`, `180` lub `270` stopni |
+| flipH | boolean | Nie | `false` | Odbij w poziomie |
+| flipV | boolean | Nie | `false` | Odbij w pionie |
+
+## Przykładowe żądania {#example-requests}
+
+### Zmiana rozmiaru {#resize}
+
+```bash
+curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
+  -F "file=@animation.gif" \
+  -F 'settings={"mode":"resize","percentage":50}'
+```
+
+### Optymalizacja {#optimize}
+
+```bash
+curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
+  -F "file=@large.gif" \
+  -F 'settings={"mode":"optimize","colors":128,"effort":9}'
+```
+
+### Przyspieszenie {#speed-up}
+
+```bash
+curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
+  -F "file=@animation.gif" \
+  -F 'settings={"mode":"speed","speedFactor":2.0}'
+```
+
+### Wyodrębnienie pojedynczej klatki {#extract-single-frame}
+
+```bash
+curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
+  -F "file=@animation.gif" \
+  -F 'settings={"mode":"extract","extractMode":"single","frameNumber":5,"extractFormat":"png"}'
+```
+
+## Przykładowa odpowiedź {#example-response}
+
+```json
+{
+  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/animation.gif",
+  "originalSize": 2345678,
+  "processedSize": 1234567
+}
+```
+
+## Podtrasa Info {#info-sub-route}
+
+`POST /api/v1/tools/image/gif-tools/info`
+
+Zwraca metadane o animowanym pliku GIF bez jego przetwarzania.
+
+### Żądanie Info {#info-request}
+
+```bash
+curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools/info \
+  -F "file=@animation.gif"
+```
+
+### Odpowiedź Info {#info-response}
+
+```json
+{
+  "width": 480,
+  "height": 320,
+  "pages": 24,
+  "delay": [100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100],
+  "loop": 0,
+  "fileSize": 2345678,
+  "duration": 2400
+}
+```
+
+## Uwagi {#notes}
+
+- Wykorzystuje standardową fabrykę `createToolRoute` dla głównego punktu końcowego przetwarzania.
+- Punkt końcowy info wymaga jedynie przesłania pliku (nie są potrzebne żadne ustawienia).
+- W trybie `resize`, jeśli podano `percentage`, ma on priorytet nad `width`/`height`. Zmiana rozmiaru używa `fit: inside` w celu zachowania proporcji.
+- W trybie `speed` opóźnienia klatek są dzielone przez współczynnik prędkości. Minimalne opóźnienie na klatkę wynosi 20 ms (ograniczenie specyfikacji GIF).
+- W trybie `reverse` dostępny jest również parametr `speedFactor`, aby jednocześnie dostosować prędkość podczas odwracania.
+- W trybie `extract` z `range` lub `all` wynikiem jest plik ZIP zawierający poszczególne klatki.
+- W trybie `rotate` każda klatka jest przetwarzana indywidualnie i ponownie składana w animację.
+- Parametr `loop` kontroluje, ile razy wyjściowy plik GIF się zapętla. Użyj 0 dla nieskończonego zapętlania.
+- Pole `duration` w odpowiedzi info to całkowity czas trwania animacji w milisekundach.