# تصدير المشروع وتحويله

احفظ أحدث ملف PDF، أو حزّم المصدر القابل للتحرير، أو صدّر صور الصفحات أو HTML، أو اكتب PDF/A وPDF/UA من Typst، أو حوّل مستند LaTeX أو Typst أو Markdown.

افتح **Export** في شريط أدوات المشروع. تتبع هذه القائمة محرك المستند الحالي ونوعه، لذا فهي لا تعرض إلا المسارات التي يستطيع Oleafly تشغيلها لهذا المشروع.

![زر التصدير هو عنصر التحكم الخاص بالتنزيل الموجود مباشرة بعد Recompile في الشريط العلوي للمشروع.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## اختر المخرجات التي يحتاجها المستلم

- **PDF** للقراءة والطباعة ومعظم بوابات التقديم.
- **Source ZIP** للمؤلفين المشاركين أو للأنظمة التي تحتاج إلى المخطوطة والأشكال وقائمة المراجع والأنماط المحلية.
- **Page PNG** لشريحة أو رسالة أو نظام مراجعة يتوقع صورة.
- **PNG أو SVG أو HTML يكتبه Typst** لمشاريع Typst التي تحتاج إلى كل صفحة بوصفها صورة، أو صفحات متجهة، أو صفحة ويب.
- **Word أو HTML أو Markdown أو Typst أو LaTeX أو نص عادي** لمن يحتاج إلى تحرير المحتوى أو إعادة استخدامه بصيغة أخرى.
- **PowerPoint** لتحويل عرض تقديمي أو مستند Markdown إلى شرائح. و**EPUB** لقارئ الكتب الإلكترونية. وأي هذه الصيغ يظهر يعتمد على المحرك. انظر [تصدير العروض والكتب](#presentation-and-book-exports).

## احفظ ملف PDF أو أرشيف المصدر أو صورة صفحة

1. اختر **Recompile** حتى يشمل المخرج آخر تعديلاتك.
2. افحص ملف PDF، بما في ذلك الصفحات الأخيرة وقائمة المراجع.
3. افتح **Export**.
4. اختر **Export as PDF** أو **Export source (.zip)** أو **Export page as PNG**.
5. حدد وجهة الحفظ في مربع حوار الحفظ.
6. اختر **Show in folder** في رسالة الإتمام للوصول إلى الملف المحفوظ.

تبقى إجراءات PDF وصور الصفحات معطلة حتى يصبح للمشروع ملف PDF، وتقول القائمة **PDF requires a compile first**. يحفظ **Export as PDF** ملف PDF الظاهر في المعاينة. ويحفظ **Export page as PNG** الصفحة التي تنظر إليها في المعاينة، بدقة عالية.

يستبعد أرشيف المصدر مخابئ البناء ومكونات Git الداخلية. كما يترك الروابط الرمزية خارجه، وتذكر رسالة الإتمام عدد ما تخطاه.

### حين لا يكون ملف PDF محدَّثًا

يظل Oleafly يحفظ ملف PDF أو صورة الصفحة حين تكون المعاينة قديمة، وتخبرك رسالة الإتمام بذلك:

- بعد تجميع فاشل، تقول إن آخر تجميع فشل، لذا قد يكون الملف ناقصًا.
- بعد تعديلات لم تجمّعها، تقول إن الملف من آخر تجميع ولا يتضمن آخر تعديلاتك.

أعد التجميع، وافحص المعاينة، وصدّر مرة أخرى قبل أن ترسل الملف إلى أي شخص.

## صور Typst وHTML

تتضمن قائمة التصدير في مشروع Typst أيضًا الخيار **Images and HTML**، الذي يفتح **Export with Typst**. يرسم Typst هذه الملفات بنفسه، لذا تبدو صفحات PNG وSVG تمامًا كما تبدو في ملف PDF.

- **صور PNG** تقبل **Resolution** بقيم 72 أو 144 أو 300 أو 600 PPI.
- **صور SVG** تحفظ الصفحات رسومات متجهة.
- **HTML** موسوم بأنه **Experimental**. يحتفظ HTML من Typst بالنص والصور لكنه يغفل إعداد الصفحة والرسومات. وقبل Typst 0.15 يغفل المعادلات أيضًا، ويذكر مربع الحوار ذلك عندما تختار HTML.

في PNG وSVG، يقبل حقل **Pages** أرقام صفحات ونطاقات مثل `1, 3-5` أو `8-`. اتركه فارغًا لكل الصفحات. تحفظ كل صفحة في ملف مستقل، يرقم وفق الاسم الذي تختاره. تتطلب نطاقات الصفحات Typst 0.12 أو أحدث، ويتطلب HTML Typst 0.13 أو أحدث. ولا يعرض مربع الحوار إلا ما يستطيعيه إصدار Typst الخاص بالمشروع. إذا كان للمشروع [متغيرات بناء](/docs/typst/#build-variants-and-sysinputs)، فإن التصدير يستخدم المتغير المحدد في قائمة البناء.

## PDF/A وPDF/UA من Typst

يكتب Typst بنفسه ملفات PDF الأرشيفية والداعمة لإمكانية الوصول. افتح **الدرع** في الشريط الجانبي للمشروع للوصول إلى [Preflight](/docs/preflight/)، وابحث عن **PDF standards** ضمن فحص **Accessibility**. اختر **Standard**، مثل PDF/A-2b أو PDF/UA-1، ثم اختر **Export PDF**.

تعتمد القائمة على إصدار Typst الخاص بالمشروع. لا يوفر Typst 0.11 أي معيار، ويوفر Typst 0.12 معيار PDF/A-2b، ويضيف Typst 0.13 معيار PDF/A-3b، أما Typst 0.14 والإصدارات الأحدث فتوفر كل مستويات PDF/A إضافة إلى PDF/UA-1. كذلك يضع Typst 0.14 والإصدارات الأحدث وسومًا في كل ملف PDF لقارئات الشاشة، فلا حاجة إلى عملية بناء موسومة منفصلة. ويتطلب PDF/UA-1 عنوانًا للمستند ونصًا بديلًا لكل صورة، ويفحص Preflight كليهما.

## الصيغ القابلة للتحرير

| محرك المشروع | الصيغ في قائمة Export |
| --- | --- |
| **LaTeX** | Word، وHTML مكتف بذاته مع MathML، وMarkdown، وTypst، والنص العادي |
| **Typst** | LaTeX، وWord، وHTML مكتف بذاته مع MathML، وMarkdown، والنص العادي |
| **Markdown** | Word، وHTML مكتف بذاته مع MathML، وTypst، وLaTeX، والنص العادي |

يقدم مشروع Typst أيضًا صيغة EPUB، ويقدم مشروع Markdown كلًا من PowerPoint وEPUB. ولا يقدمهما مشروع LaTeX إلا لفئة مستندات مطابقة.

تعمل هذه التحويلات محليًا عبر Pandoc. يستخدم Oleafly تثبيتًا متوافقًا موجودًا على حاسوبك، أو ينزل نسخة مدارة موثوقة عند الحاجة إليها أول مرة.

تسلك مشاريع Typst مسارًا مختلفًا. يكتب Typst المستند أولًا بصيغة HTML، ثم يحول Pandoc هذا HTML إلى Word أو HTML أو Markdown أو LaTeX أو نص عادي أو EPUB، فتنتقل المعادلات والمراجع سليمة. وقدرة المستند على سلوك هذا المسار تعتمد على إصدار Typst الخاص بالمشروع:

| إصدار Typst | المسار |
| --- | --- |
| 0.15 أو أحدث | عبر HTML |
| 0.13 و0.14 | عبر HTML عندما يستطيع Typst كتابة المستند كله. وعندما لا يستطيع، يقرأ Pandoc مصدر Typst بدلًا من ذلك. |
| 0.12 أو أقدم | يقرأ Pandoc المصدر |

إذا توقف Typst بخطأ أثناء كتابة HTML، يقرأ Pandoc المصدر في أي إصدار. وعندما يقرأ Pandoc المصدر في Typst 0.13 أو 0.14، تحذّر رسالة الإتمام من أن النص المدوَّر أو المكبَّر أو المنقول أو المائل قد يكون مفقودًا، ما لم تكن للتصدير تحذيرات. وللحصول على أكمل تصدير، بدّل المشروع إلى Typst 0.15 أو أحدث تحت **Typst version (this project)** في قائمة التجميع.

حين يمر التصدير عبر HTML، يبقى النص داخل دوال التخطيط مثل `align` و`grid` و`rotate` فيه. أما الرسم المصنوع بـCeTZ فيفقد خطوطه وأشكاله ولا يحتفظ إلا بتسمياته النصية، وتسمّي رسالة الإتمام ما تركه Typst.

## حوّل مستندًا

1. ابنِ المستند مرة واحدة وأصلح أي أخطاء في المصدر.
2. افتح **Export** واختر الصيغة الهدف.
3. أكمل إعداد Pandoc إذا طلب منك ذلك. وإذا قال Oleafly إن Pandoc غير متاح، فاختر **Repair Pandoc** في **Settings → Engines → Markdown**، ثم صدّر مرة أخرى.
4. احفظ الملف المحول بالامتداد المقترح.
5. اقرأ رسالة الإتمام. وإذا ذكرت تحذيرات، فاختر **Show warnings** لترى ما تركه التصدير.
6. افتح الملف في التطبيق الهدف وتحقق من بنيته ومظهره.

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

لتحويل مشروع LaTeX بأكمله إلى مشروع Typst تواصل العمل فيه، استخدم [التحويل إلى مشروع Typst](/docs/typst/#convert-a-latex-project-to-typst) بدلًا من ذلك. فهو ينشئ مشروعًا جديدًا ويبلغك بما يحتاج إلى عناية.

### ما يحافظ عليه التحويل

يهدف Pandoc إلى الحفاظ على العناوين والفقرات والقوائم والروابط والاستشهادات المرجعية والجداول والصور والرياضيات القابلة للتحرير. لكنه لا يستطيع إعادة إنتاج كل ميزة من ميزات لغة المصدر في كل صيغة هدف. افحص هذه الجوانب عن قرب:

- أوامر LaTeX المخصصة وبيئاتها
- تخطيط الصفحات أو العناصر العائمة المضبوطة يدويًا
- الجداول المعقدة أو المتداخلة
- أسلوب قائمة المراجع وطريقة عرض الاستشهادات
- دوال Typst التي لا مقابل مباشر لها في الصيغة الهدف
- HTML الخام أو امتدادات Markdown

يضمن تصدير HTML موارده ويكتب المعادلات بصيغة MathML. وهذا يجعله مفيدًا لمشاركة مستند يفترض أن يفتح من تلقاء نفسه، لكن يبقى من المستحسن اختباره في المتصفحات التي يستخدمها قراؤك.

### ما تحافظ عليه كل صيغة

- تحوّل تصديرات Word وPowerPoint أشكال PDF وSVG وWebP إلى صور PNG بدقة 220 ppi. والشكل الذي لا حجم له في المصدر يحتفظ بعرضه.
- تحوّل تصديرات HTML وEPUB أشكال PDF إلى صور PNG.
- يحتفظ Markdown والنص العادي المصدَّران من LaTeX بالعنوان والمؤلف والملخص.
- التصديرات إلى Markdown أو Typst من LaTeX، وإلى LaTeX أو Typst من Markdown، تشير إلى ملفات أشكال المشروع بدلًا من نسخها. وما لم تكن للتصدير تحذيرات، تذكّرك رسالة الإتمام بنسخ الصور وقائمة المراجع بجانب الملف المصدَّر قبل أن تجمّعه. ويحتفظ مستند Markdown المصدَّر إلى Typst أو LaTeX بقائمة المراجع التي يعلنها، أو بملفات `.bib` الخاصة بالمشروع إن لم يعلن أي واحدة.
- يتبع التصدير إلى LaTeX من مستند Markdown [نوع المستند](/docs/writing/markdown/#document-types) الخاص به. تصبح الشرائح والملصقات مصدر Beamer، ويبدأ التقرير أو الكتاب فصوله من عناوين `#`، ويصبح الخطاب خطابًا بنمط KOMA-Script.
- ينسخ التصدير إلى LaTeX من Typst صور المستند إلى مجلد `<name>-media` بجانب ملف `.tex`. وتصبح صور SVG وGIF وWebP ملفات PDF هناك، لأن LaTeX لا يستطيع قراءتها.

تبحث التصديرات عن الأشكال في مجلد المستند الرئيسي وجذر المشروع وأي مجلدات `\graphicspath`، وتجد شكلًا سُمّي دون امتداده. ولا يمكن تحويل أشكال EPS، لذا تدخل الملف دون تغيير، مع تحذير. وفي تصدير Word أو HTML أو EPUB أو PowerPoint لمستند Markdown، تعرض كتلة Mermaid الشكل المحفوظ لها.

### تحذيرات بعد التصدير

يترك Pandoc ما لا تستطيع الصيغة حمله. وحين يحدث ذلك في تصدير من مشروع LaTeX أو Markdown، أو في تصدير Typst يقرأ المصدر، تقول رسالة الإتمام إن الملف حُفظ بتحذيرات وكم عددها، بدلًا من ملاحظاتها الأخرى مثل تذكير نسخ الصور. اختر **Show warnings** لفتح **Export warnings** الذي يسرد ما فُقد. ويفتح **Show in folder** في مربع الحوار ذاك المجلد الذي فيه الملف المحفوظ.

قد تسمّي القائمة:

- كتلة تركها التصدير، مع ملفها وسطرها متى عُرفا، مثل `tikzpicture` أو `\includepdf` أو أمر تراكب في Beamer مثل `\only` أو `\uncover`
- شكلًا لم يستطع التصدير العثور عليه أو تحويله
- مفتاح استشهاد ليس في قائمة المراجع
- رياضيات بقيت شيفرة TeX
- إحالات لا رقم لها بعد، ويصلحها التجميع

يظهر التحذير المتكرر مرة واحدة، وتتوقف القائمة عند 50. ويعمل تصدير PowerPoint بطريقة مختلفة حين يكون شكل مفقودًا: فهو يتوقف ولا يحفظ ملفًا، ويسمّي الخطأ الشكل. أما تصديرات Typst التي تمر عبر HTML فتقول ما تركه Typst في رسالة الإتمام بدلًا من ذلك.

## تصدير العروض والكتب

يطابق مشروع LaTeX هذه الصيغ مع فئة مستنداته. يظهر الخيار **Export as PowerPoint (.pptx)** لعرض Beamer، ويظهر الخيار **Export as EPUB (.epub)** للفئات `book` و`report` و`memoir` و`scrbook` و`scrreprt`.

في عرض Beamer، يبدأ كل إطار شريحة جديدة، ويضيف `\section` شريحة قسم، ولا يضيف `\subsection` شيئًا. والإطار الذي فيه أكثر من صورة، أو صورة ومحتوى آخر، قد يمتد إلى شريحة ثانية.

في مشاريع Typst وMarkdown، لا تفحص القائمة المستند لهذه التصديرات. ويقدم مشروع Markdown كليهما دائمًا، بينما يقدم مشروع Typst صيغة EPUB دائمًا. عندما يتحول مستند Markdown إلى PowerPoint، يصبح كل عنوان من المستوى الأول شريحة قسم، ويبدأ كل عنوان من المستوى الثاني شريحة جديدة. والاستثناء مستند يحمل `type: slides`: يحدد سطر `slide-level` في واجهته الأمامية مستوى العنوان الذي يبدأ شريحة. ويحصل كل ملف EPUB على جدول محتويات، ومعادلاته MathML.

استخدم هذه الصيغ نقاط بداية قابلة للتحرير. فنادرًا ما يتطابق تركيب الشرائح وتنسيق الكتب تطابقًا تامًا بين الصيغ، لذا افحص كل شريحة أو فصل في التطبيق الوجهة.

## صدّر شكلًا مستقلًا

يقدم مشروع الشكل المستقل الخيارين **Export as PDF (vector image)** و**Export as PNG** بعد اكتمال البناء. اختر PDF لتحصل على خطوط ونص حادين عند أي مقياس. واختر PNG عندما لا تقبل الوجهة إلا الصور النقطية.

## احفظ المخرجات داخل المشروع

تقدم [معاينة PDF](/docs/pdf-preview/) أيضًا الخيار **Save PDF to project**. فهو يبقي نسخة للتقديم أو شكلًا مبنيًا بجوار المصدر. ولإبقاء تلك النسخة محدّثة، شغّل [Sync PDF on compiles](/docs/pdf-preview/#sync-pdf-on-compiles) في القائمة نفسها، فيحدّث Oleafly ملف PDF باسم المشروع بعد كل تجميع ناجح. ويمكن حفظ ملف PDF أقدم من [نقطة حفظ](/docs/checkpoints/#save-a-pdf-from-a-checkpoint) دون استعادة المشروع. ولا تضف ذلك الملف إلى [سجل Git](/docs/git-history/) إلا إذا كنت تنوي تتبع إصدارات المخرجات المولدة.

## تحقق قبل المشاركة

شغل [Preflight](/docs/preflight/) قبل التقديم. وإذا احتجت إلى ملف PDF موسوم، فاتبع مسار التصدير الداعم لإمكانية الوصول في LaTeX أو اختر معيار PDF/UA في مشروع Typst، ثم تحقق من النتيجة بأداة فحص PDF/UA مستقلة ومراجعة بشرية لإمكانية الوصول. يفحص Preflight كثيرًا من المؤشرات المفيدة، لكنه لا يمنح شهادة مطابقة.
