Desplega a Vercel

Vercel ofereix l'experiència de desplegament més senzilla per a llocs estàtics.

Desplegament amb un clic

Desplegament manual

Pas 1: fes un fork del repositori

Fes un fork de bentopdf/bentopdf al teu compte de GitHub.

Pas 2: importa'l a Vercel

Ves a vercel.com/new
Selecciona el repositori del teu fork
Configura el projecte:

Paràmetre	Valor
Framework Preset	Vite
Build Command	`npm run build`
Output Directory	`dist`
Install Command	`npm install`

Pas 3: variables d'entorn (opcional)

Afegeix-les si cal:

Variable	Descripció
`SIMPLE_MODE`	Posa-ho a `true` per a una interfície mínima
`VITE_BRAND_NAME`	Nom de marca personalitzat (substitueix "BentoPDF")
`VITE_BRAND_LOGO`	Ruta del logotip relativa a `public/` (p. ex. `images/my-logo.svg`)
`VITE_FOOTER_TEXT`	Text personalitzat del peu de pàgina o dels drets d'autor
`VITE_DEFAULT_LANGUAGE`	Idioma per defecte de la interfície (p. ex. `fr`, `de`, `es`)

Pas 4: desplega

Fes clic a "Deploy" i espera que s'acabi la compilació.

Domini personalitzat

Ves a la configuració del projecte
Navega a "Domains"
Afegeix el teu domini personalitzat
Configura el DNS segons les instruccions

Limitacions

::: warning Fitxers grans Les funcions serverless de Vercel tenen un límit de 50 MB. Com que BentoPDF és un lloc estàtic, això no hauria d'afectar-te, però els mòduls WASM són grans (~100 MB en total). Assegura't que es serveixin des de la carpeta /public. :::

Resolució de problemes

Temps d'espera de la compilació esgotat

Si les compilacions s'esgoten, prova això:

// vercel.json
{
  "buildCommand": "npm run build",
  "outputDirectory": "dist"
}

404 en actualitzar la pàgina

Afegeix un vercel.json per a l'encaminament SPA:

{
  "rewrites": [{ "source": "/(.*)", "destination": "/index.html" }]
}

La conversió de Word/ODT/Excel a PDF no funciona

Les conversions de LibreOffice WASM requereixen SharedArrayBuffer, que necessita aquestes capçaleres de resposta a totes les pàgines:

Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Opener-Policy: same-origin

Els fitxers precomprimits .wasm.gz i .data.gz també necessiten Content-Encoding: gzip perquè el navegador els descomprimeixi.

Afegeix-ho al teu vercel.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 verificar-ho, obre la consola de DevTools i executa console.log(window.crossOriginIsolated): hauria de retornar true.

3.8 KiB Raw Blame History