نقل أعمالك الحالية إلى Oleafly

اختر New project → Import a project، أو استخدم Import في المكتبة. ينشئ Oleafly مشروعًا محليًا جديدًا ويترك الملف أو المستودع الأصلي دون تغيير. ما لم يجلب الاستيراد مستودع Git خاصًا به، تصبح الملفات المستوردة أول إيداع في Git للمشروع، وهو زر Create project.

اختر Import project من مربع حوار المشروع الجديد للبدء بعمل قائم. فتح لقطة الشاشة كاملة

اختر المسار المطابق لمصدرك

ما لديك	مسار الاستيراد	المشروع الذي يمكنك إنشاؤه
مجلد مشروع كامل	Existing project (.zip)	المصدر المؤرشف والأشكال وقائمة المراجع وملفات الأنماط المحلية
مستند Word	Word document (.docx)	LaTeX أو Markdown أو Typst
مستند Markdown	Markdown document (.md, .markdown)	LaTeX أو Typst
مستند HTML	HTML page (.html, .htm)	LaTeX أو Markdown أو Typst
مستند Typst	Typst document (.typ)	LaTeX أو Markdown
ورقة من arXiv	arXiv paper بمعرّف أو رابط	حزمة مصادر LaTeX الخاصة بالورقة
مستودع GitHub	GitHub	مشروع محلي متصل بالمستودع
ملف PDF دون مصدر قابل للتحرير	Oleafly Tools → PDF converters	LaTeX أو Markdown أو Typst معاد بناؤه، حسب الأداة التي تختارها
مشروع LaTeX موجود بالفعل في Oleafly	Convert to a Typst project من لوحة الأوامر	مشروع Typst جديد، مع بقاء مشروع LaTeX كما كان

اختر صيغة التأليف نفسها فقط عندما يعرضها Oleafly. للاحتفاظ بملف Markdown أو Typst بصيغته الأصلية، ابدأ مشروعًا فارغًا بتلك الصيغة وأضف الملف المصدر عبر شجرة الملفات.

استيراد أرشيف مشروع كامل

استخدم ملف ZIP عندما تكون لديك بالفعل شجرة مصادر تعمل.

1. ضع المستند الرئيسي والأشكال وقائمة المراجع وملفات الفئات أو الأنماط المحلية في مجلد واحد. حافظ على المسارات النسبية التي يستخدمها المصدر.
2. اضغط المجلد في ملف .zip.
3. اختر Import → Existing project وحدد ملف ZIP.
4. تحقق من المستند الرئيسي المعلَّم بنجمة في شجرة الملفات المستوردة.
5. جمّع المشروع. إذا احتاج المشروع إلى سلسلة أدوات LaTeX مختلفة، فاخترها من قائمة المُجمِّع.

على سبيل المثال، أبقِ main.tex وreferences.bib وsections/method.tex وfigures/plot.pdf معًا. يحفظ ملف ZIP للمصادر تلك العلاقات. أما ملف PDF فلا يحتوي على بنية المشروع القابلة للتحرير نفسها.

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

أي مُجمِّع LaTeX يستخدمه الاستيراد

يبدأ مشروع LaTeX المستورد أو المحوَّل بمحرك التجميع الافتراضي من Settings → Engines → LaTeX، وهو Tectonic ما لم تغيّره. عندما يكون هذا الافتراضي هو latexmk ويسمّي المشروع pdfLaTeX أو XeLaTeX أو LuaLaTeX، فإنه يحتفظ بذلك المُجمِّع. إذا وجد الاستيراد ميزات لا يستطيع Tectonic التعامل معها، يُفتح مربع حوار المحرك لتختار غيره. انظر تعيين افتراضي للمشاريع الجديدة وعندما لا يكفي Tectonic.

تحويل Word أو Markdown أو HTML أو Typst

1. اختر نوع المستند المطابق في Import.
2. حدد الملف.
3. إذا عرض Oleafly أكثر من وجهة، فاختر الصيغة التي تريد تحريرها بعد ذلك. تُعلَّم LaTeX بوصفها المسار الموصى به.
4. أكمل إعداد Pandoc إذا طُلب منك. يستطيع Oleafly استخدام تثبيت متوافق أو تنزيل نسخته المُدارة.
5. افتح المشروع الجديد، وجمّعه، وقارنه بالأصل.

تعمل التحويلات محليًا عبر Pandoc. يستخرج استيراد Word أو HTML أيضًا الوسائط المضمّنة إلى المشروع كي يستطيع المصدر المحوَّل الإشارة إليها. يحتفظ مستند Markdown المستورد إلى مشروع LaTeX باستشهاداته: يصبح [@key] هو \citep أو \citet، ويأتي ملف قائمة المراجع معه، بحيث تعرض لوحة References مصادرك من البداية.

اختر الوجهة المناسبة للعمل القادم:

• يناسب LaTeX قوالب المجلات والتنضيد التفصيلي ومسارات PDF الموسوم.
• يناسب Markdown صيغة مصدر أخف وتحويلًا واسع النطاق للمستندات.
• يناسب Typst التجميع السريع والقوالب الأصلية لـ Typst.

يحافظ التحويل على بنية المستند حيثما تكشف عنها صيغة المصدر. قد تظل تخطيطات صفحات Word الخاصة، وتنسيق HTML المخصص، والجداول المضبوطة يدويًا، والاستشهادات، والمعادلات المعقدة بحاجة إلى جولة تنظيف. قارن العناوين والقوائم والجداول والمعادلات والروابط والاستشهادات ومواضع الصور قبل حذف الأصل.

استيراد حزمة مصادر من arXiv

اختر arXiv paper، ثم ألصق معرّفًا مثل 2401.01234 أو رابط arxiv.org/abs/.... ينزّل Oleafly حزمة المصادر المُرسَلة ويفتحها كمشروع LaTeX.

استخدم هذا المسار عندما تحتاج إلى المصدر القابل للتحرير لدى المؤلفين. استخدم arXiv إلى LaTeX عندما تريد فحص أرشيف مصادر أو حفظه دون البدء في مربع حوار الاستيراد، وarXiv إلى Typst عندما تريد تحويل الورقة إلى Typst. يحتاج معرّف arXiv إلى اتصال بالشبكة؛ أما أرشيف المصادر الموجود على القرص فلا يحتاج.

تحقق دائمًا من الترخيص وشروط المؤلفين قبل إعادة استخدام المصدر أو الأشكال.

الاستيراد من GitHub

اختر GitHub في مربع حوار الاستيراد. إذا لزم الأمر، اربط حسابك عبر Settings → Integrations → GitHub، ثم حدد مستودعًا يمكنك الوصول إليه.

ينشئ Oleafly نسخة محلية في المكتبة. تحقق من مستنده الرئيسي وشغّل عملية تجميع قبل التحرير. يشرح مزامنة GitHub عمليات السحب والإيداع ونشر التغييرات بعد الاستيراد.

تحويل مشروع LaTeX إلى Typst

يستطيع Oleafly إنشاء نسخة Typst من مشروع LaTeX لديك بالفعل. لا يتغير مشروع LaTeX.

1. افتح مشروع LaTeX.
2. افتح لوحة الأوامر ⌘K (Ctrl+K) ونفِّذ Convert to a Typst project.
3. تحقق من New project name. يكون الاسم الافتراضي هو اسم المشروع متبوعًا بـ (Typst).
4. اختر Convert. يحوّل Oleafly المشروع بـ Pandoc، وينشئ مشروع Typst، ويجمّعه مرة واحدة للتحقق.
5. اقرأ التقرير، ثم اختر Open the Typst project.

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

إعادة بناء ملف PDF

فعِّل LaTeX tools في Settings → Experimentation، ثم اختر الأداة المطابقة للمخرجات التي تحتاجها:

• PDF إلى LaTeX لمشروع LaTeX أو أرشيف مصادر
• PDF إلى Markdown للحصول على Markdown قابل للتحرير
• PDF إلى Typst للحصول على Typst قابل للتحرير

يقرأ مسار PDF المحلي طبقة النص، ويعيد ترتيب القراءة، ويستخرج الأشكال. في PDF to LaTeX، بدِّل إلى وضع المستندات الممسوحة ضوئيًا عندما يتكون ملف PDF من صور للصفحات. يستخدم هذا المسار نموذج Tools، وهو نموذج Ollama محلي ما لم تختر غيره، ويدعم المستندات حتى 50 صفحة.

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

إضافة مراجع دون استيراد مخطوطة

استورد BibTeX أو RIS أو EndNote XML أو Zotero RDF عبر المراجع والاستشهادات. اربط مجلدًا من الأوراق أو البيانات كـ سياق بحثي للقراءة فقط عندما ينبغي أن يبقى خارج المشروع.