# إعدادات المستند

غيّر حجم الورقة والهوامش والخط واللغة وتباعد الأسطر والترقيم في مربع حوار يحرر ديباجة LaTeX أو قواعد set في Typst أو مقدمة الملف في Markdown.

تحتفظ كل لغة بإعداد صفحتها في مكان مختلف: خيارات الصنف وأوامر الديباجة في LaTeX، وقواعد `#set` في Typst، ومقدمة الملف في Markdown. يمنحك **Document settings** نموذجًا واحدًا لكل ذلك. وعندما تطبقه، يكتب Oleafly التغيير في ملفك الرئيسي كمصدر عادي يمكنك قراءته وتحريره لاحقًا.

افتحه بزر **Document settings** في الطرف الأيمن من شريط أدوات المحرر، أو شغّل **Document settings** من لوحة ⌘K (Ctrl+K). يحرر مربع الحوار دائمًا المستند الرئيسي للمشروع، أيًّا كان الملف المفتوح لديك.

## الحقول

يتألف النموذج من أربعة أقسام. وتعتمد الحقول على المحرك:

| القسم | LaTeX | Typst | Markdown |
| --- | --- | --- | --- |
| الصفحة | حجم الصفحة، الأعمدة، الهوامش | حجم الصفحة، الهوامش، الأعمدة | نوع المستند، صنف المستند، حجم الصفحة، الأعمدة، الهوامش |
| النص | خط المتن، حجم الخط، اللغة | خط المتن، حجم الخط، اللغة، المنطقة | خط المتن، حجم الخط، اللغة |
| الفقرة | تباعد الأسطر | الضبط، تباعد الأسطر | تباعد الأسطر |
| الترقيم | المستويات المرقمة، ترقيم المعادلات | ترقيم العناوين، ترقيم المعادلات | أرقام الأقسام |

تبدأ القوائم بـ**Default**، وهو يزيل الإعداد حتى يعود الافتراضي للصنف أو القالب أو المحرك. واترك حقل نص فارغًا للحصول على التأثير نفسه. وتقبل الأطوال وحدات مثل `2.5cm` و`1in` و`11pt`، وتقبل هوامش Typst كذلك `auto`. والقيمة التي لا يستطيع Oleafly استخدامها تظهر تحتها ملاحظة قصيرة، وينتظر **Apply** حتى تصلحها.

يقترح **Body font** الخطوط أثناء كتابتك. في مشاريع Typst، تحوي القائمة كل خط يستطيع Typst العثور عليه وتذكر مصدر كل خط: مجلد `fonts` في المشروع، أو الحاسوب، أو مجموعة Typst المدمجة. وفي مشاريع LaTeX وMarkdown، تعرض الخطوط المثبتة على الحاسوب.

اختر **Apply** لكتابة التغييرات، أو **Cancel** لترك الملف وشأنه. وعندما يكون الملف الرئيسي مفتوحًا في المحرر، تراجع ضغطة ⌘Z (Ctrl+Z) واحدة التغيير كله.

## إلى أين تذهب القيم

### LaTeX

- تصبح **Page size** و**Columns** و**Font size** خيارات لـ`\documentclass`.
- تذهب **Margins** إلى حزمة geometry. يحرر Oleafly أمر `\geometry{…}` أو خيار geometry موجودًا، أو يضيف `\usepackage[margin=…]{geometry}`.
- يكتب **Body font** الأمر `\setmainfont{…}` ويحمّل fontspec. وهو يحتاج في مشروع latexmk إلى مجمّع XeLaTeX أو LuaLaTeX، ويذكر الحقل ذلك حتى تختار أحدهما في قائمة التجميع أو يطلب المستند أحدهما، مثلًا بسطر `% !TeX program = xelatex`.
- تضيف **Language** اللغة إلى babel، وتستخدم `\setdefaultlanguage` عندما يحمّل المستند polyglossia، أو تضيف `\usepackage[language]{babel}`. استخدم أسماء babel مثل `english`.
- يكون **Line spacing** إما **Single** أو **One and a half** أو **Double** أو رقمًا مثل `1.5`. ويستخدم حزمة setspace، أو `\linespread` إذا كان المستند يستخدمها فعلًا.
- يضبط **Numbered levels** القيمة `secnumdepth`. اختر **None**، أو **Chapters only**، أو عمق الترقيم، من **Down to sections** إلى **Down to subparagraphs**.
- يكتب **Equation numbering** الأمر `\numberwithin{equation}{…}` من أجل **By section** أو **By chapter** أو **By subsection**.

### Typst

تذهب القيم إلى قواعد `#set` في الملف الرئيسي. وعندما تكون إحدى القواعد مفقودة، يضيفها Oleafly قرب الأعلى:

- `#set page(paper: …, margin: …, columns: …)`
- `#set text(font: …, size: …, lang: …, region: …)`
- `#set par(justify: …, leading: …)`، حيث يكون **Justification** إما **Justified** أو **Ragged right**
- `#set heading(numbering: …)`، بأنماط مثل `1.` و`1.1` و`1.a` و`I.` أو `A.`
- `#set math.equation(numbering: …)`، بالصيغ `(1)` أو `(1.1)` أو `1`

يقبل **Language** رمزًا من حرفين أو ثلاثة مثل `en`، ويقبل **Region** رمزًا من حرفين مثل `GB`.

تحصل مشاريع Typst أيضًا على قسم **Build variants**. كل متغير مجموعة قيم مسماة يقرؤها المستند بـ`sys.inputs`، مثل نسخة مسودة ونسخة نهائية للتقديم. استخدم **Add variant**، وسمّه، ثم أضف كل قيمة بـ**Add value**. واختر المتغير الذي يُبنى من **Variant (this project)** في قائمة التجميع.

### Markdown

تذهب القيم إلى مقدمة YAML التي يقرأها Pandoc عند بناء ملف PDF: `type` و`documentclass` و`papersize` و`classoption` للأعمدة و`geometry` للهوامش و`mainfont` و`fontsize` و`lang` و`linestretch` و`numbersections`. ويعرض **Document type** الخيارات **Article** و**Report or thesis** و**Book** و**Slides** و**Poster** و**Letter** و**CV**، ويحدد ما يُبنى المستند إليه. انظر [أنواع المستندات](/docs/writing/markdown/#document-types). ويعرض **Document class** الخيارات `article` و`report` و`book` و`scrartcl` و`scrreprt` و`memoir`. ويقبل **Language** وسمًا مثل `en-US`.

حيث لم تضبط خطًا، يختار Oleafly خطًا لكل نظام كتابة في المستند، مثل الكورية أو العربية أو الديفاناغاري. ويحدد **Language** أيضًا أي خط تحصل عليه الأحرف الصينية: `ja` يعطي الخط الياباني، و`zh` الصينية المبسطة، و`zh-TW` الصينية التقليدية. انظر [النص بلغات أخرى](/docs/writing/markdown/#text-in-other-languages).

إذا لم تكن للملف مقدمة بعد، يذكر مربع الحوار ذلك، ويضيف **Apply** كتلة في الأعلى. والمقدمة التي تفتقر إلى سطر إغلاق `---` يجب إصلاحها يدويًا أولًا.

## الحقول للقراءة فقط

بعض القيم يملكها شيء آخر، ويعرضها مربع الحوار باللون الرمادي مع السبب تحتها:

- **Set by the … class**: الأصناف مثل `acmart` و`IEEEtran` و`llncs` و`beamer` تثبّت هوامشها بنفسها، وبعضها يثبّت أيضًا حجم الصفحة أو حجم الخط أو الأعمدة أو تباعد الأسطر أو اللغة. وتذكر ملاحظة أعلى مربع الحوار اسم الصنف.
- **Set by the … style**: حزم أنماط المؤتمرات، مثل حزم NeurIPS وICML وICLR وCVPR وACL، تضبط حجم الصفحة والهوامش. وتقول ملاحظة أعلى مربع الحوار أي نمط هو المسؤول.
- **The source sets each margin separately**: يعطي المستند هوامش اليسار واليمين والأعلى والأسفل كلًّا على حدة بدل قيمة `margin` واحدة.
- **Set inside a conditional block**: تقع القيمة داخل كود `\if…`، لذا فقد يؤدي تغييرها هنا إلى كسر المنطق.
- **Set by the template**: في Typst، تحمل قاعدة `#set` التي تضم القيمة شرط `if` أو تمرر وسائط `..`، كما يفعل كود القوالب غالبًا، لذا يتركها مربع الحوار وشأنه.
- **Set by an expression in the source**: القيمة محسوبة لا مكتوبة نصًا، فحرر المصدر بدلًا من ذلك.

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

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

- [الحزم](/docs/packages/): أضف حزم LaTeX أو Typst أخرى
- [التجميع](/docs/compiling/): اختر XeLaTeX أو LuaLaTeX، واختر متغير بناء لـTypst
- [رؤى المستند](/docs/document-insights/): اعرف ما يحتويه المستند
