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

2026-11-13 09: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            |
+| Каманда зборкі        | `npm run build` |
+| Каталог вываду зборкі | `dist`          |
+| Каранёвы каталог      | `/`             |
+
+## Зменныя асяроддзя
+
+Дадайце іх у 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 на бясплатных планах.
+
+## CORS-проксі Worker (для лічбавых подпісаў)
+
+Інструменту лічбавага подпісу патрэбны 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).