# من arXiv إلى Typst

حوّل مصدر LaTeX لورقة بحثية من arXiv إلى Typst، مع فحص تجميع يسرد ما لم يُحوَّل.

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

## متى تستخدمه

- تريد بنية ورقة بحثية من arXiv بصيغة Typst؛
- أنت مؤلف ينقل تقديمه الخاص إلى Typst؛
- ترخيص الورقة البحثية يسمح بإعادة الاستخدام التي تنويها.

للإبقاء على الورقة بصيغة LaTeX، استخدم [arXiv to LaTeX](/docs/tools/arxiv-to-latex/). لا يمكن للورقة البحثية التي بلا حزمة مصدر أن تمر عبر هذا المسار. تعيد أداة [PDF to Typst](/docs/tools/pdf-to-typst/) بناء المصدر من ملف PDF بدلًا من ذلك.

## حوّل ورقة بحثية

1. افتح **arXiv to Typst**، أو شغّل `/arxiv-to-typst`.
2. ضمن **arXiv ID**، أدخل معرّفًا مثل `1706.03762`. للعمل دون اتصال، بدّل إلى **Saved archive** واختر أرشيف مصدر بصيغة `.tar.gz` أو `.tgz` أو `.gz`.
3. اختر **Convert**.
4. اقرأ الملاحظة أسفل النتيجة. تسمّي ملف LaTeX الرئيسي، وتقول هل جمّع Typst النتيجة أم لا، وتحصي العناصر التي لم تُحوَّل. تعطي القائمة أسفل الملاحظة كل خطأ من أخطاء Typst مع رقم سطره وكل عنصر لم يُحوَّل.
5. اختر **Save ZIP** للاحتفاظ بـ `main.typ` مع الملفات الأخرى للورقة البحثية، أو **Create project** لفتحه كمشروع Typst.

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

يعثر Oleafly على الملف الرئيسي ويجذب نصوص الملفات التي يحمّلها بأمر `\input` أو `\include` أو `\subfile` إليه. يحوّل Pandoc ذلك الـLaTeX إلى Typst بأقسام مرقّمة. تحتفظ الأشكال وملفات قوائم المراجع وغيرها من الملفات غير الخاصة بـ TeX في الأرشيف بمجلداتها بجوار `main.typ`، بحيث يظل الملف المحوّل قادرًا على العثور على صوره. يجمّع Typst بعد ذلك الملف المحوّل كفحص.

يؤدي البحث عن معرّف إلى تنزيل المصدر من arXiv ويحتاج إلى اتصال بالشبكة. أما الأرشيف المحفوظ فيُحوَّل كليًا على جهازك، باستخدام Pandoc المضمّن في Oleafly.

## ما يجب إصلاحه يدويًا

وحدات الماكرو المخصصة، والحزم التي لا مقابل لها في Typst، وصور TikZ، والجداول المعقدة، وأنماط قوائم المراجع هي البقايا المعتادة. اعمل على أخطاء Typst في القائمة أولًا، ثم قارن ملف PDF المجمَّع بالورقة البحثية قسمًا قسمًا. لا يستطيع Typst عرض أشكال EPS، لذا حوّلها إلى PDF أو PNG أو SVG.

:::caution[تحقق من الترخيص أولًا]
تحمل الأوراق البحثية على arXiv تراخيص مختلفة. تحقق من ترخيص الورقة البحثية وشروط المؤلفين قبل إعادة استخدام نصها أو أشكالها.
:::

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