Siglas y listas de símbolos
Un esbozo con glossaries-extra, o una lista hecha a mano cuando basta con eso.
Siglas y listas de símbolos
Los documentos largos van acumulando abreviaturas, y las convenciones que las rodean son estrictas. Una sigla se escribe completa la primera vez que aparece y abreviada a partir de entonces, y una tesis suele necesitar una lista de abreviaturas en las páginas preliminares. Mantener eso a mano falla de una forma previsible. Reordenas dos capítulos, el primer uso cambia de sitio y, de pronto, «ML» aparece tres páginas antes que «machine learning (ML)». El paquete glossaries-extra se encarga de seguir el primer uso por ti.
La vía automática
\usepackage[acronym]{glossaries-extra}\makeglossaries\newacronym{ml}{ML}{machine learning}La opción acronym activa la compatibilidad con siglas, y \makeglossaries pone en marcha la maquinaria que recoge las entradas durante la compilación. Cada \newacronym recibe tres argumentos: una clave que escribirás en el texto, la forma corta y la forma larga. Defínelas todas en el preámbulo o en un archivo aparte que cargues con \input, para que estén en un solo lugar.
En el cuerpo del documento nunca escribes la sigla en sí:
\gls{ml} on first use expands; later uses stay short.\printglossariesEl primer \gls{ml} del documento imprime «machine learning (ML)», y todos los siguientes imprimen solo «ML». Como el paquete sigue el uso y no la posición en el código fuente, la expansión acompaña al primer uso allí donde lo lleve tu reorganización. \printglossaries imprime la lista recopilada de abreviaturas en el lugar donde lo coloques, normalmente después del índice general. Otros comandos se ocupan de la gramática: \glspl para los plurales y \Gls para empezar una frase con mayúscula.
El problema está en la compilación. Entre una pasada de LaTeX y otra debe ejecutarse la herramienta auxiliar makeglossaries para ordenar y dar formato a las entradas; si no, \printglossaries no produce nada y no avisa. Las configuraciones completas de latexmk se ocupan de esto automáticamente. Los flujos más simples quizá no lo hagan, y glossaries-extra ofrece una alternativa para ellos. Si tu lista se empeña en no aparecer, el primer sospechoso es esa ejecución que falta, mucho antes que un error en tu documento.
La vía hecha a mano
Para una lista sencilla de símbolos, suele bastar un entorno description mantenido a mano:
\section*{Notation}\begin{description} \item[$\eta$] learning rate \item[$\theta$] model parameters\end{description}Cada \item[...] imprime su argumento entre corchetes como una etiqueta en negrita, seguida de la explicación, que es justo la forma de una lista de notación. No hay seguimiento del primer uso, pero una lista de símbolos rara vez lo necesita; los símbolos se definen donde aparecen por primera vez en las fórmulas, sea cual sea el orden.
El consejo sincero es ajustar la herramienta a la escala. Un artículo con cinco siglas es más fácil de gestionar a mano. Una tesis de 200 páginas con cuarenta, no, y ahí el paquete compensa muchas veces el esfuerzo de configurarlo. La lección sobre listas trata con más detalle el entorno description.