mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
2.7 KiB
2.7 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Bir kalıp şablonu kullanarak birden fazla dosyayı yeniden adlandırın ve ZIP olarak indirin. | 2776dcc2f71c | human | 7f08948bcee7 |
Toplu Yeniden Adlandırma
Dizin, dolgulu dizin ve özgün dosya adı için yer tutucular içeren bir kalıp şablonu kullanarak birden fazla dosyayı yeniden adlandırın. Yeniden adlandırılan tüm dosyaları içeren bir ZIP arşivi döndürür.
API Uç Noktası
POST /api/v1/tools/image/bulk-rename
Birden fazla dosya ve bir JSON settings alanı içeren multipart form verisi kabul eder.
Parametreler
| Parametre | Tür | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
| pattern | dize | Hayır | "image-{{index}}" |
Yer tutuculu adlandırma kalıbı (en fazla 1000 karakter) |
| startIndex | sayı | Hayır | 1 |
Başlangıç dizin numarası |
Kalıp Yer Tutucuları
| Yer Tutucu | Açıklama | Örnek |
|---|---|---|
{{index}} |
startIndex değerinden başlayan sıralı numara |
1, 2, 3 |
{{padded}} |
Sıfır dolgulu sıralı numara | 01, 02, 03 |
{{original}} |
Uzantısız özgün dosya adı | photo, IMG_001 |
Özgün dosya uzantısı her zaman korunur.
Örnek İstek
curl -X POST http://localhost:1349/api/v1/tools/image/bulk-rename \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@photo1.jpg" \
-F "file=@photo2.jpg" \
-F "file=@photo3.jpg" \
-F 'settings={"pattern": "vacation-{{padded}}", "startIndex": 1}'
Bu şunu üretir: vacation-1.jpg, vacation-2.jpg, vacation-3.jpg
Özgün dosya adını kullanma:
curl -X POST http://localhost:1349/api/v1/tools/image/bulk-rename \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@IMG_001.jpg" \
-F "file=@IMG_002.jpg" \
-F 'settings={"pattern": "2024-trip-{{original}}-{{index}}"}'
Bu şunu üretir: 2024-trip-IMG_001-1.jpg, 2024-trip-IMG_002-2.jpg
Örnek Yanıt
Yanıt, doğrudan akıtılan bir ZIP dosyasıdır (JSON yanıtı değil). Yanıt üst bilgileri şunlardır:
Content-Type: application/zip
Content-Disposition: attachment; filename="renamed-a1b2c3d4.zip"
Notlar
- Bu araç görselleri işlemez. Yalnızca dosyaları yeniden adlandırır ve bir ZIP arşivine paketler.
{{padded}}için sıfır dolgu genişliği, toplam dosya sayısına göre otomatik olarak belirlenir (ör. 100 dosya 3 haneli dolgu kullanır:001,002vb.).- Dosya uzantıları özgün dosya adlarından korunur.
- Dosya adları, güvensiz karakterleri kaldırmak için temizlenir.
- En az bir dosya sağlanmalıdır.