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

2026-11-12 01:33:36 +01:00 · 2026-10-25 12:55:21 +05:30
1 parent 5e019de5ae
commit 4edb1718cc
@@ -0,0 +1,154 @@
+# Desplega a Cloudflare Pages
+
+[Cloudflare Pages](https://pages.cloudflare.com) ofereix allotjament estàtic ràpid i global amb amplada de banda il·limitada.
+
+## Desplegament ràpid
+
+1. Ves a [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)
+2. Fes clic a "Create a project"
+3. Connecta el teu repositori de GitHub
+
+## Configuració de la compilació
+
+| Paràmetre              | Valor           |
+| ---------------------- | --------------- |
+| Framework preset       | None            |
+| Build command          | `npm run build` |
+| Build output directory | `dist`          |
+| Root directory         | `/`             |
+
+## Variables d'entorn
+
+Afegeix-les a Settings → Environment variables:
+
+| Variable                | Valor                                                       |
+| ----------------------- | ----------------------------------------------------------- |
+| `NODE_VERSION`          | `18`                                                        |
+| `SIMPLE_MODE`           | `false` (opcional)                                          |
+| `VITE_BRAND_NAME`       | Nom de marca personalitzat (opcional)                       |
+| `VITE_BRAND_LOGO`       | Ruta del logotip relativa a `public/` (opcional)            |
+| `VITE_FOOTER_TEXT`      | Text personalitzat del peu de pàgina/copyright (opcional)   |
+| `VITE_DEFAULT_LANGUAGE` | Idioma per defecte de la interfície, p. ex. `fr` (opcional) |
+
+## Fitxer de configuració
+
+Crea `_headers` a la carpeta `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 Important
+Les capçaleres `Cross-Origin-Embedder-Policy` i `Cross-Origin-Opener-Policy` són obligatòries per a les conversions de Word/ODT/Excel/PowerPoint a PDF. Sense elles, `SharedArrayBuffer` no està disponible i el motor LibreOffice WASM no s'inicialitzarà.
+:::
+
+Crea `_redirects` per a l'encaminament SPA:
+
+```
+/*    /index.html   200
+```
+
+## Domini personalitzat
+
+1. Ves al teu projecte de Pages
+2. Fes clic a "Custom domains"
+3. Afegeix el teu domini
+4. Cloudflare configurarà el DNS automàticament si el domini és a Cloudflare
+
+## Avantatges
+
+- **Amplada de banda il·limitada i gratuïta**
+- **CDN global** amb més de 300 ubicacions de xarxa
+- **HTTPS automàtic**
+- **Desplegaments de previsualització** per a les pull requests
+- **Compilacions ràpides**
+
+## Resolució de problemes
+
+### Càrrega de fitxers grans
+
+Cloudflare Pages admet fitxers de fins a 25 MB. Els mòduls WASM haurien d'anar bé, però si arribes als límits, considera:
+
+```bash
+# Split large files during build
+npm run build
+```
+
+### Límits de mida dels Workers
+
+Si utilitzes Cloudflare Workers per a un encaminament avançat, tingues en compte el límit d'1 MB dels plans gratuïts.
+
+## Worker de proxy CORS (per a signatures digitals)
+
+L'eina de signatura digital requereix un proxy CORS per obtenir les cadenes de certificats. Desplega el worker inclòs:
+
+```bash
+cd cloudflare
+npx wrangler login
+npx wrangler deploy
+```
+
+### Funcions de seguretat
+
+| Funció                     | Descripció                           |
+| -------------------------- | ------------------------------------ |
+| **Restriccions d'URL**     | Només es permeten URL de certificats |
+| **Límit de mida**          | Màx. 10MB per petició                |
+| **Límit de freqüència**    | 60 peticions/IP/min (requereix KV)   |
+| **Bloqueig d'IP privades** | Bloqueja localhost i IP internes     |
+
+### Activa el límit de freqüència
+
+```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
+```
+
+### Compila amb la URL del proxy
+
+```bash
+VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
+```
+
+O amb 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 .
+```
+
+> **Nota:** Consulta el [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required) per a la configuració de la signatura HMAC.