مستند Word

# إنشاء وتحرير وتحليل ملفات DOCX

## النظرة العامة

ملف .docx هو أرشيف ZIP يحتوي على ملفات XML.

## مرجع سريع

| المهمة | الطريقة | |------|--------| | قراءة وتحليل المحتوى | `pandoc` أو فك الضغط للحصول على XML الخام | | إنشاء مستند جديد | استخدم `docx-js` - انظر إنشاء مستندات جديدة أدناه | | تحرير مستند موجود | فك الضغط → تحرير XML → إعادة الضغط - انظر تحرير المستندات الموجودة أدناه |

### تحويل .doc إلى .docx

يجب تحويل ملفات `.doc` القديمة قبل تحريرها:

```bash python scripts/office/soffice.py --headless --convert-to docx document.doc ```

### قراءة المحتوى

```bash # استخراج النصوص مع التغييرات المتتبعة pandoc --track-changes=all document.docx -o output.md

# الوصول المباشر إلى XML python scripts/office/unpack.py document.docx unpacked/ ```

### التحويل إلى صور

```bash python scripts/office/soffice.py --headless --convert-to pdf document.docx pdftoppm -jpeg -r 150 document.pdf page ```

### قبول التغييرات المتتبعة

لإنتاج مستند نظيف مع قبول جميع التغييرات المتتبعة (يتطلب LibreOffice):

```bash python scripts/office/accept_changes.py input.docx output.docx ```

---

## إنشاء مستندات جديدة

قم بإنشاء ملفات .docx باستخدام JavaScript ثم تحقق من صحتها. التثبيت: `npm install -g docx`

### الإعداد ```javascript const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell, ImageRun, Header, Footer, AlignmentType, PageOrientation, LevelFormat, ExternalHyperlink, InternalHyperlink, Bookmark, FootnoteReferenceRun, PositionalTab, PositionalTabAlignment, PositionalTabRelativeTo, PositionalTabLeader, TabStopType, TabStopPosition, Column, SectionType, TableOfContents, HeadingLevel, BorderStyle, WidthType, ShadingType, VerticalAlign, PageNumber, PageBreak } = require('docx');

const doc = new Document({ sections: [{ children: [/* content */] }] }); Packer.toBuffer(doc).then(buffer => fs.writeFileSync("doc.docx", buffer)); ```

### التحقق من الصحة بعد إنشاء الملف، تحقق من صحته. إذا فشل التحقق، قم بفك الضغط وإصلاح XML وإعادة الضغط. ```bash python scripts/office/validate.py doc.docx ```

### حجم الصفحة

```javascript // حرج: docx-js يأخذ A4 كإعداد افتراضي وليس US Letter // اضبط حجم الصفحة بشكل صريح دائما للحصول على نتائج متسقة sections: [{ properties: { page: { size: { width: 12240, // 8.5 بوصة بوحدات DXA height: 15840 // 11 بوصة بوحدات DXA }, margin: { top: 1440, right: 1440, bottom: 1440, left: 1440 } // هوامش 1 بوصة } }, children: [/* content */] }] ```

**أحجام الصفحات الشائعة (وحدات DXA، 1440 DXA = 1 بوصة):**

| الورق | العرض | الارتفاع | عرض المحتوى (هوامش 1") | |------|-------|---------|----------------------| | US Letter | 12,240 | 15,840 | 9,360 | | A4 (افتراضي) | 11,906 | 16,838 | 9,026 |

**الاتجاه الأفقي:** docx-js يقوم بتبديل العرض والارتفاع داخليا، لذا مرر أبعاد الاتجاه العمودي واترك الباقي له: ```javascript size: { width: 12240, // مرر الحافة القصيرة كعرض height: 15840, // مرر الحافة الطويلة كارتفاع orientation: PageOrientation.LANDSCAPE // docx-js يقوم بتبديلها في XML }, // عرض المحتوى = 15840 - الهامش الأيسر - الهامش الأيمن (يستخدم الحافة الطويلة) ```

### الأنماط (تجاوز رؤوس البريد المدمجة)

استخدم Arial كخط افتراضي (مدعوم عالميا). احتفظ بالعناوين بلون أسود لسهولة القراءة.

```javascript const doc = new Document({ styles: { default: { document: { run: { font: "Arial", size: 24 } } }, // 12pt افتراضي paragraphStyles: [ // مهم: استخدم معرفات دقيقة لتجاوز الأنماط المدمجة { id: "Heading1", name: "Heading 1", basedOn: "Normal", next: "Normal", quickFormat: true, run: { size: 32, bold: true, font: "Arial" }, paragraph: { spacing: { before: 240, after: 240 }, outlineLevel: 0 } }, // outlineLevel مطلوب لجدول المحتويات { id: "Heading2", name: "Heading 2", basedOn: "Normal", next: "Normal", quickFormat: true, run: { size: 28, bold: true, font: "Arial" }, paragraph: { spacing: { before: 180, after: 180 }, outlineLevel: 1 } }, ] }, sections: [{ children: [ new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun("العنوان")] }), ] }] }); ```

### القوائم (لا تستخدم أبدا الرموز النقطية من Unicode)

```javascript // ❌ خاطئ - لا تدرج أبدا رموز النقاط يدويا new Paragraph({ children: [new TextRun("• عنصر")] }) // خطأ new Paragraph({ children: [new TextRun("\u2022 عنصر")] }) // خطأ

// ✅ صحيح - استخدم إعدادات الترقيم مع LevelFormat.BULLET const doc = new Document({ numbering: { config: [ { reference: "bullets", levels: [{ level: 0, format: LevelFormat.BULLET, text: "•", alignment: AlignmentType.LEFT, style: { paragraph: { indent: { left: 720, hanging: 360 } } } }] }, { reference: "numbers", levels: [{ level: 0, format: LevelFormat.DECIMAL, text: "%1.", alignment: AlignmentType.LEFT, style: { paragraph: { indent: { left: 720, hanging: 360 } } } }] }, ] }, sections: [{ children: [ new Paragraph({ numPr: { ilvl: 0, numId: 0 }, children: [new TextRun("عنصر")] }), ] }] }); ```