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

استورد أرشيف مشروع، أو حوّل مستندًا، أو أحضِر حزمة مصادر من arXiv، أو انسخ مستودع GitHub، أو حوّل مشروع LaTeX إلى مشروع Typst.

اختر **New project → Import a project**، أو استخدم **Import** في المكتبة. ينشئ Oleafly مشروعًا محليًا جديدًا ويترك الملف أو المستودع الأصلي دون تغيير. ما لم يجلب الاستيراد مستودع Git خاصًا به، تصبح الملفات المستوردة [أول إيداع في Git للمشروع](/docs/new-project/#the-first-git-commit)، وهو زر **Create project**.

![اختر Import project من مربع حوار المشروع الجديد للبدء بعمل قائم.](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

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

| ما لديك | مسار الاستيراد | المشروع الذي يمكنك إنشاؤه |
| --- | --- | --- |
| مجلد مشروع كامل | **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 بصيغته الأصلية، ابدأ مشروعًا فارغًا بتلك الصيغة وأضف الملف المصدر عبر [شجرة الملفات](/docs/files/#adding-existing-files).

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

استخدم ملف 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 التعامل معها، يُفتح مربع حوار المحرك لتختار غيره. انظر [تعيين افتراضي للمشاريع الجديدة](/docs/engines/#set-a-default-for-new-projects) و[عندما لا يكفي Tectonic](/docs/latex-engines/#when-tectonic-isnt-enough).

## تحويل 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](/docs/tools/arxiv-to-latex/) عندما تريد فحص أرشيف مصادر أو حفظه دون البدء في مربع حوار الاستيراد، و[arXiv إلى Typst](/docs/tools/arxiv-to-typst/) عندما تريد تحويل الورقة إلى Typst. يحتاج معرّف arXiv إلى اتصال بالشبكة؛ أما أرشيف المصادر الموجود على القرص فلا يحتاج.

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

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

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

ينشئ Oleafly نسخة محلية في المكتبة. تحقق من مستنده الرئيسي وشغّل عملية تجميع قبل التحرير. يشرح [مزامنة GitHub](/docs/github-sync/) عمليات السحب والإيداع ونشر التغييرات بعد الاستيراد.

## تحويل مشروع 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](/docs/typst/#convert-a-latex-project-to-typst) التحويل والتقرير بالتفصيل.

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

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

- [PDF إلى LaTeX](/docs/tools/pdf-to-latex/) لمشروع LaTeX أو أرشيف مصادر
- [PDF إلى Markdown](/docs/tools/pdf-to-markdown/) للحصول على Markdown قابل للتحرير
- [PDF إلى Typst](/docs/tools/pdf-to-typst/) للحصول على Typst قابل للتحرير

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

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

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

استورد BibTeX أو RIS أو EndNote XML أو Zotero RDF عبر [المراجع والاستشهادات](/docs/citations/#import-a-whole-reference-library). اربط مجلدًا من الأوراق أو البيانات كـ [سياق بحثي للقراءة فقط](/docs/linked-folders/) عندما ينبغي أن يبقى خارج المشروع.