# شروع به کار

به BentoPDF خوش آمدید! این راهنما به شما کمک می‌کند سریع شروع کنید.

## BentoPDF چیست؟

BentoPDF مجموعه‌ابزار PDF رایگان، متن‌باز و حریم‌خصوصی‌محور است که **کاملاً در مرورگر شما** اجرا می‌شود. فایل‌های شما هرگز از دستگاهتان خارج نمی‌شوند؛ همهٔ پردازش‌ها به‌صورت محلی با فناوری WebAssembly (WASM) انجام می‌شود.

## شروع سریع

### گزینهٔ ۱: استفاده از نسخهٔ میزبانی‌شده

به [bentopdf.com](https://www.bentopdf.com) بروید تا بی‌درنگ از BentoPDF استفاده کنید؛ نیازی به نصب نیست.

### گزینهٔ ۲: میزبانی شخصی با Docker

> [!IMPORTANT]
> تبدیل فایل‌های Office به `SharedArrayBuffer` نیاز دارد که این موارد را لازم دارد:
>
> - `Cross-Origin-Opener-Policy: same-origin`
> - `Cross-Origin-Embedder-Policy: require-corp`
> - یک بستر امن (secure context)
>
> `http://localhost` برای آزمایش محلی کار می‌کند، چون مرورگرها loopback را قابل‌اعتماد می‌دانند. `http://192.168.x.x` یا دیگر IPهای شبکهٔ محلی معمولاً این‌گونه نیستند، بنابراین تبدیل‌های Word/Excel/PowerPoint هنگام دسترسی از دستگاه‌های دیگر شبکه به HTTPS نیاز دارند.

```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 در دو نسخهٔ ساخت عرضه می‌شود: **نسخهٔ میزبانی شخصی** (`bentopdf-simple`، که در بالا استفاده شد) برای استقرارهای داخلی، تیمی و سازمانی، و **نسخهٔ تجاری** (`bentopdf:latest`) که خود bentopdf.com و دارندگان مجوز تجاری برای استقرارهای عمومی از آن استفاده می‌کنند. هر دو ابزارهای PDF یکسانی دارند؛ نسخهٔ تجاری بخش hero، پرسش‌های متداول، نظرات کاربران و پاصفحهٔ bentopdf.com را اضافه می‌کند. اگر مطمئن نیستید، از نسخهٔ میزبانی شخصی استفاده کنید.

سپس `http://localhost:3000` را در مرورگر خود باز کنید.

> [!NOTE]
> اگر در حال آماده‌سازی استقرار OCR در محیط ایزوله (air-gapped) هستید، باید علاوه بر worker، هستهٔ اجرایی و فایل‌های traineddata مربوط به Tesseract، فونت‌های لایهٔ متنی OCR را نیز به‌صورت داخلی میزبانی کنید. راه‌اندازی کامل در [میزبانی شخصی](/fa/self-hosting/) مستند شده است، از جمله `VITE_OCR_FONT_BASE_URL` و پوشهٔ همراه `ocr-fonts/`.

### گزینهٔ ۳: ساخت از کد منبع

```bash
# Clone the repository
git clone https://github.com/alam00000/bentopdf.git
cd bentopdf

# Install dependencies
npm install

# Start development server
npm run dev
```

## نگاهی به قابلیت‌ها

| دسته                     | ابزارها                                                            |
| ------------------------ | ------------------------------------------------------------------ |
| **تبدیل به PDF**         | Word، Excel، PowerPoint، تصاویر، Markdown، EPUB، MOBI و موارد دیگر |
| **تبدیل از PDF**         | JPG، PNG، متن، Excel، SVG و موارد دیگر                             |
| **ویرایش و حاشیه‌نویسی** | امضا، هایلایت، حذف محتوای حساس، پر کردن فرم‌ها، افزودن مهر         |
| **سازماندهی**            | ادغام، تقسیم، چرخش، حذف صفحات، تغییر ترتیب                         |
| **بهینه‌سازی**           | فشرده‌سازی، تعمیر، مسطح‌سازی، OCR                                  |
| **امنیت**                | رمزگذاری، رمزگشایی، حذف محدودیت‌ها                                 |

## پشتیبانی مرورگرها

BentoPDF در مرورگرهای مدرن بهترین عملکرد را دارد:

- ✅ Chrome/Edge 90+
- ✅ Firefox 90+
- ✅ Safari 15+

## گام‌های بعدی

- [مشاهدهٔ همهٔ ابزارها](/fa/tools/)
- [میزبانی شخصی BentoPDF](/fa/self-hosting/)
- [مشارکت در پروژه](/fa/contributing)