المختصرات وقوائم الرموز

تتراكم الاختصارات في المستندات الطويلة، وتكون الاصطلاحات المحيطة بها صارمة. يتم توضيح الاختصار بالكامل عند الاستخدام لأول مرة، ويتم اختصاره بعد ذلك، وعادة ما تحتاج الأطروحة إلى قائمة من الاختصارات في المقدمة. الحفاظ على ذلك باليد يفشل بطريقة يمكن التنبؤ بها. تقوم بإعادة ترتيب فصلين، يتحرك الاستخدام الأول، وفجأة يظهر “ML” ثلاث صفحات قبل ظهور “التعلم الآلي (ML)”. تقوم الحزمة glossaries-extra بتتبع الاستخدام الأول لك.

المسار الآلي

\usepackage[acronym]{glossaries-extra}
\makeglossaries
\newacronym{ml}{ML}{machine learning}

يتيح خيار “الاختصار” دعم الاختصارات، ويقوم “\makeglossaries” بتشغيل الآلة التي تجمع الإدخالات أثناء التجميع. يأخذ كل \newacronym ثلاث وسائط: المفتاح الذي ستكتبه في النص، والنموذج القصير، والنموذج الطويل. قم بتعريفهم جميعًا في المقدمة أو في ملف منفصل تقوم بإدخاله، بحيث يعيشون في مكان واحد.

في النص، لا تكتب أبدًا الاختصار نفسه:

\gls{ml} on first use expands; later uses stay short.
\printglossaries

يطبع أول \gls{ml} في المستند “التعلم الآلي (ML)”، وكل واحد لاحق يطبع “ML” فقط. نظرًا لأن الحزمة تتعقب الاستخدام بدلاً من الموضع في المصدر، فإن التوسيع يتبع الاستخدام الأول أينما تحركه عملية إعادة الهيكلة. يقوم \printglossaries بطباعة قائمة الاختصارات المجمعة أينما تضعها، عادة بعد جدول المحتويات. تغطي الأوامر ذات الصلة القواعد النحوية حول هذا: \glspl لصيغ الجمع، و\Gls لبداية الجملة الكبيرة.

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

الطريق المبني يدويًا

للحصول على قائمة بسيطة من الرموز، غالبًا ما تكون بيئة “الوصف” التي يتم صيانتها يدويًا كافية:

\section*{Notation}
\begin{description}
 \item[$\eta$] learning rate
 \item[$\theta$] model parameters
\end{description}

يطبع كل \item[...] وسيطة القوس الخاصة به كتسمية غامقة مع الشرح التالي، وهو بالضبط شكل قائمة التدوين. لا يوجد تتبع للاستخدام الأول، ولكن نادرًا ما تحتاج قائمة الرموز إلى أي تتبع؛ يتم تعريف الرموز حيث تظهر لأول مرة في الرياضيات بغض النظر.

النصيحة الصادقة هي مطابقة الأداة مع المقياس. من السهل إدارة الورقة التي تحتوي على خمسة اختصارات يدويًا. إن الأطروحة المكونة من 200 صفحة والتي تحتوي على أربعين ليست كذلك، وهناك تدفع الحزمة تكلفة إعدادها عدة مرات. يغطي درس القوائم بيئة “الوصف” بمزيد من التفاصيل.