mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 11:52:48 +01:00
81 lines
4.8 KiB
Markdown
81 lines
4.8 KiB
Markdown
# شروع به کار
|
|
|
|
به 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)
|