# مزامنة المصدر مع PDF

انتقل من المؤشر إلى الموضع المقابل في PDF، أو انقر PDF مع Cmd/Ctrl لتصل إلى تلك الكلمة في المصدر. يعمل في LaTeX عبر SyncTeX وفي Typst، عبر الملفات.

تربط مزامنة المصدر مع PDF ما تكتبه بالصفحة المصفوفة. في LaTeX تعمل عبر SyncTeX: يجمع Oleafly مع تفعيل بيانات SyncTeX في كل بناء. وفي Typst تعمل عبر خادم لغة Typst، فتعمل القفزات نفسها دون أي إعداد إضافي. وكلا الاتجاهين على بُعد إيماءة واحدة.

## من المصدر إلى PDF: ⌘⇧J

![زر Go to PDF هو السهم الواقع في أقصى يمين شريط أدوات المحرر، بجوار Find وProject info.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=1799,76,119,49)

ضع مؤشرك على أي سطر واضغط ⌘⇧J (Ctrl+Shift+J). ينتقل ملف PDF بالتمرير إلى الموضع المقابل ويومض بإبراز أزرق فوقه لوهلة، فتقع عينك تمامًا حيث كان مؤشرك.

يمكنك أيضًا استخدام السهم في أقصى يمين شريط أدوات المحرر، أو قائمة النقر بالزر الأيمن في المحرر، أو لوحة أوامر ⌘K. تسمي مشاريع LaTeX الأمر **Go to PDF (SyncTeX)**. وتسميه مشاريع Typst **Go to PDF**.

يعمل ذلك عبر المشاريع متعددة الملفات. يجد المؤشر داخل `chapters/methods.tex` موضعَه المصفوف في ملف PDF المجمّع، لأن SyncTeX يتبع بنية `\input` لديك. ويفعل Typst الشيء نفسه مع الملفات التي يضمّنها المستند الرئيسي.

![النقر على كلمة في PDF ينقل إلى الكلمة نفسها في المصدر.](https://cdn.oleafly.com/images/gifs/desktop/pdf-to-source.gif?v=2)

## من PDF إلى المصدر: النقر مع ⌘

اضغط باستمرار على **⌘** أو Ctrl فيتحول المؤشر فوق PDF إلى شعيرات تصويب. انقر كلمة لتقفز إليها في المحرر. يفتح Oleafly الملف الصحيح أولًا عندما يكون النص قادمًا من ملف آخر، مثل ملف تابع لـ`\input` في LaTeX أو ملف `.typ` مضمّن.

يضع Oleafly المؤشر على الكلمة التي نقرتها لا عند بداية السطر. في LaTeX يقرأ طبقة النص في ملف PDF للعثور على تلك الكلمة. أما Typst فيبلّغ عن الموضع بنفسه.

قاعدة أسبقية واحدة: النقر مع ⌘ على رابط تشعّبي في PDF يتبع سلوك الرابط بدلًا من القفز.

## مشاريع Typst

تحتاج مزامنة Typst إلى Typst 0.13 أو أحدث. يجمع المشروع المثبَّت على Typst 0.11 أو 0.12 بشكل طبيعي، لكن زر Go to PDF يكون مخفيًا ولا يفعل النقر مع ⌘ شيئًا. لاستعادة المزامنة، ثبّت إصدارًا أحدث ضمن **Typst version (this project)** في قائمة التجميع. ابدأ بـ[تجربة إصدار أحدث](/docs/typst/#try-a-newer-version-before-switching) أولًا إذا كان تنسيق المستند مهمًا.

## عندما لا يفعل القفز شيئًا

تأتي بيانات المزامنة من آخر تجميع، لذا قد تصبح قديمة:

- **عدّلت منذ آخر بناء.** يظل Oleafly يطابق الأسطر غير المعدلة بدقة والأسطر المعدلة مع أقرب سطر غير معدل، فتواصل معظم القفزات العمل. إذا هبط قفز في الموضع الخطأ، أعد التجميع (⌘↵) وقفز مرة أخرى.
- **السطر لا ينتج مخرجات مرئية** (تعليق، أو سطر ديباجة، أو قاعدة `#set`، أو سطر فارغ). ضع المؤشر على سطر يحتوي على نص مصفوف.

## حيث لا ينطبق ذلك

- تعكس [نافذة المعاينة المنفصلة](/docs/pdf-preview/#open-preview-in-a-new-window) ملف PDF لكنها لا تقبل النقر مع ⌘. قفز من النافذة الرئيسية.
- لا توجد مزامنة بين المصدر وPDF في مشاريع Markdown.
- تتخطاها مشاريع الصور والمخططات، لأن الشكل ذا الصفحة الواحدة لا يحتاج إليها.
