mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 11:52:48 +01:00
81 lines
3.6 KiB
Markdown
81 lines
3.6 KiB
Markdown
# Primers passos
|
|
|
|
Et donem la benvinguda a BentoPDF! Aquesta guia t'ajudarà a posar-te en marxa ràpidament.
|
|
|
|
## Què és BentoPDF?
|
|
|
|
BentoPDF és un conjunt d'eines PDF gratuït, de codi obert i pensat per protegir la privadesa, que funciona **íntegrament al navegador**. Els fitxers no surten mai del dispositiu: tot el processament es fa en local amb tecnologia WebAssembly (WASM).
|
|
|
|
## Inici ràpid
|
|
|
|
### Opció 1: utilitza la versió allotjada
|
|
|
|
Visita [bentopdf.com](https://www.bentopdf.com) per utilitzar BentoPDF a l'instant, sense instal·lació.
|
|
|
|
### Opció 2: allotja'l tu mateix amb Docker
|
|
|
|
> [!IMPORTANT]
|
|
> La conversió de fitxers d'Office requereix `SharedArrayBuffer`, que necessita tots dos:
|
|
>
|
|
> - `Cross-Origin-Opener-Policy: same-origin`
|
|
> - `Cross-Origin-Embedder-Policy: require-corp`
|
|
> - un context segur
|
|
>
|
|
> `http://localhost` funciona per a proves locals perquè els navegadors consideren fiable el bucle local. `http://192.168.x.x` o altres IP de la xarxa local normalment no, de manera que les conversions de Word/Excel/PowerPoint requeriran HTTPS quan s'hi accedeixi des d'altres dispositius de la xarxa.
|
|
|
|
```bash
|
|
# Pull and run the Docker image (self-hosted build)
|
|
docker run -d -p 3000:8080 ghcr.io/alam00000/bentopdf-simple:latest
|
|
|
|
# Or use Docker Compose
|
|
curl -O https://raw.githubusercontent.com/alam00000/bentopdf/main/docker-compose.yml
|
|
docker compose up -d
|
|
```
|
|
|
|
> [!TIP]
|
|
> BentoPDF s'ofereix en dues versions: la **versió autoallotjada** (`bentopdf-simple`, la utilitzada més amunt) per a desplegaments interns, d'equip o d'organització, i la **versió comercial** (`bentopdf:latest`) que utilitza el mateix bentopdf.com i els titulars de llicència comercial amb desplegaments públics. Totes dues inclouen les mateixes eines PDF: la versió comercial afegeix la portada, les preguntes freqüents, els testimonis i el peu de pàgina de bentopdf.com. Si tens dubtes, utilitza la versió autoallotjada.
|
|
|
|
Després obre `http://localhost:3000` al navegador.
|
|
|
|
> [!NOTE]
|
|
> Si prepares un desplegament d'OCR aïllat de la xarxa, has d'allotjar internament les fonts de la capa de text d'OCR, a més del worker de Tesseract, el runtime principal i els fitxers traineddata. La configuració completa es documenta a [Autoallotjament](/ca/self-hosting/), incloent-hi `VITE_OCR_FONT_BASE_URL` i el directori `ocr-fonts/` inclòs.
|
|
|
|
### Opció 3: compila des del codi font
|
|
|
|
```bash
|
|
# Clone the repository
|
|
git clone https://github.com/alam00000/bentopdf.git
|
|
cd bentopdf
|
|
|
|
# Install dependencies
|
|
npm install
|
|
|
|
# Start development server
|
|
npm run dev
|
|
```
|
|
|
|
## Les funcions d'un cop d'ull
|
|
|
|
| Categoria | Eines |
|
|
| ------------------------- | ------------------------------------------------------------ |
|
|
| **Converteix a PDF** | Word, Excel, PowerPoint, imatges, Markdown, EPUB, MOBI i més |
|
|
| **Converteix des de PDF** | JPG, PNG, text, Excel, SVG i més |
|
|
| **Edita i anota** | Signa, ressalta, censura, omple formularis, afegeix segells |
|
|
| **Organitza** | Fusiona, divideix, gira, suprimeix pàgines, reordena |
|
|
| **Optimitza** | Comprimeix, repara, aplana, OCR |
|
|
| **Seguretat** | Xifra, desxifra, elimina restriccions |
|
|
|
|
## Compatibilitat amb navegadors
|
|
|
|
BentoPDF funciona millor en navegadors moderns:
|
|
|
|
- ✅ Chrome/Edge 90+
|
|
- ✅ Firefox 90+
|
|
- ✅ Safari 15+
|
|
|
|
## Següents passos
|
|
|
|
- [Explora totes les eines](/ca/tools/)
|
|
- [Allotja BentoPDF tu mateix](/ca/self-hosting/)
|
|
- [Contribueix al projecte](/ca/contributing)
|