mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
81 lines
4.5 KiB
Markdown
81 lines
4.5 KiB
Markdown
# البدء
|
|
|
|
مرحبًا بك في BentoPDF! سيساعدك هذا الدليل على الانطلاق بسرعة.
|
|
|
|
## ما هو BentoPDF؟
|
|
|
|
BentoPDF مجموعة أدوات PDF مجانية ومفتوحة المصدر تضع الخصوصية أولًا، وتعمل **بالكامل داخل متصفحك**. ملفاتك لا تغادر جهازك أبدًا، فكل المعالجة تتم محليًا باستخدام تقنية WebAssembly (WASM).
|
|
|
|
## بداية سريعة
|
|
|
|
### الخيار 1: استخدام النسخة المستضافة
|
|
|
|
زر [bentopdf.com](https://www.bentopdf.com) لاستخدام BentoPDF فورًا، بدون أي تثبيت.
|
|
|
|
### الخيار 2: الاستضافة الذاتية باستخدام Docker
|
|
|
|
> [!IMPORTANT]
|
|
> يتطلب تحويل ملفات Office وجود `SharedArrayBuffer`، وهذا يحتاج إلى كل مما يلي:
|
|
>
|
|
> - `Cross-Origin-Opener-Policy: same-origin`
|
|
> - `Cross-Origin-Embedder-Policy: require-corp`
|
|
> - سياق آمن
|
|
>
|
|
> يعمل `http://localhost` للاختبار المحلي لأن المتصفحات تعتبر عنوان الحلقة المحلية موثوقًا. أما `http://192.168.x.x` أو غيره من عناوين الشبكة المحلية فعادةً لا يُعتبر كذلك، لذا تتطلب تحويلات 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 نفسها، وتضيف النسخة التجارية الواجهة الرئيسية لـ bentopdf.com والأسئلة الشائعة وآراء المستخدمين والتذييل. إذا كنت غير متأكد، فاستخدم نسخة الاستضافة الذاتية.
|
|
|
|
ثم افتح `http://localhost:3000` في متصفحك.
|
|
|
|
> [!NOTE]
|
|
> إذا كنت تجهّز نشرًا معزولًا عن الإنترنت لميزة OCR، فعليك استضافة خطوط الطبقة النصية الخاصة بـ OCR داخليًا، إضافة إلى عامل Tesseract وبيئة التشغيل الأساسية وملفات traineddata. الإعداد الكامل موثّق في [الاستضافة الذاتية](/ar/self-hosting/)، بما في ذلك `VITE_OCR_FONT_BASE_URL` والمجلد المضمّن `ocr-fonts/`.
|
|
|
|
### الخيار 3: البناء من المصدر
|
|
|
|
```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+
|
|
|
|
## الخطوات التالية
|
|
|
|
- [استكشف جميع الأدوات](/ar/tools/)
|
|
- [استضف BentoPDF بنفسك](/ar/self-hosting/)
|
|
- [ساهم في المشروع](/ar/contributing)
|