Saltar al contenido
Topos Uranos
Español

Índices y glosarios

Resumen

Esta clase enseña a componer el índice analítico de un libro o de una tesis, y sus glosarios. Explica para qué sirve un índice analítico y en qué se distingue del índice general; presenta el paquete imakeidx, con \makeindex, \index y \printindex, y el ciclo de compilación en que makeindex ordena las entradas entre dos pasadas del motor; enseña las subentradas, las claves de orden que corrigen la ubicación de las palabras con tilde, las remisiones, que el español rotula «véase» y «véase también», los rangos de páginas y los números destacados; muestra cómo mantener varios índices a la vez, uno de nombres y otro de materias; presenta el paquete glossaries, con sus términos definidos y sus siglas, que se desarrollan la primera vez que aparecen, y la variante glossaries-extra; y termina con los errores más frecuentes: el índice que no se actualiza, las tildes mal ordenadas y las entradas duplicadas por una escritura distinta.

Objetivos de aprendizaje

  1. Distinguir el índice analítico del índice general y del glosario por lo que ordena cada uno y por lo que ofrece al lector.
  2. Marcar las entradas de un índice con subentradas, claves de orden, remisiones, rangos y números destacados, y predecir lo que imprime cada marca.
  3. Explicar el ciclo de compilación con makeindex, qué archivo produce cada paso, y reconocer por qué un índice no se actualiza.
  4. Mantener varios índices en un mismo documento y dirigir cada entrada al suyo.
  5. Definir términos y siglas con glossaries, prever qué imprime cada mención y componer el glosario y la lista de siglas.
  6. Diagnosticar las entradas duplicadas, las palabras con tilde mal ordenadas y los errores del glosario a partir del índice impreso y del registro.

Para qué sirve un índice analítico

En la clase sobre secciones, índice y apéndices se vio el índice general, que \tableofcontents compone al comienzo del documento y que babel titula «Índice»: reproduce las divisiones en el orden en que aparecen y responde a la pregunta de cómo está organizado el texto. El índice analítico, que babel titula «Índice alfabético», responde a otra pregunta: dónde se habla de algo. Ordena alfabéticamente los conceptos, los nombres y las obras que el texto trata, y da para cada uno las páginas donde se encuentran. Un lector que busca qué dice un libro de historia de la ciencia sobre Kepler, o qué dice un manual de bioquímica sobre la entalpía, no puede encontrarlo en el índice general, porque ningún título de sección lo nombra; lo encuentra en el analítico.

De ello se sigue que el índice analítico no se obtiene de la estructura del documento, como el general, sino de una decisión del autor: qué términos merecen figurar, bajo qué forma y con qué subdivisiones. Un índice que recoge cada aparición de cada palabra es inútil, porque devuelve al lector todas las páginas; uno bueno recoge los lugares donde un término se define, se discute o se aplica, y remite de las formas que el lector podría buscar a la forma elegida. Por eso es propio de los libros, los manuales y las tesis extensas, y no de un artículo de diez páginas.

El glosario es una tercera herramienta. No dice dónde se habla de un término, sino qué significa: es una lista de definiciones, a menudo acompañada por la lista de las siglas que el texto usa, con su forma desarrollada. Las dos se componen con el mismo mecanismo, que esta clase estudia primero en el índice.