mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
123 lines
3.8 KiB
Markdown
123 lines
3.8 KiB
Markdown
# Deploy su Vercel
|
|
|
|
[Vercel](https://vercel.com) offre l'esperienza di deploy più semplice per i siti statici.
|
|
|
|
## Deploy con un clic
|
|
|
|
[](https://vercel.com/new/clone?repository-url=https://github.com/alam00000/bentopdf)
|
|
|
|
## Deploy manuale
|
|
|
|
### Passaggio 1: fai il fork del repository
|
|
|
|
Fai il fork di [bentopdf/bentopdf](https://github.com/alam00000/bentopdf) sul tuo account GitHub.
|
|
|
|
### Passaggio 2: importa su Vercel
|
|
|
|
1. Vai su [vercel.com/new](https://vercel.com/new)
|
|
2. Seleziona il tuo repository forkato
|
|
3. Configura il progetto:
|
|
|
|
| Impostazione | Valore |
|
|
| ---------------- | --------------- |
|
|
| Framework Preset | Vite |
|
|
| Build Command | `npm run build` |
|
|
| Output Directory | `dist` |
|
|
| Install Command | `npm install` |
|
|
|
|
### Passaggio 3: variabili d'ambiente (facoltativo)
|
|
|
|
Aggiungile se necessario:
|
|
|
|
| Variabile | Descrizione |
|
|
| ----------------------- | -------------------------------------------------------------------- |
|
|
| `SIMPLE_MODE` | Imposta su `true` per un'interfaccia minimale |
|
|
| `VITE_BRAND_NAME` | Nome del brand personalizzato (sostituisce "BentoPDF") |
|
|
| `VITE_BRAND_LOGO` | Percorso del logo relativo a `public/` (ad es. `images/my-logo.svg`) |
|
|
| `VITE_FOOTER_TEXT` | Testo personalizzato del footer/copyright |
|
|
| `VITE_DEFAULT_LANGUAGE` | Lingua predefinita dell'interfaccia (ad es. `fr`, `de`, `es`) |
|
|
|
|
### Passaggio 4: esegui il deploy
|
|
|
|
Fai clic su "Deploy" e attendi il completamento della build.
|
|
|
|
## Dominio personalizzato
|
|
|
|
1. Vai alle impostazioni del progetto
|
|
2. Apri "Domains"
|
|
3. Aggiungi il tuo dominio personalizzato
|
|
4. Configura il DNS come indicato
|
|
|
|
## Limitazioni
|
|
|
|
::: warning File di grandi dimensioni
|
|
Le funzioni serverless di Vercel hanno un limite di 50MB. Poiché BentoPDF è un sito statico, questo non dovrebbe riguardarti, ma i moduli WASM sono grandi (~100MB in totale). Assicurati che vengano serviti dalla cartella `/public`.
|
|
:::
|
|
|
|
## Risoluzione dei problemi
|
|
|
|
### Timeout della build
|
|
|
|
Se le build vanno in timeout, prova:
|
|
|
|
```json
|
|
// vercel.json
|
|
{
|
|
"buildCommand": "npm run build",
|
|
"outputDirectory": "dist"
|
|
}
|
|
```
|
|
|
|
### 404 al ricaricamento
|
|
|
|
Aggiungi un `vercel.json` per il routing SPA:
|
|
|
|
```json
|
|
{
|
|
"rewrites": [{ "source": "/(.*)", "destination": "/index.html" }]
|
|
}
|
|
```
|
|
|
|
### Conversione da Word/ODT/Excel a PDF non funzionante
|
|
|
|
Le conversioni WASM di LibreOffice richiedono `SharedArrayBuffer`, che necessita di questi header di risposta su tutte le pagine:
|
|
|
|
- `Cross-Origin-Embedder-Policy: require-corp`
|
|
- `Cross-Origin-Opener-Policy: same-origin`
|
|
|
|
Anche i file precompressi `.wasm.gz` e `.data.gz` richiedono `Content-Encoding: gzip`, così il browser li decomprime.
|
|
|
|
Aggiungili al tuo `vercel.json`:
|
|
|
|
```json
|
|
{
|
|
"rewrites": [{ "source": "/(.*)", "destination": "/index.html" }],
|
|
"headers": [
|
|
{
|
|
"source": "/(.*)",
|
|
"headers": [
|
|
{ "key": "Cross-Origin-Embedder-Policy", "value": "require-corp" },
|
|
{ "key": "Cross-Origin-Opener-Policy", "value": "same-origin" },
|
|
{ "key": "Cross-Origin-Resource-Policy", "value": "cross-origin" }
|
|
]
|
|
},
|
|
{
|
|
"source": "/libreoffice-wasm/soffice.wasm.gz",
|
|
"headers": [
|
|
{ "key": "Content-Type", "value": "application/wasm" },
|
|
{ "key": "Content-Encoding", "value": "gzip" }
|
|
]
|
|
},
|
|
{
|
|
"source": "/libreoffice-wasm/soffice.data.gz",
|
|
"headers": [
|
|
{ "key": "Content-Type", "value": "application/octet-stream" },
|
|
{ "key": "Content-Encoding", "value": "gzip" }
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
Per verificare, apri la Console di DevTools ed esegui `console.log(window.crossOriginIsolated)`: dovrebbe restituire `true`.
|