تصدير المشروع وتحويله
احفظ أحدث ملف PDF، أو حزّم المصدر القابل للتحرير، أو صدّر صور الصفحات أو HTML، أو اكتب PDF/A وPDF/UA من Typst، أو حوّل مستند LaTeX أو Typst أو Markdown.
افتح Export في شريط أدوات المشروع. تتبع هذه القائمة محرك المستند الحالي ونوعه، لذا فهي لا تعرض إلا المسارات التي يستطيع Oleafly تشغيلها لهذا المشروع.

اختر المخرجات التي يحتاجها المستلم
قسم بعنوان “اختر المخرجات التي يحتاجها المستلم”- PDF للقراءة والطباعة ومعظم بوابات التقديم.
- Source ZIP للمؤلفين المشاركين أو للأنظمة التي تحتاج إلى المخطوطة والأشكال وقائمة المراجع والأنماط المحلية.
- Page PNG لشريحة أو رسالة أو نظام مراجعة يتوقع صورة.
- PNG أو SVG أو HTML يكتبه Typst لمشاريع Typst التي تحتاج إلى كل صفحة بوصفها صورة، أو صفحات متجهة، أو صفحة ويب.
- Word أو HTML أو Markdown أو Typst أو LaTeX أو نص عادي لمن يحتاج إلى تحرير المحتوى أو إعادة استخدامه بصيغة أخرى.
- PowerPoint لتحويل عرض تقديمي أو مستند Markdown إلى شرائح. وEPUB لقارئ الكتب الإلكترونية. وأي هذه الصيغ يظهر يعتمد على المحرك. انظر تصدير العروض والكتب.
احفظ ملف PDF أو أرشيف المصدر أو صورة صفحة
قسم بعنوان “احفظ ملف PDF أو أرشيف المصدر أو صورة صفحة”- اختر Recompile حتى يشمل المخرج آخر تعديلاتك.
- افحص ملف PDF، بما في ذلك الصفحات الأخيرة وقائمة المراجع.
- افتح Export.
- اختر Export as PDF أو Export source (.zip) أو Export page as PNG.
- حدد وجهة الحفظ في مربع حوار الحفظ.
- اختر Show in folder في رسالة الإتمام للوصول إلى الملف المحفوظ.
تبقى إجراءات PDF وصور الصفحات معطلة حتى يصبح للمشروع ملف PDF، وتقول القائمة PDF requires a compile first. يحفظ Export as PDF ملف PDF الظاهر في المعاينة. ويحفظ Export page as PNG الصفحة التي تنظر إليها في المعاينة، بدقة عالية.
يستبعد أرشيف المصدر مخابئ البناء ومكونات Git الداخلية. كما يترك الروابط الرمزية خارجه، وتذكر رسالة الإتمام عدد ما تخطاه.
حين لا يكون ملف PDF محدَّثًا
قسم بعنوان “حين لا يكون ملف PDF محدَّثًا”يظل Oleafly يحفظ ملف PDF أو صورة الصفحة حين تكون المعاينة قديمة، وتخبرك رسالة الإتمام بذلك:
- بعد تجميع فاشل، تقول إن آخر تجميع فشل، لذا قد يكون الملف ناقصًا.
- بعد تعديلات لم تجمّعها، تقول إن الملف من آخر تجميع ولا يتضمن آخر تعديلاتك.
أعد التجميع، وافحص المعاينة، وصدّر مرة أخرى قبل أن ترسل الملف إلى أي شخص.
صور Typst وHTML
قسم بعنوان “صور 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 الخاص بالمشروع. إذا كان للمشروع متغيرات بناء، فإن التصدير يستخدم المتغير المحدد في قائمة البناء.
PDF/A وPDF/UA من Typst
قسم بعنوان “PDF/A وPDF/UA من Typst”يكتب Typst بنفسه ملفات PDF الأرشيفية والداعمة لإمكانية الوصول. افتح الدرع في الشريط الجانبي للمشروع للوصول إلى 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.
حوّل مستندًا
قسم بعنوان “حوّل مستندًا”- ابنِ المستند مرة واحدة وأصلح أي أخطاء في المصدر.
- افتح Export واختر الصيغة الهدف.
- أكمل إعداد Pandoc إذا طلب منك ذلك. وإذا قال Oleafly إن Pandoc غير متاح، فاختر Repair Pandoc في Settings → Engines → Markdown، ثم صدّر مرة أخرى.
- احفظ الملف المحول بالامتداد المقترح.
- اقرأ رسالة الإتمام. وإذا ذكرت تحذيرات، فاختر Show warnings لترى ما تركه التصدير.
- افتح الملف في التطبيق الهدف وتحقق من بنيته ومظهره.
لاختبار سريع، صدّر قسمًا قصيرًا يحتوي على عنوان ومعادلة وجدول وصورة واستشهاد مرجعي. إذا نجت هذه العناصر الخمسة من التحويل، فحول المخطوطة كاملة وراجعها من جديد.
لتحويل مشروع LaTeX بأكمله إلى مشروع Typst تواصل العمل فيه، استخدم التحويل إلى مشروع 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 نوع المستند الخاص به. تصبح الشرائح والملصقات مصدر 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 أيضًا الخيار Save PDF to project. فهو يبقي نسخة للتقديم أو شكلًا مبنيًا بجوار المصدر. ولإبقاء تلك النسخة محدّثة، شغّل Sync PDF on compiles في القائمة نفسها، فيحدّث Oleafly ملف PDF باسم المشروع بعد كل تجميع ناجح. ويمكن حفظ ملف PDF أقدم من نقطة حفظ دون استعادة المشروع. ولا تضف ذلك الملف إلى سجل Git إلا إذا كنت تنوي تتبع إصدارات المخرجات المولدة.
تحقق قبل المشاركة
قسم بعنوان “تحقق قبل المشاركة”شغل Preflight قبل التقديم. وإذا احتجت إلى ملف PDF موسوم، فاتبع مسار التصدير الداعم لإمكانية الوصول في LaTeX أو اختر معيار PDF/UA في مشروع Typst، ثم تحقق من النتيجة بأداة فحص PDF/UA مستقلة ومراجعة بشرية لإمكانية الوصول. يفحص Preflight كثيرًا من المؤشرات المفيدة، لكنه لا يمنح شهادة مطابقة.