# رؤى المستند

اعرض العناوين والأشكال والجداول والمعادلات والتسميات والاستشهادات وبنود TODO في مستند LaTeX أو Typst أو Markdown، وانسخ البيانات الوصفية للتقديم.

قبل أن تقدّم المستند، من المفيد أن ترى ما يحتويه فعلًا. هل لكل شكل عنوان توضيحي، وهل كل مفتاح مستشهد به موجود في قائمة المراجع؟ يعرض **Document insights** كل ذلك في مربع حوار واحد، مع ربط كل مدخل بسطره في المصدر.

افتحه بزر **Document insights** في الطرف الأيمن من شريط أدوات المحرر، أو شغّل **Document insights** من لوحة ⌘K. وهو يعمل في مشاريع LaTeX وTypst وMarkdown، ويقرأ المستند بدءًا من الملف الرئيسي، فيُحتسب أيضًا فصل LaTeX يُدرج بـ`\input` أو ملف Typst يُدرج بـ`#include`.

## ما تعرضه كل علامة تبويب

تعرض **Overview** عددًا لكل قائمة أدناه. انقر عددًا لفتح علامة التبويب تلك.

- **Headings**، بمسافة بادئة حسب المستوى.
- **Figures** و**Tables**، كل منها مع عنوانه التوضيحي (أو **No caption**)، وتسميته، و**Unnumbered** عندما لا يكون له رقم.
- **Equations**: معادلات العرض فقط، لا الرياضيات السطرية.
- **Labels**: كل تسمية، ومع ما تشير إليه: عنوان، أو شكل، أو جدول، أو معادلة، أو غير ذلك.
- **Citations**: كل مفتاح مستشهد به وعدد مرات الاستشهاد به. والمفتاح غير الموجود في قائمة المراجع يُعلَّم بـ**Not in the bibliography**، وتعرض Overview كم عددها.
- **To-dos**: ملاحظات `TODO` و`FIXME` و`XXX` في المصدر. وفي LaTeX، تُحتسب أيضًا `\todo` و`\missingfigure` وملاحظات حزمة fixme.

انقر صفًا لإغلاق مربع الحوار والانتقال إلى ذلك السطر. والصف الرمادي هو صف تعذر تتبعه إلى المصدر.

## الأرقام والصفحات

يعتمد مصدر الأرقام على المحرك:

- **LaTeX**: تأتي أرقام الأشكال والجداول والمعادلات والعناوين وصفحاتها من آخر تجميع، للعناصر ذات التسمية. ويخبرك التذييل بما إذا كانت محدثة. فإذا كنت قد عدّلت منذئذ، جمّع مرة أخرى لتحديثها.
- **Typst**: يطلب مربع الحوار من Typst قراءة المستند عند فتحه، بنسخة Typst الخاصة بالمشروع ومتغير البناء المحدد، فتطابق الأرقام والصفحات المصدر في وضعه الحالي. وإذا لم يستطع Typst تجميع المستند، عرضت Overview الأخطاء بدلًا من ذلك، وكل منها مرتبط بسطره. ولا تُعرض سوى أول 5,000 عنصر. ويسمي التذييل نسخة Typst المستخدمة.
- **Markdown**: تُدرج المدخلات بترتيب المصدر، دون أرقام أو صفحات.

يعيد **Refresh** قراءة المستند دون إغلاق مربع الحوار.

## البيانات الوصفية للتقديم

تعرض Overview أيضًا **Title** و**Authors** و**Keywords** و**Date** و**Abstract** التي عثر عليها Oleafly. وما يكون مفقودًا يظهر بعبارة **Not set**.

- في LaTeX، تأتي هذه الحقول من `\title` و`\author` و`\date` وبيئة `abstract` وأمر `\keywords` أو بيئة `keywords` أو `IEEEkeywords`.
- في Typst، تأتي من وسائط القالب الذي يطبقه المستند، أو من `#set document(...)`. ويمكن أن يأتي الملخص أيضًا من عنوان باسم "Abstract".
- في Markdown، تأتي من مقدمة الملف: `title` و`author` أو `authors` و`date` و`keywords` و`abstract`.

يضع **Copy submission metadata** العنوان والمؤلفين والكلمات المفتاحية والملخص في الحافظة على شكل أسطر معنونة، جاهزة للصق في نموذج تقديم. ويكون الزر معطلًا عندما لا يكون أي منها مضبوطًا.

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

- [فحوصات Preflight](/docs/preflight/): فحوصات أعمق على المصدر والسجل وملف PDF قبل التقديم
- [الاستشهادات وقائمة المراجع](/docs/citations/): أضف المفاتيح التي يبلغ Document insights عن غيابها
- [إعدادات المستند](/docs/document-settings/): أداة المستند الأخرى على شريط أدوات المحرر
