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
+
+[Cloudflare Pages](https://pages.cloudflare.com) пропонує швидкий глобальний хостинг статичних сайтів з необмеженим трафіком.
+
+## Швидке розгортання
+
+1. Перейдіть до [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)
+2. Натисніть "Create a project"
+3. Підключіть свій репозиторій GitHub
+
+## Конфігурація збірки
+
+| Параметр               | Значення        |
+| ---------------------- | --------------- |
+| Framework preset       | None            |
+| Build command          | `npm run build` |
+| Build output directory | `dist`          |
+| Root directory         | `/`             |
+
+## Змінні середовища
+
+Додайте їх у Settings → Environment variables:
+
+| Змінна                  | Значення                                             |
+| ----------------------- | ---------------------------------------------------- |
+| `NODE_VERSION`          | `18`                                                 |
+| `SIMPLE_MODE`           | `false` (необов'язково)                              |
+| `VITE_BRAND_NAME`       | Власна назва бренду (необов'язково)                  |
+| `VITE_BRAND_LOGO`       | Шлях до логотипа відносно `public/` (необов'язково)  |
+| `VITE_FOOTER_TEXT`      | Власний текст футера/авторських прав (необов'язково) |
+| `VITE_DEFAULT_LANGUAGE` | Типова мова інтерфейсу, напр. `fr` (необов'язково)   |
+
+## Файл конфігурації
+
+Створіть `_headers` у папці `public`:
+
+```
+# 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 Важливо
+Заголовки `Cross-Origin-Embedder-Policy` і `Cross-Origin-Opener-Policy` обов'язкові для конвертації Word/ODT/Excel/PowerPoint у PDF. Без них `SharedArrayBuffer` недоступний, і рушій LibreOffice WASM не зможе ініціалізуватися.
+:::
+
+Створіть `_redirects` для маршрутизації SPA:
+
+```
+/*    /index.html   200
+```
+
+## Власний домен
+
+1. Перейдіть до свого проєкту Pages
+2. Натисніть "Custom domains"
+3. Додайте свій домен
+4. Cloudflare автоматично налаштує DNS, якщо домен розміщено на Cloudflare
+
+## Переваги
+
+- **Безкоштовний необмежений трафік**
+- **Глобальна CDN** з понад 300 вузлами
+- **Автоматичний HTTPS**
+- **Попередні розгортання** для pull request
+- **Швидкі збірки**
+
+## Усунення несправностей
+
+### Завантаження великих файлів
+
+Cloudflare Pages підтримує файли до 25 MB. Модулі WASM мають вміститися, але якщо ви впираєтеся в ліміти, розгляньте:
+
+```bash
+# Split large files during build
+npm run build
+```
+
+### Ліміти розміру Worker
+
+Якщо ви використовуєте Cloudflare Workers для складної маршрутизації, зверніть увагу на ліміт 1 MB для безкоштовних планів.
+
+## Worker CORS-проксі (для цифрових підписів)
+
+Інструмент цифрового підпису потребує CORS-проксі для отримання ланцюжків сертифікатів. Розгорніть вбудований worker:
+
+```bash
+cd cloudflare
+npx wrangler login
+npx wrangler deploy
+```
+
+### Функції безпеки
+
+| Функція                     | Опис                            |
+| --------------------------- | ------------------------------- |
+| **Обмеження URL**           | Дозволено лише URL сертифікатів |
+| **Ліміт розміру файлу**     | Макс. 10MB на запит             |
+| **Обмеження частоти**       | 60 запитів/IP/хв (потрібен KV)  |
+| **Блокування приватних IP** | Блокує localhost і внутрішні IP |
+
+### Увімкнення обмеження частоти
+
+```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
+```
+
+### Збірка з URL проксі
+
+```bash
+VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
+```
+
+Або з Docker:
+
+```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 .
+```
+
+> **Примітка:** Налаштування підпису HMAC дивіться в [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required).