اكتب انطلاقًا من بياناتك
أبقِ مدخلات التحليل والبرامج النصية والجداول ونتائج المخطوطة مترابطة.
يَسهُل الوثوق بفقرة نتائج عندما يكون الحساب الكامن خلفها قريبًا منها. استخدم مشروعًا بحثيًا لإبقاء إجراء التحليل ومخرجاته إلى جانب المخطوطة.
إعداد المشروع
قسم بعنوان “إعداد المشروع”اختر بادئ Reproducible analysis. اربط مجلد البيانات حتى تتمكن أدوات البحث من قراءة القياسات الأصلية دون نقلها إلى الورقة.
سجّل معنى الأعمدة ووحداتها وأي استبعادات قبل طلب أي تحليل.
أعطِ المساعد مهمة محدودة النطاق
قسم بعنوان “أعطِ المساعد مهمة محدودة النطاق”استخدم /oleafly-data-analysis أو مهمة بحث من نوع Analysis:
اقرأ القياسات في مجلد Data المرتبط. قارن بين الشرطين باستخدام الطريقة الموضحة في analysis-plan.md. احفظ البرنامج النصي، وجدولًا بالوحدات، وملاحظة تصف الاستبعادات. لا تُغيّر بيانات الإدخال.
تتطلب البرامج النصية للتحليل بيئة التشغيل المحلية والمكتبات ذات الصلة. اطلب من المساعد التحقق من هذه المتطلبات وحفظ طريقة إعادة تشغيل العمل.
افحص المخرجات
قسم بعنوان “افحص المخرجات”اقرأ البرنامج النصي وتأكد من أن البيانات المختارة والطريقة المستخدمة تطابقان ما يطرحه السؤال. تحقق من الوحدات وأعداد العينات والقيم المفقودة وهامش عدم اليقين قبل قبول أي نتيجة.
احتفظ بالجداول والأشكال مع البرامج النصية التي تولّدها. يمكن لمهارة figure-prep المساعدة في تحويل نتيجة تم التحقق منها إلى شكل يصلح للمخطوطة.
مع وكيل سطر الأوامر، تسأل نقطة الانطلاق Reproducibility audit عمّا تحتاجه كل نتيجة لإعادة إنتاجها: الشيفرة، والبيانات، وإصدارات البرامج، والبذور العشوائية، وتعليمات البناء. أما Figure audit فيتحقق من التسميات التوضيحية والعلامات ووحدات المحاور وقابلية القراءة. تطلب كلتاهما من الوكيل كتابة تقرير في research/ وترك المخطوطة دون تعديل.
شغّل الشيفرة داخل المستند
قسم بعنوان “شغّل الشيفرة داخل المستند”لتجعل الأرقام في ملف PDF تأتي مباشرة من الشيفرة، اكتب التقرير في Quarto أو Calepin. يشغّل 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 (يفتح في علامة تبويب جديدة)، ثم جمّع مرة أخرى. - يحتاج 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، بما في ذلك العلامات والتسمية التوضيحية.