أدوات مستندات LibreOffice

# أدوات مستندات LibreOffice

إنشاء وتحرير وأتمتة مستندات Writer وCalc وImpress من خلال سير عمل موحد لـ LibreOffice.

## المتطلبات الأساسية

- **LibreOffice** مثبت (يُوصى بـ 7.x أو أحدث)
- يجب أن يعمل LibreOffice في **وضع الاستماع** للوصول إلى واجهة UNO:
  ```bash
  soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore
  ```
- **Python 3** مع وحدة `uno` (مُجمعة مع LibreOffice على معظم الأنظمة)
- المنصات المدعومة: Linux وmacOS وWindows (LibreOffice + UNO متاحة على جميع الأنظمة)

### فحص سريع للبيئة

```bash
# التحقق من تثبيت LibreOffice
soffice --version

# بدء المستمع بدون واجهة رسومية (في الخلفية)
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &

# التحقق من اتصال UNO
python3 -c "import uno; print('UNO available')"
```

إذا فشل `import uno`، تأكد من أن مسار Python يتضمن موقع LibreOffice Packages (مثل `/usr/lib/libreoffice/program/`).

## ما يفعله هذا المكون الإضافي

ثلاث مهارات للتطبيقات الأساسية الثلاثة لـ LibreOffice:

| المهارة | التنسيق | القدرات |
|-------|--------|-------------|
| **Writer** | .odt | إدراج النصوص والجداول والصور والبيانات الوصفية وأنماط الفقرات |
| **Calc** | .ods | عمليات الخلايا والصيغ والتنسيق والرسوم البيانية والنطاقات المسماة والتحقق من البيانات |
| **Impress** | .odp | الشرائح ووضع المحتوى والجداول والرسوم البيانية والوسائط والملاحظات وصفحات الأساس |

## مثال كامل: خط أنابيب التقرير الأسبوعي

يقوم فريق بأتمتة سير عمل تقاريرهم يوم الجمعة — جمع البيانات في جدول بيانات وإنشاء ملخص مكتوب وإنتاج عرض تقديمي.

### الخطوة 1: Calc — تجميع المقاييس الأسبوعية

```
إنشاء جدول بيانات Calc جديد "weekly-metrics.ods".
الورقة 1 "Revenue": أعمدة Date وProduct وUnits وRevenue مع بيانات نموذجية من الإثنين إلى الجمعة.
الورقة 2 "Summary": استخدام صيغ SUMIF لتجميع الإيرادات حسب المنتج.
إضافة مخطط شريطي على الورقة 2 يوضح الإيرادات حسب المنتج.
تنسيق الصفوف الرأسية بالخط العريض مع خلفية زرقاء.
```

### الخطوة 2: Writer — إنشاء التقرير المكتوب

```
إنشاء مستند Writer "weekly-report.odt".
العنوان: "تقرير أسبوعي — 10 مارس 2026"
القسم 1: الملخص التنفيذي (فقرتان تلخصان المقاييس من جدول البيانات).
القسم 2: النقاط البارزة (قائمة نقطية لأهم 3 إنجازات).
القسم 3: أولويات الأسبوع القادم (قائمة مرقمة).
إدراج جدول مع الإجماليات الملخصة من جدول البيانات.
تعيين الخط إلى Liberation Serif 12pt والعناوين 16pt عريض.
```

### الخطوة 3: Impress — بناء عرض الشرائح

```
إنشاء عرض تقديمي Impress "weekly-deck.odp".
الشفرة 1: شريحة العنوان — "مراجعة أسبوعية Q1 W10" مع تاريخ كفئة فرعية.
الشفرة 2: نظرة عامة على المقاييس — إدراج جدول بالإيرادات حسب المنتج.
الشفرة 3: النقاط البارزة — نقاط بسيطة لأهم الإنجازات.
الشفرة 4: الخطوات القادمة — أولويات مرقمة.
الشفرة 5: شريحة شكر لك.
إضافة ملاحظات المتحدث على الشرائح 2-4 مع نقاط الحديث.
```

**النتيجة:** ثلاثة مستندات متزامنة (جدول بيانات وتقرير وعرض شرائح) تم إنشاؤها من سير عمل واحد — بدون تنسيق يدوي ولا نسخ ولصق بين التطبيقات.

## معالجة الأخطاء واستعادة الفشل

### LibreOffice غير قيد التشغيل

إذا فشل اتصال socket UNO:
```
Error: could not connect to socket on localhost:2002
```
**الحل:** بدء المستمع بدون واجهة رسومية:
```bash
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &
```

### وحدة UNO غير موجودة

```
ModuleNotFoundError: No module named 'uno'
```
**الحل:** إضافة Python الخاص بـ LibreOffice إلى المسار:
```bash
# Linux
export PYTHONPATH=/usr/lib/libreoffice/program:$PYTHONPATH

# macOS
export PYTHONPATH="/Applications/LibreOffice.app/Contents/Frameworks/:$PYTHONPATH"
```

### القالب أو الملف غير موجود

إذا تم الإشارة إلى ملف قالب لكنه مفقود، سيقوم المهارة بإنشاء مستند فارغ جديد بدلاً من ذلك. تأكد من أن مسارات القوالب مطلقة أو نسبية لمجلد العمل.

### أخطاء الأذونات عند الحفظ

إذا كان دليل الإخراج غير قابل للكتابة، ففشله عملية الحفظ. تحقق من أذونات الكتابة قبل تشغيل إنشاء المستندات:
```bash
test -w ./output/ || mkdir -p ./output/
```

### الوصول المتزامن

لا يدعم UNO الخاص بـ LibreOffice الاتصالات المتزامنة بشكل جيد. إذا حاولت نصوص برمجية متعددة استخدام نفس المستمع في نفس الوقت، فقد تفشل العمليات أو تنتج مخرجات تالفة. استخدم اتصالًا واحدًا في كل مرة، أو ابدأ نسخًا منفصلة بدون واجهة رسومية على منافذ مختلفة.