# المحرر

اكتب باستخدام LaTeX وTypst وMarkdown مع تحرير المصدر والتحرير المرئي، وأدوات المستندات، وملف PDF بجانب مسودتك.

يجمع Oleafly تحرير المصدر والتنقل في المستند ومعاينة PDF في مساحة عمل واحدة. يدعم محرره المبني على CodeMirror كلًّا من LaTeX وTypst وMarkdown. أرقام الأسطر ومطابقة الأقواس وإبراز السطر النشط مفعّلة على الدوام. وتلتف الأسطر الطويلة تلقائيًا ما لم تُوقف خيار **Wrap long lines** في **Settings → Appearance → Editor**.

تعرض الاختصارات أدناه مفتاح macOS أولًا؛ وعلى Windows وLinux اقرأ ⌘ بمعنى Ctrl.

![مشروع LLaMA مفتوح في Oleafly: شجرة الملفات على اليسار، ومصدر LaTeX في الوسط، والورقة المجمعة على اليمين.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png)

## اختر دليل الكتابة الخاص بك

لكل محرك مستندات شريط أدوات خاص به وصيغة مصدر خاصة به. تشرح هذه الأدلة كل عنصر تحكم وتتضمن مخطوطة يمكنك لصقها وتجميعها:

| المحرك | ابدأ من هنا |
| --- | --- |
| LaTeX | [البنية والتنسيق والاستشهادات والأشكال والجداول والرياضيات والتنقل في الأكواد](/docs/writing/latex/) |
| Typst | [العناوين والقوائم والتنسيق والرياضيات والأشكال والاستشهادات والتسميات ومقاطع الأكواد](/docs/writing/typst/) |
| Markdown | [تحرير المصدر والتحرير المرئي وتنسيق Pandoc والروابط والصور والجداول](/docs/writing/markdown/) |

## شريط أدوات المحرر

تستخدم أشرطة الأدوات الثلاثة التخطيط نفسه:

- يأتي **Code / Visual** في المقدمة ويبدّل الملف المفتوح بين المصدر و[التحرير المرئي](#visual-editing).
- يليه زرّا **Undo** و**Redo**. يظهر كل منهما باللون الرمادي عندما لا يوجد شيء يمكن التراجع عنه أو إعادته.
- تملأ أزرار التنسيق والإدراج الجزء الأوسط. تنتقل الأزرار التي لا تتسع إلى **More formatting options** (`…`) مهما كان العرض، فلا يفقد المحرر الضيق عنصر تحكم أبدًا.
- تحتفظ النهاية اليمنى بأدوات المستندات ظاهرة: **LaTeX packages** أو **Typst packages** (انظر [Packages](/docs/packages/))، و[Document insights](/docs/document-insights/)، و[Document settings](/docs/document-settings/)، و**Project info**، و**Find**، و**Go to PDF**.

لا يوجد في Markdown زر للحزم. يمكنك أيضًا فتح هذه الأدوات من لوحة أوامر ⌘K: **Browse LaTeX packages** و**Browse Typst packages** و**Document insights** و**Document settings**.

## حافظ على موضعك

يُبقي السياق الملتصق القسم أو البيئة المحيطين ظاهرين أثناء التمرير. في ملفات Typst، تبقى العناوين الواقعة فوق المؤشر مثبتة بالطريقة نفسها. يمكنك إيقاف الميزة عبر خيار **Sticky scroll** في **Settings → Appearance → Editor**.

يعرض شريط مسار التنقل أعلى ملفات `.tex` و`.typ` اسم الملف والأقسام التي يقع فيها المؤشر. انقر عنصرًا من المسار للانتقال إلى ذلك العنوان. يساعدك مخطط المشروع على التنقل بين الفصول، بينما ينقلك التنقل عبر المراجع والاستشهادات إلى المصدر الكامن خلف الرمز. ويشمل [الإكمال التلقائي](/docs/autocomplete/) أوامر LaTeX المدركة للحزم وإدخال الرياضيات وتفاصيل الاستشهادات.

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

![تبديل التطبيق إلى السمة الداكنة، ثم إلى وضع Zen الذي لا يُبقي سوى المصدر وPDF.](https://cdn.oleafly.com/images/gifs/desktop/theme-zen.gif?v=2)

## وضع Zen

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

اضغط Ctrl+⌘⇧F على macOS أو Shift+F11 على Windows وLinux لتشغيله. يمكنك أيضًا اختيار **Zen Mode** من قائمة **Layout** في شريط أدوات المشروع أو من قائمة **View** في macOS، أو تشغيل **Toggle Zen Mode** من لوحة أوامر ⌘K. اضغط المفتاح نفسه مرة أخرى، أو Esc مرتين، للخروج.

في وضع Zen يستقر زر **Compile** في الزاوية العلوية اليمنى، فوق ملف PDF حين يكون مفتوحًا، ويظهر عندما تقترب مؤشرة الفأرة منه. تظهر أثناء البناء شارة صغيرة مكتوب عليها **Compiling**. وبعد بناء فاشل تعرض **Compile failed**، والنقر عليها يظهر سجل التجميع أو يخفيه. يظل ⌘↵ يجمع، ويعرض ⌘⌥P ملف PDF أو يخفيه دون مغادرة وضع Zen.

يوجد خياران ضمن [Settings → Appearance → Project](/docs/settings/appearance/#zen-mode-settings). يملأ الخيار **Go full screen** الشاشة أثناء تفعيل وضع Zen. ويفتح الخيار **Show the PDF when you compile** ملف PDF بجوار المحرر في كل مرة تجمع فيها وهو مخفي. يمكن تغيير المفتاح نفسه من **Settings → Keyboard Shortcuts**.

## السمات والألوان والخطوط

يستخدم المحرر سمة واحدة حين يكون التطبيق في الوضع الفاتح، وسمة أخرى حين يكون في الوضع الداكن. اختر كلتيهما، وغيّر لون أي جزء من المصدر، واختر خط المحرر وحجمه وارتفاع السطر والتباعد بين الأحرف وشكل المؤشر من [Settings → Appearance → Editor](/docs/settings/appearance/#editor-themes). ويحدد [خط CJK](/docs/settings/appearance/#cjk-font) المنفصل خط الأحرف الصينية واليابانية والكورية، فيمكن أن يبقى النص اللاتيني بخط برمجة. تتبع الألوان أدوارًا تحمل المعنى نفسه في LaTeX وTypst وMarkdown. في LaTeX، يستخدم أمر القسم وعنوانه معًا لون العناوين، وتأخذ مفاتيح الاستشهاد وأسماء البيئات لون أمرها، وتأتي الرياضيات بلون واحد. وتُبرز استشهادات Markdown مثل `[@key]` و`@key` بوصفها استشهادات لا روابط.

## البحث والاستبدال

اضغط ⌘F لفتح عنصر بحث على طراز VSCode في الزاوية العلوية اليمنى من المحرر:

- مفاتيح تبديل **Match case** (`Aa`)، و**whole word** (`ab`)، و**regular expression** (`.*`)
- عدّاد مطابقات حي (`3 of 41`) مع حالتَي `No results` و`Invalid`، وسقفه `2000+` للمستندات الضخمة
- ينقلك Enter إلى المطابقة التالية، وShift+Enter إلى السابقة، ويغلق Esc العنصر
- يحوّل **Select all matches** كل مطابقة إلى مؤشر للتحرير المتزامن
- يوسّع السهم الصغير صف **Replace**: استبدال المطابقة التالية، واستبدال الكل عبر **All**، ومفتاح تبديل **Preserve case** يطبّق حالة أحرف الكلمة الأصلية على البديل (فاستبدال `figure` بـ`image` يحوّل `Figure` إلى `Image` أيضًا)

يحدد ⌘A الملف كله، بما في ذلك الأسطر الخارجة عن نطاق العرض بسبب التمرير، فيشمل أي نسخ أو حذف بعده كل شيء.

## طي الأكواد

انقر السهم الموجود في شريط الأرقام الجانبي للطي.

- في LaTeX، تُطوى بيئة `\begin…\end` ككتلة واحدة (مع مراعاة التعشيش)، ويُطوى القسم حتى القسم التالي من المستوى نفسه أو الأعلى.
- في Typst، يُطوى العنوان حتى العنوان التالي من المستوى نفسه أو الأعلى. وتُطوى أيضًا مقاطع الأكواد داخل `{…}`، وكتل المحتوى داخل `[…]`، وقوائم الوسائط، والمعادلات، والكتل الخام، والتعليقات الكتلية.

اطوِ فصلًا أثناء تحريرك فصلًا لاحقًا.

## التعليق على الأسطر

اضغط ⌘/ للتعليق على السطر الحالي أو الأسطر المحددة أو إلغاء التعليق عنها. تحصل أسطر LaTeX على `%` وتحصل أسطر Typst على `//`. وخارج المحرر، يفتح المفتاح نفسه مرجع الاختصارات.

## المؤشرات المتعددة وتحديد الكتل

يدعم المحرر التحديدات المتعددة: السحب مع **Alt-drag** للحصول على تحديد مستطيل (عمودي)، و**Select all matches** في عنصر البحث للحصول على مؤشر عند كل مطابقة. تكتب المؤشرات جميعها وتحذف وتلصق في وقت واحد.

## المسافات البادئة والأقواس

يضيف المحرر المسافات البادئة أثناء كتابتك، أربع مسافات لكل مستوى ما لم تغيّر **Tab size** في **Settings → Appearance → Editor**. يضيف Tab مسافة بادئة، أو يقبل اقتراح الإكمال التلقائي المعروض حالًا. وتُغلق الأقواس وعلامات الاقتباس تلقائيًا، ويحذف مفتاح Backspace كلا عنصري الزوج معًا، ويُبرز القوس المطابق عند المؤشر.

## مساعدات الكتابة في Typst

تملك ملفات Typst بعض المساعدات الخاصة بها:

- اكتب `$` فيأتي معه `$` الإغلاق. اضغط Space داخل الزوج الفارغ لتحويله إلى رياضيات معروضة، `$ … $`. ويحذف Backspace داخل زوج فارغ العلامتين معًا.
- حدد نصًا واكتب `*` أو `_` أو `` ` `` أو `$` لتغليفه نصًا عريضًا أو مائلًا أو نصًا خامًا أو رياضيات.
- في عنصر قائمة، يبدأ Enter العنصر التالي بالعلامة نفسها (`-` أو `+` أو `/` أو رقم). يبدأ Shift+Enter سطرًا جديدًا داخل العنصر، ويحذف Backspace العلامة إذا ضُغط مباشرة بعد ظهورها فارغة. ويدفع Tab العنصر مستوى أعمق ويعيده Shift+Tab مستوى إلى الخارج.
- اكتب `/` في بداية سطر أو بعد مسافة لفتح مقاطع Typst الجاهزة: عنوان، وشكل، وشكل جدول، وجدول، ومعادلة، ومعادلة مرقمة، وحاشية سفلية، واقتباس، وكود، وفهرس، وقائمة مراجع، وفاصل صفحات، وأعمدة، وشبكة، ورابط، وأنواع القوائم الثلاثة.
- ينسّق ⇧⌥F (Shift+Alt+F) الملف باستخدام typstyle. فعّل **Format on save** ضمن **Typst** في **Settings → Appearance → Editor** للتنسيق في كل مرة تضغط فيها ⌘S. لا يعيد الحفظ التلقائي التنسيق أبدًا.

يحتاج إقران `$` إلى **Auto-close brackets** و**Auto-close math** معًا، ويحتاج تغليف تحديد إلى **Auto-close brackets**. كلا المفتاحين موجودان في **Settings → Appearance → Editor**. مفاتيح القوائم مفعّلة دائمًا. وتأتي ميزات الإكمال وإعادة التسمية والانتقال إلى التعريف والمساعدة بالتوقيع من خادم لغة Typst؛ انظر [الإكمال التلقائي](/docs/autocomplete/) و[ذكاء الكود](/docs/code-intelligence/).

## إدراج الأشكال والجداول والمراجع في Typst

يملك Typst أدوات الإدراج نفسها المتوفرة في LaTeX، وكل واحدة منها تكتب صيغة Typst. تجدها على شريط أدوات Typst وفي قائمة النقر بالزر الأيمن في المحرر:

- يفتح **Insert figure** مربع حوار الأشكال. اختر صورة من المشروع أو استورد واحدة، ثم عيّن عرضها وتعليقها وتسميتها ونصها البديل وموضعها. وحين يكون المؤشر داخل `#figure` موجود، يفتح الزر نفسه **Edit figure** لتتمكن من تغيير أي من ذلك.
- الصق ملف صورة في المحرر أو أفلته فيه. يحفظه Oleafly في `figures/` إذا كان المشروع يضم ذلك المجلد، أو بجوار المستند الرئيسي خلاف ذلك، ويدرج شكلًا يستخدمه.
- يضيف **Insert table** جدولًا فارغًا بالحجم الذي تختاره. وتستورد **Table from CSV/XLSX…** في قائمة النقر بالزر الأيمن ملف CSV أو TSV أو Excel أو JSON، مع تعليق وتسمية اختياريين. فعّل **Keep linked to the data file** فينسخ Oleafly البيانات إلى مجلد `data` في المشروع. يقرأ الجدول ذلك الملف عند كل تجميع، فعندما تحرر البيانات يتبعها الجدول.
- يكتب **Cite from project** أمر `@key` لإدخال في قائمة مراجع المشروع. وإذا لم يكن في المستند `#bibliography` بعد، يضيف Oleafly واحدة.
- يضع **Add label** تسمية على العنوان أو الشكل أو المعادلة الواقع عندها المؤشر، أو يحدد التسمية الموجودة أصلًا. ويعرض **Insert cross-reference** تسميات المشروع ويكتب `@label`.
- تدرج أزرار الرياضيات رياضيات مضمنة، أو معادلة معروضة، أو معادلة مرقمة بتسمية، أو معادلات متحاذية. وإذا لم يكن في المستند قاعدة لترقيم المعادلات، تقدم ملاحظة خيار **Add rule**.
- يدرج **Symbols** كل رمز تحت اسمه في Typst.

يغطي [الكتابة في Typst](/docs/writing/typst/) كل زر في شريط الأدوات.

## التحرير المرئي

يبدأ كل ملف من ملفات LaTeX وTypst وMarkdown بمفتاح تبديل **Code / Visual** في مقدمة شريط أدواته. تُفتح المشاريع الجديدة في وضع Code، ويتذكر كل مشروع الوضع الذي تركته عليه. ويملك Markdown أيضًا وضع **Both** الذي يعرض المصدر والنص المنسق مكدسين أو جنبًا إلى جنب.

في LaTeX وTypst، الوضع المرئي هو المحرر نفسه مع رسم الترميز في موضعه. ضع المؤشر في عنوان أو معادلة أو أمر فيعود مصدره في ذلك السطر. ابتعد عنه فيعود الشكل المعروض. ويبقى الملف هو النسخة الوحيدة، لذا تواصل أرقام الأسطر والطي والبحث والاستبدال والتدقيق الإملائي وأخطاء التجميع العمل. وكل زر في شريط الأدوات يكتب المصدر نفسه الذي يكتبه في وضع Code.

في ملف Typst، يعرض الوضع المرئي:

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

تنطوي أسطر `#set` و`#show` و`#import` و`#let` في أعلى ملف Typst إلى شريط **Show document settings**. انقره لتفتحها في موضعها. وتنطوي ديباجة LaTeX بالطريقة نفسها.

يناسب الوضع المرئي جولة لتحرير النص. بدّل إلى Code من أجل البنية أو الأوامر المخصصة. وأي شيء لا يستطيع الوضع المرئي رسمه يبقى على الشاشة مصدرًا قابلًا للتحرير.

## معاينة الرياضيات

مع وجود المؤشر داخل معادلة، تظهر النتيجة المعروضة فوقها مباشرة. يرسم KaTeX رياضيات LaTeX، ويرسم Typst رياضيات Typst. وتستطيع قائمة المعاينة إخفاءها إلى أن تغادر المعادلة، أو إيقافها تمامًا. ويعيد خيار **Math preview** في **Settings → Appearance → Editor** تشغيلها.

الصق رياضيات LaTeX في ملف Typst، مثل `$\frac{a}{b}$` أو بيئة `equation`، فيظهر زر **Paste as Typst math** تحتها. انقره لتستبدل ما لصقته برياضيات Typst، أو اضغط Esc للإبقاء على LaTeX. أما الرياضيات الموجودة سلفًا في الملف فحددها واختر **Convert LaTeX math to Typst** من قائمة النقر بالزر الأيمن.

## أخطاء التجميع في المصدر

بعد تجميع فاشل، يُسطر كل خطأ في الملف الذي ينتمي إليه. في Typst، يغطي التسطير المدى الدقيق الذي يبلغ عنه Typst، ويشير الخطأ الناشئ داخل حزمة إلى السطر في ملفك الذي استدعاه. مرر المؤشر فوق التسطير لقراءة الرسالة. وتأتي أخطاء Typst الشائعة، مثل اسم غير معروف أو ملف أو حزمة مفقودة أو قوس غير مغلق، مع شرح مباشر لما حدث وما ينبغي التحقق منه.

تعرض [لوحة السجلات](/docs/compiling/#reading-the-logs) كل خطأ مع سطر مصدره وتلميحات Typst.

## فاحص LaTeX المدمج

يفحص المحرر ملفات LaTeX بحثًا عن المشكلات البنيوية أثناء كتابتك، قبل أي تجميع:

- `\end{itemize}` دون `\begin` يقابله، أو أزواج غير متطابقة (`expected \end{figure}, got \end{table}`)
- بيئات غير مغلقة
- مفاتيح `\label{}` مكررة
- عدد فردي من علامات `$` في سطر (يكون الغالب محدد رياضيات منسيًا)

تأخذ الأخطاء خطوطًا متعرجة حمراء، والتحذيرات لونًا كهرمانيًا، مع علامات في شريط الأرقام. يقرأ الفاحص LaTeX فقط، لذا لا يوقف أبدًا تجميع Typst أو Markdown. وتظهر أخطاء التجميع من تشغيل LaTeX الفعلي على نحو منفصل في [لوحة السجلات](/docs/compiling/#reading-the-logs)، ويضيف [Preflight](/docs/preflight/) فحوصاته الخاصة على مستوى المصدر داخل المحرر.

## عدد الكلمات

شغل **Word count** من لوحة أوامر ⌘K لمعرفة عدد الكلمات والأحرف والأسطر في الملف النشط. تعد ملفات Typst وفق قواعد Typst، فتبقى الأكواد والتعليقات خارج الإجمالي.

## مفاتيح Vim وEmacs

اختر **Vim** أو **Emacs** ضمن **Keybindings** في **Settings → Appearance → Editor**، أو شغل **Enable vim mode** من لوحة أوامر ⌘K. يمنحك Vim كلًا من `hjkl` والمعاملات وكائنات النص (`dd` و`ciw`) و`:w` والوضع المرئي. يطبق التغيير فورًا، وتبقى اختصارات Oleafly الواردة في هذه الصفحة تعمل إلى جانبه.

## أكثر من .tex

تفتح الملفات مع إبراز يطابق امتدادها: BibTeX وMarkdown وJSON وYAML وTOML وCSS وسكربتات الصدفة وغيرها. وتفتح الصور وملفات PDF معروضة بدلًا من نص، وتحمى الصيغ الثنائية من التلف غير المقصود؛ انظر [الملفات والمجلدات](/docs/files/#how-different-file-types-open).

إذا تغير ملف على القرص بينما لديك فيه تعديلات غير محفوظة، يعرض شريط إشعار اسم الملف ويقدم الخيارات **Compare** و**Keep mine** و**Reload**. وتنطبق الميزة على ملفات LaTeX وTypst وMarkdown جميعها.

## صفحات ذات صلة

- [الإكمال التلقائي وأوامر الشرطة المائلة](/docs/autocomplete/): إكمال للأوامر والمراجع والاستشهادات وقائمة الإدراج `/`
- [ذكاء الكود](/docs/code-intelligence/): الانتقال إلى التعريف، وإعادة التسمية، وبطاقات التحويم، ومعاينة الرياضيات
- [التدقيق الإملائي والنحوي](/docs/spellcheck-grammar/): تدقيق Hunspell وHarper دون اتصال يفهم LaTeX
- [Packages](/docs/packages/) و[Document insights](/docs/document-insights/) و[Document settings](/docs/document-settings/): أدوات المستندات في الطرف الأيمن من شريط الأدوات
- [اختصارات لوحة المفاتيح](/docs/keyboard-shortcuts/): المرجع الكامل
- [التعديلات بالذكاء الاصطناعي داخل السطر](/docs/ai-inline-edit/): اضغط ⌘L على تحديد ثم اشرح التغيير المطلوب
