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

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

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

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

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

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

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

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

تخطيط المشروع الذي يتوسع

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

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

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