كل ما يقع فوق begin{document}

الحزم والبيانات الوصفية وترتيب التحميل: ما ينتمي إلى الديباجة وما لا ينتمي إليها.

كل ما يقع فوق begin{document}

كل ما يقع بين \documentclass{...} و \begin{document} هو الديباجة. فهي لا تنتج أي نص مرئي، بل تضبط عملية التشغيل. الخطوط والهوامش والحزم والأوامر المخصصة وبيانات المستند الوصفية كلها تعيش هنا، ولهذا تكون ديباجة الورقة الناضجة غالبًا أطول من مقدمتها. وما إن تعرف ما يفعله كل سطر حتى يتوقف القالب المنسوخ عن كونه سحرًا ويصبح قائمة مراجعة.

التشريح

\documentclass[11pt,a4paper]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[margin=1in]{geometry}
\usepackage{amsmath,amssymb}
\usepackage{graphicx,booktabs}
\usepackage{hyperref} % load late
\title{Title}
\author{You}
\date{\today}

تضبط الخيارات الموجودة في \documentclass القيم الافتراضية العامة: فـ 11pt هو حجم الخط الأساسي الذي يُقاس منه كل شيء آخر، و a4paper يحدد حجم الورق. أما سطرا الترميز فهما رفيقان تاريخيان: يخبر inputenc المحرك بأن ملف المصدر بترميز UTF-8، ويختار fontenc ترميز الخط حتى تكون الحروف المشكّلة رموزًا حقيقية وليست تركيبات. تفترض إصدارات LaTeX الحالية إدخال UTF-8 أصلًا، لذا سترى هذين السطرين محذوفين في المستندات الجديدة، لكنهما غير ضارين وتبقيهما القوالب للتوافق.

تحمّل الكتلة الوسطى حزم الإمكانات. تضبط geometry الهوامش بخيار واحد، وتوفر amsmath و amssymb بيئات الرياضيات والرموز التي يحتاجها كل مستند تقني تقريبًا، وتتيح graphicx الأمر \includegraphics للأشكال، وتوفر booktabs الخطوط التي تمنح الجداول مظهرًا احترافيًا. وأخيرًا تجعل hyperref المراجع والاستشهادات قابلة للنقر، وتُحمَّل في الآخر عن قصد لأنها تعيد تعريف الأجزاء الداخلية لكثير من الحزم الأخرى.

أما الأسطر \title و \author و \date فتخزّن البيانات الوصفية فقط. ولا يُطبع شيء حتى يعمل \maketitle في صلب المستند، ولهذا يمكن أن تقع هذه الأسطر في الديباجة أصلًا.

قواعد عملية

بضع عادات تُبقي الديباجات سليمة. حمّل حزمة واحدة لكل مهمة وقاوم تكديس الحزم التي تتنازع الأمر نفسه، مثل طريقتين لضبط الهوامش. أبقِ hyperref في النهاية، مع عدد قليل من الاستثناءات الموثقة مثل cleveref التي يجب أن تأتي بعدها. وضع الخيارات العامة للمستند في خيارات الصنف بدل نثرها في أماكن متفرقة، بحيث يُعلن 11pt أو twocolumn مرة واحدة حيث يراها الجميع. وما إن تتجاوز الأوامر المخصصة بضعة أسطر حتى تنقلها إلى ملف .sty ليتشارك عدة مستندات مجموعة واحدة من التعريفات.

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

اختبار الديباجةاختبار تدريبي اختياري5 أسئلة

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

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