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.
This commit is contained in:
SnapOtter
2026-07-11 13:52:47 +08:00
committed by GitHub
parent 00b651c9f8
commit 4963ab3bbd
3620 changed files with 306134 additions and 0 deletions
@@ -0,0 +1,74 @@
---
description: "형식 변환, 품질 제어, 크기 조정, 메타데이터 제거로 웹 전송에 맞게 이미지를 최적화합니다."
i18n_source_hash: c327bbbce768
i18n_provenance: human
i18n_output_hash: f6cc8e883fb7
---
# Optimize for Web {#optimize-for-web}
단일 단계로 웹 전송에 맞게 이미지를 최적화합니다. 형식 변환, 품질 조정, 선택적 크기 조정, 프로그레시브 인코딩, 메타데이터 제거를 결합합니다.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/image/optimize-for-web`
이미지 파일과 JSON `settings` 필드가 포함된 multipart form data를 허용합니다.
실시간 매개변수 조정을 위해 처리된 이미지를 바이너리로 직접 반환하는(작업 공간 생성 없음) 라이브 미리 보기 엔드포인트도 `POST /api/v1/tools/image/optimize-for-web/preview`에서 사용할 수 있습니다.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| format | string | No | `"webp"` | 출력 형식: `webp`, `jpeg`, `avif`, `png`, `jxl` |
| quality | number | No | `80` | 출력 품질(1~100) |
| maxWidth | number | No | - | 최대 너비(픽셀). 이미지가 더 넓으면 축소됩니다. |
| maxHeight | number | No | - | 최대 높이(픽셀). 이미지가 더 크면 축소됩니다. |
| progressive | boolean | No | `true` | 프로그레시브/인터레이스 인코딩 활성화 |
| stripMetadata | boolean | No | `true` | EXIF, GPS, ICC, XMP 메타데이터 제거 |
## Example Request {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/image/optimize-for-web \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@photo.jpg" \
-F 'settings={"format": "webp", "quality": 75, "maxWidth": 1920}'
```
적극적인 압축으로 AVIF 최적화:
```bash
curl -X POST http://localhost:1349/api/v1/tools/image/optimize-for-web \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@photo.jpg" \
-F 'settings={"format": "avif", "quality": 50, "maxWidth": 1200, "maxHeight": 800}'
```
## Example Response {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
"originalSize": 4500000,
"processedSize": 320000
}
```
### Preview Endpoint Response {#preview-endpoint-response}
미리 보기 엔드포인트(`/api/v1/tools/image/optimize-for-web/preview`)는 정보 헤더와 함께 바이너리 이미지를 직접 반환합니다:
- `X-Original-Size` - 원본 파일 크기(바이트)
- `X-Processed-Size` - 처리된 파일 크기(바이트)
- `X-Output-Filename` - URL 인코딩된 출력 파일 이름
## Notes {#notes}
- 이 도구는 웹 자산을 위한 원스톱 최적화 파이프라인으로 설계되었습니다. 형식 변환, 품질 조정, 최대 치수 제한, 메타데이터 제거를 단일 패스로 처리합니다.
- 출력 파일 이름 확장자는 선택한 형식과 일치하도록 업데이트됩니다.
- JXL(JPEG XL) 인코딩은 전용 CLI 인코더를 사용합니다. 이미지는 먼저 PNG로 처리된 다음 JXL로 인코딩됩니다.
- 프로그레시브 인코딩은 브라우저가 전체 이미지를 로드하기 전에 저품질 미리 보기를 렌더링할 수 있게 하여 JPEG와 PNG의 체감 로드 시간을 개선합니다.
- 미리 보기 엔드포인트는 더 가볍고(작업 공간/작업 생성 없음) 프런트엔드의 라이브 매개변수 조정 UI를 위한 것입니다.