الملفات في مشروع حقيقي

ملفات .tex و.bib و.cls و.sty، والملفات المولَّدة التي لا ينبغي أن تحفظها في Git.

الملفات في مشروع حقيقي

افتح مجلد أي مشروع LaTeX حقيقي بعد تجميعه فستجد ملفات أكثر بكثير مما كتبت. وهذا يفاجئ معظم المبتدئين، والخوف من حذف الملف الخطأ يُبقي المجلدات مزدحمة إلى الأبد. والتمييز الذي يبدد الغموض: بعض الملفات مصدر تحرره، وبعضها أنماط يوفرها قالب أو حزمة، والباقي مساحة عمل مؤقتة مولَّدة يعيد المترجم إنشاءها في كل تشغيل.

الملفات التي تكتبها

تحمل ملفات .tex المستند الفعلي: النص والأقسام والأشكال والرياضيات. وملف .bib هو قاعدة بيانات المراجع لديك، بمدخل واحد لكل ورقة أو كتاب قد تستشهد به؛ ويمكنك صيانته يدويًا أو تصديره من مدير مراجع مثل Zotero. هذه هي الملفات التي تستحق النسخ الاحتياطي ووضعها تحت التحكم في الإصدارات، لأن كل ما سواها يمكن إعادة بنائه منها.

الملفات التي يمنحك إياها القالب

يعرّف ملف .cls فئة مستند، وهي ما تسميه في \documentclass{...}. وتشحن المجلات والمؤتمرات فئاتها الخاصة ليبدو كل تقديم متطابقًا، وأنت لا تعدّل فئة تقريبًا أبدًا. أما ملف .sty فحزمة: ماكروهات وإعدادات قابلة لإعادة الاستعمال تُحمَّل بـ \usepackage. ولن تكتب واحدًا بنفسك إلا حين تريد مشاركة أوامر مخصصة بين عدة مستندات. ويصف ملف .bst نمط استشهاد BibTeX، وتضعه الجهة عادةً جاهزًا كذلك.

الملفات التي ينتجها المترجم

يخزّن ملف .aux بيانات الإحالات المرجعية والاستشهادات بين تمريرات التجميع؛ لا تعدّله أبدًا، ولا تتردد في حذفه، لأن التجميع التالي يعيد كتابته. ويسجل ملف .log كل ما فعله المترجم ولا يستحق الفتح إلا إذا حدث خطأ. وملف .pdf هو الناتج الذي أردته فعلًا.

الامتدادالدورهل يُعدَّل يدويًا؟
.texالمستندات والفصول المصدريةنعم
.bibقاعدة بيانات المراجعنعم (أو تصدير من Zotero)
.clsفئة المستندنادرًا، لقوالب الجهات
.styالحزم وملفات الأنماطعند كتابة ماكروهاتك الخاصة
.bstنمط BibTeXنادرًا
.auxبيانات الإحالات المرجعيةلا: مولَّد تلقائيًا
.logسجل المترجميُقرأ عند تتبع الأخطاء
.pdfالناتجيُعرض أو يُقدَّم

بنية مشروع تتسع مع النمو

paper/
main.tex
chapters/
figures/
refs.bib

يعمل ملف main.tex واحد في المستوى الأعلى نقطةَ دخول، وتعيش الفصول في مجلدها الخاص وتُستدعى بـ \input أو \include، وتقع الصور في figures/، وتبقى قائمة المراجع في ملف refs.bib واحد. وتظل هذه البنية قابلة للإدارة سواء كان المشروع ورقة من أربع صفحات أو رسالة جامعية. ويبين درس تقسيم ملفات الفصول كيف ترتبط الأجزاء.

وإذا كنت تستعمل Git، فأضف *.aux و*.log وسائر الملفات المولَّدة إلى .gitignore ليتتبع سجلّك المصدر الحقيقي فقط. ومشاريع Oleafly مجلدات عادية على القرص، فتنطبق هذه النصيحة هناك كما هي. أما الخطأ الأكثر شيوعًا فهو العكسي: ففي أثناء مطاردة خطأ تجميع غريب، كثيرًا ما يكون حذف ملفات .aux هو الحل، لأن ملفًا قديمًا من تشغيل معطوب قد يسمّم كل تجميع بعده.

العودة إلى افتح الحلقة