ملف Pptx

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

ملف `.pptx` هو أرشيف ZIP لملفات XML. اختر طريقتك حسب المهمة:

| المهمة | الطريقة | |---|---| | **إنشاء** عرض تقديمي جديد | اكتب سكربت `pptxgenjs` — انظر الملاحظات أدناه | | **تحرير** عرض تقديمي موجود، أو البناء من قالب | فك الضغط → تحرير `ppt/slides/slideN.xml` → ضغط | | **قراءة** المحتوى | `markitdown deck.pptx` (كتلة واحدة لكل شريحة تحت علامات `<!-- Slide number: N -->`)؛ شبكة مرئية: `python scripts/thumbnail.py deck.pptx` |

## السكربتات

المسارات نسبية لدليل هذه المهارة. كل شيء آخر هو Python عادي، `node`، أو shell.

| السكربت | ما يفعله | |---|---| | `scripts/thumbnail.py deck.pptx [prefix]` | شبكة معنونة لكل شريحة، لاختيار تخطيطات القوالب. لملفات `.pptx` فقط. مرر `prefix` — القيمة الافتراضية هي `thumbnails`، والتي ستعيد كتابة شبكات أي عرض تقديمي آخر يتم إجراؤه في نفس الدليل | | `scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml]` | تكرار شريحة (أو `slideLayoutN.xml`) مع جميع عمليات حفظ حزم البيانات. يقبل أيضا ملف `.pptx` مباشرة باستخدام `-o out.pptx` | | `scripts/clean.py unpacked/` | حذف الشرائح والوسائط والعلاقات التي لم يعد يشار إليها. قم بالتشغيل **بعد** أن يصبح `<p:sldIdLst>` نهائيا | | `scripts/office/validate.py deck.pptx [--original src.pptx]` | فحوصات المخطط، والعلاقات، ونوع المحتوى، والمخططات، والشرائح؛ كل فشل يذكر إصلاحه. مرر `--original` لأي عرض تقديمي مشتق من قالب — فإنه يحدد خط الأساس لفحوصات المخطط مقابل القالب، بحيث لا تقرأ أخطاء XSD الخاصة بالقالب على أنها أخطاؤك | | `scripts/office/soffice.py --headless --convert-to pdf deck.pptx` | غلاف LibreOffice — `soffice` العادي يتوقف عن العمل في بيئة الاختبار هذه |

## الإنشاء باستخدام pptxgenjs — ملاحظات

`pptxgenjs` مثبت مسبقا — لا تقم بتشغيل `npm install` أولا؛ اكتب السكربت و `require('pptxgenjs')` مباشرة. فقط إذا فشل هذا ال require: `npm install pptxgenjs`. يعرف النموذج ال API؛ هذه هي الأخطاء الشائعة:

- **اضبط `pres.layout` قبل إضافة الشرائح.** اللوحة الافتراضية هي `LAYOUT_16x9` = **10" × 5.625"**، وليست بعرض 13.3". الإحداثيات التي تتجاوز الحافة تكتب، ولا تقيد — الشكل ببساطة لا يظهر على الشريحة. (`LAYOUT_WIDE` هو 13.3" × 7.5".) - **ألوان Hex: لا تستخدم `#` أبدا، ولا 8 أرقام أبدا.** `color: "FF0000"`. كل من `"#FF0000"` و alpha المدمجة في ال hex (`"00000020"`) **تتلف الملف**. للشفافية: `transparency: 0-100` على التعبئات والصور، `opacity: 0.0-1.0` على الظلال — يتم تجاهل كل منهما بصمت على الآخر. - **pptxgenjs يغير كائنات الخيارات في مكانها** (يحول القيم إلى EMU عند الاستخدام الأول). لا تشارك أبدا كائن `shadow`/options واحدا عبر استدعاءين ل `add*` — قم ببناء كائن جديد في كل مرة. - **يجب أن يكون `offset` للظل ≥ 0** — يؤدي الإزاحة السلبية إلى تلف الملف. لإلقاء ظل للأعلى، استخدم `angle: 270` مع إزاحة موجبة. - **يتم تجاهل `letterSpacing` بصمت** — الخيار الحقيقي هو `charSpacing`. - **القوائم:** `bullet: true` على كل عنصر، وليس `•` حرفيا (يعرض نقاطا مزدوجة). اضبط `breakLine: true` على كل عنصر في المصفوفة باستثناء الأخير. افصل الفقرات ذات النقاط باستخدام `paraSpaceAfter`، وليس `lineSpacing` (فجوات كبيرة). - **`new pptxgen()` واحد لكل ملف إخراج** — لا تعيد استخدام مثيل أبدا. - **`rectRadius` يعمل فقط على `ROUNDED_RECTANGLE`**، وليس `RECTANGLE`. - **التعبئات المتدرجة غير مدعومة** — استخدم صورة متدرجة كخلفية بدلا من ذلك. - **مربعات النص تحتوي على حشوة داخلية مدمجة** — اضبط `margin: 0` كلما كان يجب أن يتوافق النص مع شكل أو خط أو أيقونة عند نفس الإحداثي x. - **ملاحظات المتحدث توضع في `slide.addNotes("...")`** (نص عادي، مرة واحدة لكل شريحة)، وليس في مربع نص على الشريحة. - **حافظ على المخططات أصلية.** استخدم `addChart()` لكل ما يمكن ل PowerPoint رسمه (مرر مصفوفة من `{type, data, options}` للمجموعات). للميزات الأصلية في PowerPoint التي لا تعرضها المكتبة (خطوط الاتجاه، أشرطة الخطأ)، احسب السلسلة الإضافية بنفسك أو قم بمعالجة OOXML الذي تم إنشاؤه لاحقا — لا تعتمد على صورة معروضة. فقط أنواع المخططات التي لا يمتلك PowerPoint لها شكلا أصليا (Sankey، الشبكة، الوتر) تدرج كصور. - **المخططات الافتراضية تعرض عارية** — لا يوجد عنوان، لا تسميات بيانات، لوحة ألوان قديمة. اضبط `showTitle` + `title`، `showValue: true` + `dataLabelPosition`، `chartColors: [...]` من لوحة الألوان الخاصة بك، واجعل الإطار هادئا (`catAxisLabelColor`/`valAxisLabelColor`، `valGridLine: { color, size }`، `catGridLine: { style: "none" }`، `showLegend: false` لسلسلة واحدة). - **على مخطط شريطي أو عمودي مكدس، يجب أن يكون `dataLabelPosition` إما `ctr` أو `inEnd` أو `inBase`.** `outEnd` **يتلف الملف**. - **سلسلة مجمعة تستخدم `secondaryValAxis`/`secondaryCatAxis` تحتاج إلى كل من `valAxes` و `catAxes` في خيارات المخطط، مع إدخالين لكل منهما.** بدونها، يكتب pptxgenjs *معرفات* محاور لا يعلن عنها أبدا، و PowerPoint **يتجاهل هذا المخطط** ويبلغ عن تلف الملف. توفير `valAxes` فقط لا يكفي. - **بعد `writeFile()`، قم بتشغيل `python scripts/office/validate.py deck.pptx`.** يبلغ عن خطأي المخطط المذكورين أعلاه وعيوب XML للشريحة التي يرفضها PowerPoint، ويذكر الإصلاح لكل منها. قم بإصلاحها في المولد الخاص بك، وليس عن طريق التحرير اليدوي ل XML المعبأ. - **لا تعيد ترتيب**