اختيار محرك مستندات

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

يُجمَّع LaTeX بـ Tectonic أو latexmk، وTypst بالإصدار الذي يثبّته المشروع. ويمر Markdown عبر Pandoc أولًا، ثم Tectonic.

اختر لغة

عملك	ابدأ بـ	كيف يصبح PDF
تسليم إلى مجلة، أو فئة أطروحة راسخة، أو مشروع .tex قائم	LaTeX	Tectonic، أو مجمّع يعمل عبر latexmk
ورقة بحثية جديدة، أو تقرير، أو سيرة ذاتية، بتركيب نص موجز	Typst	نسخة Typst 0.15.1 المدمجة، أو نسخة Typst أخرى يقيّدها المشروع
مسودة نثرية، أو ملاحظات، أو مستند تريد تصديره إلى عدة صيغ	Markdown	يحوّل Pandoc المصدر إلى LaTeX؛ وينتج Tectonic ملف PDF
تقرير تحليلي أو مقال أو عرض شرائح تنتج نتائجه شيفرة R أو Python أو Julia	Quarto	يحوّل Quarto ملفات .qmd أو .Rmd إلى PDF أو صفحة ويب أو شرائح
مستند Typst يحتوي على مقاطع شيفرة	Calepin	يشغّل Calepin الشيفرة، ثم تبني نسخة Typst المدمجة ملف PDF

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

Tectonic

استخدم Tectonic لإعداد LaTeX مباشر. يأتي مع Oleafly، وينزّل حزم TeX التي يحتاجها البناء، ويخزّنها مؤقتًا لبناءات لاحقة. ابدأ هنا عندما لا يتطلب قالبك مجمّعًا بعينه.

جمّع مرة واحدة أثناء الاتصال قبل السفر. يستطيع المشروع المخزَّن مؤقتًا التجميع دون اتصال؛ وقد تبقى حزمة جديدة بحاجة إلى تنزيل. فعّل Settings → General → Offline mode لإخبار Tectonic باستخدام ذاكرته المؤقتة.

pdfLaTeX

اختر pdfLaTeX عندما تفرضه جهة نشر أو يحدده مشروع قائم. يتبع سير عمل LaTeX التقليدي وهو خيار مناسب للفئات القديمة وتوليفات الحزم. ويحتاج توزيعة TeX مثبَّتًا فيها latexmk.

XeLaTeX

اختر XeLaTeX لمشروع يطلبه، خصوصًا مشروع يستخدم fontspec أو خطوط OpenType أو نصوصًا متعددة اللغات. تأكد من أن الخطوط التي يسمّيها المصدر مثبَّتة أو مضمّنة في المشروع. وهو يعمل أيضًا عبر latexmk.

LuaLaTeX

اختر LuaLaTeX لقالب يتطلبه، أو لتركيب نص قائم على Lua، أو لسير عمل PDF الموسوم في Oleafly. تحمل ملفات PDF الموسومة بنية مستند تستطيع التقنيات المساعدة استخدامها. شغّل فحوص Preflight لمعاينة النتيجة؛ فاختيار المجمّع وحده لا يضمن جودة الوسوم.

Typst

يأتي Oleafly مزودًا بـTypst 0.15.1. أنشئ مشروع Typst، واكتب في ملفات .typ، وانقر Recompile. لا يوجد تثبيت TeX يتطلب الإعداد.

يستطيع Settings → Engines → Typst أيضًا تثبيت Typst من 0.11 إلى 0.15 واستخدام نسخة Typst مثبَّتة سلفًا على حاسوبك. يقيّد كل مشروع نسخته الخاصة، فتحافظ الورقة البحثية على تنسيقها عندما ينتقل Oleafly إلى نسخة Typst أحدث. وينزّل Typst الحزم من Typst Universe في المرة الأولى التي يستوردها فيها مستند، ويقصره Offline mode على الحزم المخزَّنة مؤقتًا سلفًا أو المحفوظة في المشروع.

لدى Typst تركيبه النحوي وحزمه ومعالجة خطوطه الخاصة. يغطي مشاريع Typst الإصدارات والحزم والخطوط ومتغيرات البناء. ويحتوي دليل الكتابة بـTypst على مستند بدء كامل وعلى عناصر تحكم شريط الأدوات.

Markdown

يستخدم Markdown برنامج Pandoc لتجهيز مستند منسَّق وTectonic لبناء PDF الخاص به. افتح Settings → Engines → Markdown لتثبيت Pandoc عند غيابه. ثم افتح مشروع Markdown وجمّعه.

استخدم الكتابة بـMarkdown للعناوين والقوائم والرياضيات والمحرر المرئي. ويشرح دليل التصدير صيغ الإخراج التي يوفرها المشروع.

Quarto

يحوّل Quarto مستندات .qmd و.Rmd إلى PDF أو صفحة ويب أو شرائح. يستخدم Oleafly نسخة Quarto الموجودة على حاسوبك عندما يجدها. وإن لم توجد، فافتح Settings → Engines → Quarto وحدد Download Quarto 1.10.19. ويعرض الزر أيضًا حجم التنزيل. يتحقق Oleafly من التنزيل قبل فك ضغطه، ويحتفظ بالنسخة في مجلد التطبيق الخاص به. وإذا جمّعت قبل أن يتوفر Quarto، فستعرض المعاينة تثبيته في الحال، أو Open engine settings.

أول صيغة يعلنها المستند تحدد ما تحصل عليه:

• pdf وtypst وbeamer تبني PDF. ولا تحتاج format: typst إلى تثبيت TeX. أما pdf وbeamer فتمرّان عبر LaTeX، لذا ثبّت TinyTeX من Settings → Engines → LaTeX إن لم يكن لديك TeX بعد.
• html وrevealjs وdashboard تبني صفحة ويب. حدد Open in browser في المعاينة لرؤيتها.

عندما لا يعلن المستند أي صيغة، يبحث Oleafly عن صيغة في _quarto.yml أو _metadata.yml، في مجلد المستند والمجلدات التي فوقه حتى جذر المشروع. وإذا لم توجد صيغة في أي مكان، يبني Quarto صفحة ويب. وملف .Rmd الذي يسمّي output: من R Markdown، مثل pdf_document، يحصل على صيغة Quarto المقابلة.

تعمل الشيفرة في R أو Python أو Julia الموجودة بالفعل على حاسوبك. ولا يثبّتها Oleafly أبدًا، ويعرض Languages في علامة تبويب الإعدادات نفسها ما وجده منها. وتحتاج شيفرة Python أيضًا إلى Jupyter في نسخة Python تلك. ويوفر التصدير DOCX وHTML، وكلاهما من إنتاج Quarto. وفي مربع حوار New project قالبان لـ Quarto: Quarto article، وهو PDF يُبنى عبر Typst، وQuarto slides، وهو عرض شرائح reveal.js.

Calepin

يشغّل Calepin الشيفرة في مستند Typst ويضع النتائج في ملف PDF. مستند Calepin هو ملف .typ يستورد /.calepin/calepin.typ. ابدأ مستندًا من القالب Calepin report، أو افتح السهم بجانب Recompile في مشروع Typst واختر Calepin ضمن Engine (this project).

ثبّته من Settings → Engines → Calepin بالطريقة نفسها التي تثبّت بها Quarto، عبر Download Calepin 0.0.61. يبني Calepin بنسخة Typst التي تأتي مع Oleafly. والمقطع الذي لم تُثبَّت لغته يعرض ملاحظة قصيرة، ويُبنى باقي المستند رغم ذلك. ويوفر التصدير HTML، من إنتاج Calepin.

السماح بالشيفرة في مشروع

تعمل الشيفرة في مستند Quarto أو Calepin بصلاحياتك، لذا تبقى معطّلة في كل مشروع حتى تسمح بها. بعد تجميع احتاج إلى شيفرة، يقول شريط أعلى المحرر إن الشيفرة معطّلة ويعرض Allow code in this project. ويمكنك أيضًا فتح السهم بجانب Recompile واختيار Run code on this computer ضمن Code (this computer). ويعيد Off تعطيلها. لا تسمح بالشيفرة إلا إذا كنت تثق بكل ملف في المشروع.

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

أثناء تعطيل الشيفرة:

• يعرض Quarto شيفرة كل مقطع دون تشغيلها. لكن المرشحات والرموز المختصرة (shortcodes) و_extensions والبرامج النصية التي تعمل قبل العرض وبعده وشيفرة R المضمّنة في السطر تشغّل شيفرة حتى في هذه الحالة، لذا فإن المستند الذي يستخدمها لا يُجمَّع حتى تسمح بالشيفرة.
• لا يستطيع Calepin تخطي الشيفرة. يبني Oleafly ملف PDF عبر Typst وحده من النتائج التي خزّنها Calepin آخر مرة عمل فيها. وإن لم توجد نتائج، يتوقف التجميع ويطلب منك السماح بالشيفرة.

والمجلد الذي تفتحه في مكانه يجب أن يكون موثوقًا أيضًا قبل أن يستطيع Quarto أو Calepin تجميعه. ولا تتوفر المزامنة بين المصدر وملف PDF لأي من المحركين.

تعيين افتراضي للمشاريع الجديدة

افتح Settings → Engines → LaTeX واختر Default compile engine: Tectonic (built in) أو latexmk (system TeX). كل مشروع LaTeX تنشئه بعد ذلك يبدأ عليه:

• مشروع فارغ أو قالب من مربع حوار New project، ومشروع بحثي.
• ملف ZIP أو مجلد أو ورقة arXiv أو مستودع GitHub مستورد.
• مستند تحوّله إلى مشروع LaTeX، مثل ملف Word أو ملف PDF.

يُكتب المحرك في project.json الخاص بالمشروع، فيجمّعه المؤلف المشارك الذي يفتحه بالطريقة نفسها. والمشروع المستورد الذي يسمّي pdfLaTeX أو XeLaTeX أو LuaLaTeX يحتفظ بذلك المجمّع عندما يصل إلى latexmk. ويبقى المجمّع المحفوظ لمشروع قائم اختيارًا خاصًا به.

المجلد الذي تفتحه في مكانه بلا محرك خاص به يتبع الافتراضي متى وثقت به. وحتى ذلك الحين يُعرض ويُجمَّع على Tectonic. ولا يكتب Oleafly شيئًا في المجلد في الحالتين.

لـTypst، افتح Settings → Engines → Typst واختر النسخة الافتراضية. تقيّد مشاريع Typst الجديدة النسخة التي تكون هي الافتراضية عند إنشائها. وتغيير الافتراضي لاحقًا لا ينقل المشاريع القائمة.

تغيير مجمّع المشروع الحالي

افتح السهم بجانب Recompile في شريط أدوات المشروع. في مشروع LaTeX، اختر Tectonic أو Auto أو pdfLaTeX أو XeLaTeX أو LuaLaTeX ضمن Compiler (this project)، ثم جمّع. اقرأ السجل إذا احتاج قالب إلى حزمة أو خط لا يوفره التثبيت المحدد.

في مشروع Typst، تحمل القائمة نفسها Typst version (this project) بدلًا منه. اختر نسخة مثبَّتة، أو Default لتتبع Settings. وتبدّل مجموعة Engine (this project) فيها المستند بين Typst وCalepin.

كشف توزيعة TeX قائمة

افتح Settings → Engines → LaTeX وراجع سلسلة الأدوات المكتشفة. يتحقق Oleafly من إعداد مجمّعات كامل يشمل latexmk والأدوات المساندة. ولا تتقدم التثبيتات النظامية الجزئية على تثبيت مُدار يعمل.

تثبيت TinyTeX المُدار

استخدم عنصر التحكم بالتثبيت في إعدادات محرك LaTeX إذا احتجت إلى مجمّع تقليدي ولم يكن لديك واحد. ينزّل Oleafly تثبيت TinyTeX الخاص به تحت ~/.oleafly/tinytex؛ ولا يلزم وصول المسؤول. خصص نحو 250 ميغابايت للتنزيل الأولي ومساحة إضافية للحزم.

إدارة الحزم

تتيح قائمة الحزم في إعدادات محرك LaTeX ترشيح الحزم وفحص أوصافها وإضافتها أو إزالتها. تحدد شارات الوسم الحزم التي تحتاج عناية إضافية عند إنتاج PDF موسوم. وتدير عناصر التحكم هذه توزيعة TeX التي يستخدمها latexmk؛ ولدى Tectonic ذاكرة تخزين مؤقت منفصلة.

اقرأ دليل حزم LaTeX وPDF الموسوم ←