Creacion de listas de acronimos con glossaries

Digna Gonzalez OteroItsas

31 de marzo de 2011

Indice

1. Introduccion 11.1. Objetivo de documento . . . . . . . . . . . . . . . . . . . . . 11.2. Alternativas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2. Uso de glossaries 22.1. Principios basicos . . . . . . . . . . . . . . . . . . . . . . . . . 22.2. Uso de los acronimos . . . . . . . . . . . . . . . . . . . . . . . 32.3. Listado de acronimos . . . . . . . . . . . . . . . . . . . . . . . 4

3. Resumen 5

1. Introduccion

1.1. Objetivo de documento

El objetivo de este documento es explicar muy brevemente como funcionael paquete glossaries, y en concreto como se puede utilizar para crear listasde acronimos. La documentacion de este paquete se encuentra en CTAN, yhay una version larga1 y otra abreviada2.

Se recomienda consultar estos manuales para informacion mas detalladadel funcionamiento del paquete y para otros casos de aplicacion.

1http://mirror.ctan.org/macros/latex/contrib/glossaries/glossaries.pdf2http://mirror.ctan.org/macros/latex/contrib/glossaries/glossariesbegin.pdf

1

1.2. Alternativas

Existen otras alternativas para crear listas de acronimos, por ejemplo,el paquete acronym3. Este paquete es muy facil de utilizar, pero es muchomenos flexible que glossaries. Por ejemplo, no permite ordenar el listadode acronimos, y dispone de muchas menos opciones de configuracion.

2. Uso de glossaries

2.1. Principios basicos

Para usar glossaries en primer lugar tenemos que incluir el paquetemediante \usepackage, y despues hacer que genere los archivos intermediosnecesarios con el comando \makeglossaries. A la hora de cargar el pa-quete podemos especificar algunas opciones de configuracion. Por ejemplo,podemos escribir lo siguiente en el preambulo de nuestro documento:

% Cargo e l paquete g l o s s a r i e s con d i f e r e n t e s opc iones :% ∗ acronym para c r ea r l i s t a s de acr \ ’ onimos% ∗ nonumber l i s t para que en l a l i s t a de acr \ ’ onimos no ponga% en qu\ ’ e p\ ’ ag inas aparece cada t \ ’ ermino% ∗ sho r t cu t s para poder u t i l i z a r l o s nombres co r t o s% para acr \ ’ onimos : \ac , e t c% ∗ xindy para que u t i l i c e xindy como motor de indexado .% ∗ s a n i t i z e=none para no tener problemas con l o s acentos

\usepackage [ acronym , nonumberlist , shortcuts , %xindy={language=spanish−traditional } , %sanitize=none ]{ glossaries}

\makeglossaries

Ademas, para que el tıtulo de la lista de acronimos aparezca en caste-llano, tendremos que usar el siguiente comando:

\renewcommand{\acronymname}{Lista de Acr \ ’ onimos}%\addto\captionsspanish{%\renewcommand ∗{\ acronymname}{Lista de Acr \ ’ onimos}%}

Como se muestra en los comentarios del texto, las opciones cargadas sonpara lo siguiente:

acronym indica que queremos crear listas de acronimos.

3http://mirror.ctan.org/macros/latex/contrib/acronym/acronym.pdf

2

nonumberlist para que en la lista no indique junto a cada termino enque paginas aparece.

shortcuts para poder utilizar los comandos cortos para acronimos. Porejemplo, \ac, \acl, etc.

xindy para utilizar xindy como motor de indexado. Para ello hay que ins-talarlo en el equipo. En GNU/Linux, paquete xindy.

sanitize=none para evitar problemas con los acentos al utilizar algunoscomandos, como \acs o \acl.

glossaries necesita un motor de indexado para generar un ındice de laspalabras y terminos y luego poder ordenarlos. Por defecto usa makeindex,pero en este ejemplo se ha utilizado xindy porque dicen que es mas reco-mendable por su soporte para codigo LATEX y su mayor compatibilidad conotros idiomas (por ejemplo, por las tildes).

A continuacion, tambien en el preambulo, hay que crear un listado delos acronimos que se quieran utilizar. Se puede crear el listado en un archivoa parte e incluirlo con input.

El formato del listado de acronimos es el siguiente:

\newacronym{etiqueta}{nombrecorto}{nombre largo}

A continuacion se muestran algunos ejemplos:

\newacronym{CSE}{CSE}{Calidad en el Suministro El \ ’ ectrico}\newacronym{PER}{PER}{Plan de Energ \ ’ ias Renovables}\newacronym{REE}{REE}{Red El \ ’ ectrica de Espa\˜na}\newacronym{PCC}{PCC}{Punto de Conexi \ ’ on Com \ ’ un}\newacronym{PFC}{PFC}{proyecto fin de carrera}

2.2. Uso de los acronimos

A continuacion, en el cuerpo del documento podemos referenciar losacronimos. Algunos de los comandos a utilizar son los siguientes:

\ac muestra el acronimo en su forma completa (nombre largo + nombrecorto entre parentesis) la primera vez que aparece el acronimo en eldocumento, y la forma corta el resto de veces.

\acl muestra la forma larga del acronimo.

\acs muestra la forma corta.

3

\acf muestra la forma completa.

Por ejemplo, si ponemos \ac{PFC}, la primera vez aparecera la formacompleta, ası proyecto fin de carrera (PFC), pero las siguientes la formacorta, ası PFC.

Ademas de estos comandos, hay otros para que la inicial empiece pormayuscula, por ejemplo cuando los usamos al principio de una frase. Son losmismos comandos, pero con la inicial en mayuscula. \Acl{PFC} genera esteresultado: Proyecto fin de carrera

2.3. Listado de acronimos

Para generar el listado de acronimos es necesario compilar con el siste-ma de indexado. Para ello, basta con ejecutar el siguiente comando en eldirectorio donde esta nuestro fichero:

makeglossaries NombreFichero

El orden de compilado es el siguiente:

1. latex (o pdflatex)

2. makeglossaries

3. latex (o pdflatex)

4. latex (o pdflatex)

Por ultimo, en el lugar del documento donde queramos generar el ındi-ce de acronimos tendremos que escribir \printglossaries. Si queremosque aparezca en el ındice de contenidos, tendremos que utilizar el comando\addcontentsline

\section∗{Lista de acr \ ’ onimos}\printglossaries\addcontentsline{toc}{section}{Lista de Acr \ ’ onimos}

4

3. Resumen

\documentclass{article}[ . . . ] %Aqu\ ’ i s e cargar \ ’ i an m\ ’ as paquetes\usepackage [ acronym , nonumberlist , shortcuts , %xindy={language=spanish−traditional } , %sanitize=none ]{ glossaries}

\renewcommand{\acronymname}{Lista de Acr \ ’ onimos}%\addto\captionsspanish{%\renewcommand ∗{\ acronymname}{Lista de Acr \ ’ onimos}%}

\makeglossaries\input{acronyms}\begin{document}\section{Introducci \ ’ on}

La \ac{CSE} es muy importante en los sistemas porque . . .

En este \ac{PFC } . . .

% Sec c i \ ’ on de l i s t a de acr \ ’ onimos :\printglossaries\addcontentsline{toc}{section}{Lista de Acr \ ’ onimos}\end{document}

Contenido del fichero acronyms.tex:

1 \newacronym{CSE}{CSE}{Calidad en el Suministro El \ ’ ectrico}2 \newacronym{PER}{PER}{Plan de Energ \ ’ ias Renovables}3 \newacronym{REE}{REE}{Red El \ ’ ectrica de Espa\˜na}4 \newacronym{PCC}{PCC}{Punto de Conexi \ ’ on Com \ ’ un}5 \newacronym{PFC}{PFC}{proyecto fin de carrera}

Compilar segun la siguiente secuencia:

1. latex (o pdflatex)

2. makeglossaries

3. latex (o pdflatex)

4. latex (o pdflatex)

5