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 @@
+# Implantação no Cloudflare Pages
+
+O [Cloudflare Pages](https://pages.cloudflare.com) oferece hospedagem estática rápida e global com largura de banda ilimitada.
+
+## Implantação Rápida
+
+1. Acesse o [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)
+2. Clique em "Create a project"
+3. Conecte seu repositório do GitHub
+
+## Configuração de Build
+
+| Configuração           | Valor           |
+| ---------------------- | --------------- |
+| Framework preset       | Nenhum          |
+| Build command          | `npm run build` |
+| Build output directory | `dist`          |
+| Root directory         | `/`             |
+
+## Variáveis de Ambiente
+
+Adicione estas em Settings → Environment variables:
+
+| Variável                | Valor                                               |
+| ----------------------- | --------------------------------------------------- |
+| `NODE_VERSION`          | `18`                                                |
+| `SIMPLE_MODE`           | `false` (opcional)                                  |
+| `VITE_BRAND_NAME`       | Nome de marca personalizado (opcional)              |
+| `VITE_BRAND_LOGO`       | Caminho do logotipo relativo a `public/` (opcional) |
+| `VITE_FOOTER_TEXT`      | Texto personalizado de rodapé/copyright (opcional)  |
+| `VITE_DEFAULT_LANGUAGE` | Idioma padrão da interface, p. ex. `fr` (opcional)  |
+
+## Arquivo de Configuração
+
+Crie `_headers` na sua pasta `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 Importante
+Os cabeçalhos `Cross-Origin-Embedder-Policy` e `Cross-Origin-Opener-Policy` são necessários para as conversões de Word/ODT/Excel/PowerPoint para PDF. Sem eles, o `SharedArrayBuffer` fica indisponível e o mecanismo LibreOffice WASM não consegue inicializar.
+:::
+
+Crie `_redirects` para o roteamento SPA:
+
+```
+/*    /index.html   200
+```
+
+## Domínio Personalizado
+
+1. Acesse seu projeto no Pages
+2. Clique em "Custom domains"
+3. Adicione seu domínio
+4. O Cloudflare configura o DNS automaticamente se o domínio estiver no Cloudflare
+
+## Vantagens
+
+- **Largura de banda ilimitada e gratuita**
+- **CDN global** com mais de 300 locais de borda
+- **HTTPS automático**
+- **Implantações de pré-visualização** para pull requests
+- **Builds rápidos**
+
+## Solução de Problemas
+
+### Upload de Arquivos Grandes
+
+O Cloudflare Pages aceita arquivos de até 25 MB. Os módulos WASM devem funcionar bem, mas se você atingir os limites, considere:
+
+```bash
+# Split large files during build
+npm run build
+```
+
+### Limites de Tamanho do Worker
+
+Se você usa o Cloudflare Workers para roteamento avançado, observe o limite de 1 MB nos planos gratuitos.
+
+## Worker de Proxy CORS (para Assinaturas Digitais)
+
+A ferramenta de Assinatura Digital exige um proxy CORS para buscar cadeias de certificados. Implante o worker incluído:
+
+```bash
+cd cloudflare
+npx wrangler login
+npx wrangler deploy
+```
+
+### Recursos de Segurança
+
+| Recurso                          | Descrição                              |
+| -------------------------------- | -------------------------------------- |
+| **Restrições de URL**            | Apenas URLs de certificados permitidas |
+| **Limite de Tamanho de Arquivo** | Máx. 10MB por requisição               |
+| **Limitação de Taxa**            | 60 req/IP/min (requer KV)              |
+| **Bloqueio de IP Privado**       | Bloqueia localhost e IPs internos      |
+
+### Ativar Limitação de Taxa
+
+```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
+```
+
+### Compile com a URL do Proxy
+
+```bash
+VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
+```
+
+Ou com 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 .
+```
+
+> **Observação:** Veja o [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required) para configurar a assinatura HMAC.