ضع الورقة على GitHub

التهيئة، وتجاهل ملفات aux، ومستودع خاص، وعادات تحافظ على سلامة الدمج بين المؤلفين المشاركين.

ضع الورقة على GitHub

مخطوطة LaTeX نص عادي، وهذا يجعلها مناسبة تمامًا لـ Git. فكل مسودة تصبح إيداعًا (commit) يمكنك العودة إليه، وكل تغيير يظهر فرقًا على مستوى الأسطر، ويمنحك GitHub نسخة خارج جهازك وطريقة يسحب بها المؤلفون المشاركون الحالة الراهنة. ولا يتطلب أي من هذا استخدامًا متقدمًا لـ Git. فالورقة تحتاج ربما إلى خمسة أوامر تستخدمها بانتظام.

الإعداد الأولي

نافذة المحطة الطرفية
git init
# add a .gitignore for *.aux *.log *.out *.toc *.synctex.gz
git add main.tex refs.bib figures/
git commit -m "Initial manuscript"
gh repo create my-paper --private --source=. --push

شغّل هذا مرة واحدة في مجلد المشروع. وخطوة .gitignore أهم مما تبدو. فكل تجميع يعيد توليد الملفات .aux و.log و.out و.toc و.synctex.gz، وإيداعها يدفن تغييراتك الحقيقية تحت ضجيج الآلة ويسبب تعارضات دمج لا طائل منها بين المؤلفين المشاركين. تتبّع ما تكتبه أنت فقط: مصادر .tex، وقاعدة بيانات .bib، والأشكال، وأي ملفات صنف أو نمط زودتك بها جهة النشر. وملف PDF ناتج بناء أيضًا. ومعظم الفرق تتركه خارج المستودع وتعيد البناء محليًا، مع أن إرفاقه بإصدار موسوم طريقة معقولة لتجميد النسخة المقدَّمة. أبقِ المستودع خاصًا حتى يصبح العمل علنيًا. فالمخطوطة غير المنشورة ليست شيئًا ينبغي فهرسته.

عادات تحافظ على سلامة المؤلفين المشاركين

اجعل كل إيداع تغييرًا منطقيًا واحدًا، مثل “مراجعة مقدمة القسم 3” أو “إضافة جدول دراسة الاستئصال”. فيُقرأ السجل حينها كقصة للورقة، ويمكن التراجع عن تعديل سيئ دون أضرار جانبية. اسحب قبل أن تبدأ جلسة الكتابة وادفع عندما تتوقف. فتعارضات الدمج تكبر بقدر الوقت الذي تقضيه الفروع منفصلة. ولا تدفع بالقوة (force-push) إلى فرع مشترك بعد أن سحبه المؤلفون المشاركون: فهذا يعيد كتابة السجل من تحت أقدامهم. وأبقِ الملفات الثنائية الكبيرة (مجموعات البيانات ومقاطع الفيديو) خارج مستودع الورقة. اربط بأرشيف أو استخدم مستودع بيانات منفصلًا. فـ Git يخزن كل إصدار من كل ملف ثنائي إلى الأبد.

وهناك عادة خاصة بـ LaTeX: كتابة جملة واحدة في كل سطر من المصدر تجعل الفروق أسهل قراءة بكثير، لأن تعديل كلمة واحدة يظهر تغييرًا في سطر واحد بدل فقرة أعيد تدفقها.

أين يندرج Oleafly

كل مشروع في Oleafly مجلد عادي على القرص، لذا تعمل هذه الأوامر عليه كما هي. ويحتفظ Oleafly بعمليات البناء الناجحة المؤهلة التي تغيّر مصدرها في Saved Checkpoints، بمعزل عن Git. أجرِ إيداعات متعمدة في Source Control، ثم ادفع أو اسحب مع المتعاونين. راجع سجل Git. وللاطلاع على أنماط التعاون المبنية على هذا، بما فيها تبادل الرقع وملكية الفصول، راجع التأليف المشترك بدون مؤشر مباشر.

العودة إلى الاستوديو المحلي