LaTeX: Glossaries

5,752 views
5,475 views

Published on

Explicación sobre cómo usar el paquete glossaries para generar índices de acrónimos en LaTeX.

Published in: Technology

LaTeX: Glossaries

  1. 1. Creaci´n de listas de acr´nimos con glossaries o o Digna Gonz´lez Otero a Itsas 31 de marzo de 2011´Indice1. Introducci´n o 1 1.1. Objetivo de documento . . . . . . . . . . . . . . . . . . . . . 1 1.2. Alternativas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22. Uso de glossaries 2 2.1. Principios b´sicos . . . . . . . . . . . . . . . . . . . . . . . . . a 2 2.2. Uso de los acr´nimos . . . . . . . . . . . . . . . . . . . . . . . o 3 2.3. Listado de acr´nimos . . . . . . . . . . . . . . . . . . . . . . . o 43. Resumen 51. Introducci´n o1.1. Objetivo de documento El objetivo de este documento es explicar muy brevemente c´mo funciona oel paquete glossaries, y en concreto c´mo se puede utilizar para crear listas ode acr´nimos. La documentaci´n de este paquete se encuentra en CTAN, y o ohay una versi´n larga o 1 y otra abreviada2 . Se recomienda consultar estos manuales para informaci´n m´s detallada o adel funcionamiento del paquete y para otros casos de aplicaci´n. o 1 http://mirror.ctan.org/macros/latex/contrib/glossaries/glossaries.pdf 2 http://mirror.ctan.org/macros/latex/contrib/glossaries/glossariesbegin.pdf 1
  2. 2. 1.2. Alternativas Existen otras alternativas para crear listas de acr´nimos, por ejemplo, oel paquete acronym3 . Este paquete es muy f´cil de utilizar, pero es mucho amenos flexible que glossaries. Por ejemplo, no permite ordenar el listadode acr´nimos, y dispone de muchas menos opciones de configuraci´n. o o2. Uso de glossaries2.1. Principios b´sicos a Para usar glossaries en primer lugar tenemos que incluir el paquetemediante usepackage, y despu´s hacer que genere los archivos intermedios enecesarios con el comando makeglossaries. A la hora de cargar el pa-quete podemos especificar algunas opciones de configuraci´n. Por ejemplo, opodemos escribir lo siguiente en el pre´mbulo de nuestro documento: a% Cargo e l p aq u et e g l o s s a r i e s con d i f e r e n t e s o p c i o n e s :% ∗ acronym para c r e a r l i s t a s de a c r ’ onimos% ∗ n o n u m b e r l i s t para que en l a l i s t a de a c r ’ onimos no ponga% en qu ’ e p ’ a g i n a s a p a r e c e cada t ’ ermino% ∗ s h o r t c u t s para poder u t i l i z a r l o s nombres c o r t o s% para a c r ’ onimos : ac , e t c% ∗ xindy para que u t i l i c e xindy como motor de i nd e x a d o .% ∗ s a n i t i z e=none para no t e n e r problemas con l o s a c e n t o s usepackage [ acronym , nonumberlist , shortcuts , %xindy={language=spanish−traditional } , %sanitize=none ] { glossaries } makeglossaries Adem´s, para que el t´ a ıtulo de la lista de acr´nimos aparezca en caste- ollano, 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 acr´nimos. o 3 http://mirror.ctan.org/macros/latex/contrib/acronym/acronym.pdf 2
  3. 3. nonumberlist para que en la lista no indique junto a cada t´rmino en e qu´ p´ginas aparece. e ashortcuts para poder utilizar los comandos cortos para acr´nimos. Por o ejemplo, 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 algunos comandos, como acs o acl. glossaries necesita un motor de indexado para generar un ´ ındice de laspalabras y t´rminos y luego poder ordenarlos. Por defecto usa makeindex, epero en este ejemplo se ha utilizado xindy porque dicen que es m´s reco- amendable por su soporte para c´digo L TEX y su mayor compatibilidad con o Aotros idiomas (por ejemplo, por las tildes). A continuaci´n, tambi´n en el pre´mbulo, hay que crear un listado de o e alos acr´nimos que se quieran utilizar. Se puede crear el listado en un archivo oa parte e incluirlo con input. El formato del listado de acr´nimos es el siguiente: o newacronym{etiqueta}{nombrecorto}{nombre largo} A continuaci´n se muestran algunos ejemplos: o 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 acr´nimos o A continuaci´n, en el cuerpo del documento podemos referenciar los oacr´nimos. Algunos de los comandos a utilizar son los siguientes: oac muestra el acr´nimo en su forma completa (nombre largo + nombre o corto entre par´ntesis) la primera vez que aparece el acr´nimo en el e o documento, y la forma corta el resto de veces.acl muestra la forma larga del acr´nimo. oacs muestra la forma corta. 3
  4. 4. acf muestra la forma completa. Por ejemplo, si ponemos ac{PFC}, la primera vez aparecer´ la forma acompleta, as´ proyecto fin de carrera (PFC), pero las siguientes la forma ıcorta, as´ PFC. ı Adem´s de estos comandos, hay otros para que la inicial empiece por amay´scula, por ejemplo cuando los usamos al principio de una frase. Son los umismos comandos, pero con la inicial en may´scula. Acl{PFC} genera este uresultado: Proyecto fin de carrera2.3. Listado de acr´nimos o Para generar el listado de acr´nimos es necesario compilar con el siste- oma de indexado. Para ello, basta con ejecutar el siguiente comando en eldirectorio donde est´ nuestro fichero: a 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 acr´nimos tendremos que escribir printglossaries. Si queremos oque aparezca en el ´ ındice de contenidos, tendremos que utilizar el comandoaddcontentsline section ∗{ Lista de acr ’ onimos } printglossaries addcontentsline { toc }{ section }{ Lista de Acr ’ onimos } 4
  5. 5. 3. Resumen documentclass { article } [ . . . ] % Aqu ’ i s e c a r g a r ’ i a n m ’ a s p a q u e t e s 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 } . . . % S e c c i ’ on de l i s t a de a c r ’ 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 seg´n la siguiente secuencia: u 1. latex (o pdflatex) 2. makeglossaries 3. latex (o pdflatex) 4. latex (o pdflatex) 5

×