feat: translate all pages, UI messages and docs and fix SEO redirects and indexing

2026-11-13 17:54:19 +01:00 · 2026-10-25 12:55:21 +05:30
1 parent 5e019de5ae
commit 4edb1718cc
@@ -0,0 +1,154 @@
+# Cloudflare Pages'e Dağıtım
+
+[Cloudflare Pages](https://pages.cloudflare.com), sınırsız bant genişliğiyle hızlı, küresel statik site barındırma sunar.
+
+## Hızlı Dağıtım
+
+1. [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages) sayfasına gidin
+2. "Create a project" düğmesine tıklayın
+3. GitHub deponuzu bağlayın
+
+## Derleme Yapılandırması
+
+| Ayar                   | Değer           |
+| ---------------------- | --------------- |
+| Framework preset       | None            |
+| Build command          | `npm run build` |
+| Build output directory | `dist`          |
+| Root directory         | `/`             |
+
+## Ortam Değişkenleri
+
+Bunları Settings → Environment variables bölümüne ekleyin:
+
+| Değişken                | Değer                                             |
+| ----------------------- | ------------------------------------------------- |
+| `NODE_VERSION`          | `18`                                              |
+| `SIMPLE_MODE`           | `false` (isteğe bağlı)                            |
+| `VITE_BRAND_NAME`       | Özel marka adı (isteğe bağlı)                     |
+| `VITE_BRAND_LOGO`       | `public/` klasörüne göre logo yolu (isteğe bağlı) |
+| `VITE_FOOTER_TEXT`      | Özel alt bilgi/telif hakkı metni (isteğe bağlı)   |
+| `VITE_DEFAULT_LANGUAGE` | Varsayılan arayüz dili, örn. `fr` (isteğe bağlı)  |
+
+## Yapılandırma Dosyası
+
+`public` klasörünüzde `_headers` dosyasını oluşturun:
+
+```
+# Required security headers for SharedArrayBuffer (used by LibreOffice WASM)
+/*
+  Cross-Origin-Embedder-Policy: require-corp
+  Cross-Origin-Opener-Policy: same-origin
+  Cross-Origin-Resource-Policy: cross-origin
+
+# Pre-compressed LibreOffice WASM binary
+/libreoffice-wasm/soffice.wasm.gz
+  Content-Type: application/wasm
+  Content-Encoding: gzip
+  Cache-Control: public, max-age=31536000, immutable
+
+# Pre-compressed LibreOffice WASM data
+/libreoffice-wasm/soffice.data.gz
+  Content-Type: application/octet-stream
+  Content-Encoding: gzip
+  Cache-Control: public, max-age=31536000, immutable
+
+# Cache WASM files aggressively
+/*.wasm
+  Cache-Control: public, max-age=31536000, immutable
+  Content-Type: application/wasm
+
+# Service worker
+/sw.js
+  Cache-Control: no-cache
+```
+
+::: warning Önemli
+`Cross-Origin-Embedder-Policy` ve `Cross-Origin-Opener-Policy` başlıkları Word/ODT/Excel/PowerPoint'ten PDF'e dönüştürmeler için gereklidir. Bunlar olmadan `SharedArrayBuffer` kullanılamaz ve LibreOffice WASM motoru başlatılamaz.
+:::
+
+SPA yönlendirmesi için `_redirects` dosyasını oluşturun:
+
+```
+/*    /index.html   200
+```
+
+## Özel Alan Adı
+
+1. Pages projenize gidin
+2. "Custom domains" düğmesine tıklayın
+3. Alan adınızı ekleyin
+4. Alan adı Cloudflare'deyse Cloudflare DNS'i otomatik yapılandırır
+
+## Avantajlar
+
+- **Ücretsiz sınırsız bant genişliği**
+- 300'den fazla uç noktası olan **küresel CDN**
+- **Otomatik HTTPS**
+- Pull request'ler için **önizleme dağıtımları**
+- **Hızlı derlemeler**
+
+## Sorun Giderme
+
+### Büyük Dosya Yüklemeleri
+
+Cloudflare Pages 25 MB'a kadar dosyaları destekler. WASM modüllerinde sorun olmaması gerekir, ancak sınırlara takılırsanız şunu düşünün:
+
+```bash
+# Split large files during build
+npm run build
+```
+
+### Worker Boyut Sınırları
+
+Gelişmiş yönlendirme için Cloudflare Workers kullanıyorsanız, ücretsiz planlardaki 1 MB sınırını göz önünde bulundurun.
+
+## CORS Proxy Worker (Dijital İmzalar için)
+
+Dijital İmza aracı, sertifika zincirlerini almak için bir CORS proxy gerektirir. Pakete dahil worker'ı dağıtın:
+
+```bash
+cd cloudflare
+npx wrangler login
+npx wrangler deploy
+```
+
+### Güvenlik Özellikleri
+
+| Özellik                 | Açıklama                                   |
+| ----------------------- | ------------------------------------------ |
+| **URL Kısıtlamaları**   | Yalnızca sertifika URL'lerine izin verilir |
+| **Dosya Boyutu Sınırı** | İstek başına en fazla 10MB                 |
+| **Hız Sınırlama**       | 60 istek/IP/dk (KV gerekir)                |
+| **Özel IP Engelleme**   | localhost ve dahili IP'leri engeller       |
+
+### Hız Sınırlamayı Etkinleştirme
+
+```bash
+# Create KV namespace
+npx wrangler kv namespace create "RATE_LIMIT_KV"
+
+# Add to wrangler.toml with returned ID:
+# [[kv_namespaces]]
+# binding = "RATE_LIMIT_KV"
+# id = "YOUR_ID"
+
+npx wrangler deploy
+```
+
+### Proxy URL ile Derleme
+
+```bash
+VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
+```
+
+Veya Docker ile:
+
+```bash
+export VITE_CORS_PROXY_URL="https://your-worker.workers.dev"
+DOCKER_BUILDKIT=1 docker build \
+  --secret id=VITE_CORS_PROXY_URL,env=VITE_CORS_PROXY_URL \
+  -t your-bentopdf .
+```
+
+> **Not:** HMAC imza kurulumu için [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required) dosyasına bakın.