# اكتب انطلاقًا من بياناتك

أبقِ مدخلات التحليل والبرامج النصية والجداول ونتائج المخطوطة مترابطة.

يَسهُل الوثوق بفقرة نتائج عندما يكون الحساب الكامن خلفها قريبًا منها. استخدم مشروعًا بحثيًا لإبقاء إجراء التحليل ومخرجاته إلى جانب المخطوطة.

## إعداد المشروع

اختر بادئ **Reproducible analysis**. [اربط مجلد البيانات](/docs/linked-folders/) حتى تتمكن أدوات البحث من قراءة القياسات الأصلية دون نقلها إلى الورقة.

سجّل معنى الأعمدة ووحداتها وأي استبعادات قبل طلب أي تحليل.

## أعطِ المساعد مهمة محدودة النطاق

استخدم `/oleafly-data-analysis` أو [مهمة بحث](/docs/research-tasks/) من نوع **Analysis**:

> اقرأ القياسات في مجلد Data المرتبط. قارن بين الشرطين باستخدام الطريقة الموضحة في analysis-plan.md. احفظ البرنامج النصي، وجدولًا بالوحدات، وملاحظة تصف الاستبعادات. لا تُغيّر بيانات الإدخال.

تتطلب البرامج النصية للتحليل بيئة التشغيل المحلية والمكتبات ذات الصلة. اطلب من المساعد التحقق من هذه المتطلبات وحفظ طريقة إعادة تشغيل العمل.

## افحص المخرجات

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

احتفظ بالجداول والأشكال مع البرامج النصية التي تولّدها. يمكن لمهارة [figure-prep](/docs/skills/) المساعدة في تحويل نتيجة تم التحقق منها إلى شكل يصلح للمخطوطة.

مع [وكيل سطر الأوامر](/docs/cli-agents/#research-starting-points)، تسأل نقطة الانطلاق **Reproducibility audit** عمّا تحتاجه كل نتيجة لإعادة إنتاجها: الشيفرة، والبيانات، وإصدارات البرامج، والبذور العشوائية، وتعليمات البناء. أما **Figure audit** فيتحقق من التسميات التوضيحية والعلامات ووحدات المحاور وقابلية القراءة. تطلب كلتاهما من الوكيل كتابة تقرير في `research/` وترك المخطوطة دون تعديل.

## شغّل الشيفرة داخل المستند

لتجعل الأرقام في ملف PDF تأتي مباشرة من الشيفرة، اكتب التقرير في [Quarto أو Calepin](/docs/engines/#quarto). يشغّل Quarto كتل R أو Python أو Julia في ملف `.qmd` أو `.Rmd`، ويشغّل Calepin الكتل في مستند Typst.

- تبقى الشيفرة معطلة في كل مشروع حتى تختار **Allow code in this project**. ومع تعطيل الشيفرة، يعرض Quarto شيفرة كل كتلة دون مخرجاتها، ويعرض Calepin النتائج التي خزّنها آخر مرة شُغّلت فيها الشيفرة. وتشغّل المرشحات، والاختصارات shortcodes، ومجلد `_extensions`، ونصوص التصيير، وشيفرة R المضمّنة في النص، الشيفرة حتى في هذه الحالة، لذا لا يُجمَّع مشروع يستخدم أيًّا منها حتى تسمح بالشيفرة.
- ومع تعطيل الشيفرة ودون R على الحاسوب، يظل ملف `.qmd` ذو مقدمة يُعاين، ما لم يكن في مقدمته مفتاح `knitr:`. وأي مستند آخر فيه شيفرة R، ومنه ملفات `.Rmd`، يحتاج إلى R حتى مع تعطيل الشيفرة. ثبّت R من [cloud.r-project.org](https://cloud.r-project.org/)، ثم جمّع مرة أخرى.
- يحتاج Oleafly إلى Quarto 1.5 أو أحدث. وإذا كان لديك أقدم، يستخدم Oleafly نسخته الخاصة، أو يطلب منك تنزيل واحدة من **Settings → Engines → Quarto**. ودون نسخة منزَّلة، يُبنى المستند في مشروع `_quarto.yml` بـQuarto الأقدم لديك بدلًا من ذلك.
- تعمل شيفرة Python في بيئة المشروع نفسه حين يحوي المشروع مجلد `.venv` أو `venv` أو `env` مثبّتًا فيه Jupyter، ويستخدم Calepin مجلد `.venv` حين يكون في المشروع. وإلا فتعمل الشيفرة بـPython المسرود تحت **Languages** في **Settings → Engines → Quarto**.
- يحتاج مستند `pdf` أو `beamer` إلى LaTeX. ودون TeX مثبّت، ثبّت TinyTeX حين يعرضه Oleafly، أو بدّل المستند إلى `format: typst`، أو أضف `pdf-engine: tectonic` إلى المقدمة لاستخدام المحرك المدمج متى سُمح بالشيفرة.
- يكتب Quarto ملف عمل باسم المستند بجانبه: `report.tex` لـPDF، أو `report.typ` لـTypst. وإذا كان لأحد ملفاتك الاسم نفسه، يتوقف التجميع ويسمّيه بدلًا من استبداله. غيّر اسم ملفك أو انقله، ثم جمّع مرة أخرى.
- إذا فُقدت أحرف كورية أو صينية أو يابانية من ملف PDF، يسمّي التنبيه خطًا ويعطي سطرين لإضافتهما إلى المقدمة: `CJKmainfont:` مع ذلك الخط، و`pdf-engine: tectonic`. أضف الاثنين، لأن الخط يأتي مع المحرك المدمج. ولا يعمل `pdf-engine: tectonic` إلا بعد السماح بالشيفرة للمشروع.
- قد يعمل دفتر ملاحظات حتى ساعة. وبعدها يوقفه Oleafly، ويعرض السجل الخلية التي وصل إليها. اختصر تلك الخلية أو خزّنها مؤقتًا، ثم جمّع مرة أخرى.

## اكتب النتيجة

اطلب من المساعد صياغة مقطع للنتائج بالاعتماد على المخرجات المراجَعة فقط. دقّق في كل رقم بمقارنته بالجدول، وافصل بين الطريقة والتفسير.

جمّع المستند وراجع الجدول أو الشكل كاملًا في ملف PDF، بما في ذلك العلامات والتسمية التوضيحية.
