% +--------------------------------------------------+ % | Typeset this file to get the documentation. | % +--------------------------------------------------+ % %% Copyright (C) 1998-2004, 2006, 2008 Javier Bezos %% All Rights Reserved %% http://www.tex-tipografia.com %% %% This work may be distributed and/or modified under the conditions %% of the LaTeX Project Public License, either version 1.3 of this %% license or (at your option) any later version. The latest version %% of this license is in %% http://www.latex-project.org/lppl.txt %% and version 1.3 or later is part of all distributions of LaTeX %% version 2003/12/01 or later. %% %% This work has the LPPL maintenance status "maintained". %% %% This Current Maintainer of this work is Javier Bezos. %% %% This work consists of the files esindex.tex and esindex.sty. \documentclass{article} \usepackage[spanish,activeacute]{babel} \spanishdatedel \usepackage[cp1252]{inputenc} \title{Paquete \textsf{esindex}\footnote{Este archivo est\'a actualmente en la versi\'on 1.4 con fecha 2008-09-28. Esta copia del manual se compuso el~\today.}} \author{Javier Bezos\footnote{Para comentarios y sugerencias: \texttt{http://www.tex-tipografia.com}.}} \raggedright \parskip=1ex \date{2008-09-28} \begin{document} \maketitle This package defines the command \verb|\esindex| which easies writing Spanish index entries: \begin{verbatim} \esindex{cañón} \end{verbatim} is equivalent to \begin{verbatim} \index{can^^ffon@cañón} \end{verbatim} Since it is an especifically Spanish tool, the documentation is in Spanish. \vspace*{1pc} Este paquete ha sido dise'nado para facilitar la escritura de 'indices correctamente alfabetizados en castellano. Su principal orden es \verb|\esindex| que convierte a una forma adecuada su argumento. As'i por ejemplo, \begin{verbatim} \esindex{cañón} \end{verbatim} equivale a \begin{verbatim} \index{can^^ffon@cañón} \end{verbatim} No es necesario usar \textsf{babel} salvo, l'ogicamente, si los acentos est'an escritos en forma de abreviaciones (\verb|'a|, \verb|'e|, etc.) en lugar de con los caracteres reales. En este 'ultimo caso, el paquete utiliza ciertas 'ordenes internas de \textsf{babel} por lo que no puedo garantizar su funcionamiento correcto con versiones distintas a las 3.6 a 3.8. En caso de que \textsf{esindex} sea incompatible con futuras versiones de \textsf{babel} intentar'e adaptarlo en el menor tiempo posible. Salvo el car'acter \verb|actual| (normalmente \verb|@|) se pueden usar todos los caracteres especiales de \textit{MakeIndex}. Se pueden usar convenciones diferentes a las normales, pero en este caso hacen falta ajustes adicionales en caso de que los modificados sean \verb|actual|, \verb|encap|, \verb|level| o \verb|quote|. En ese caso basta con indicar los caracteres que hay que usar como opciones de paquete. Por ejemplo, si para \verb|quote| decidimos usar \verb|$| en nuestro archivo \verb|.ist| particular, tendr'iamos que llamar al paquete del siguiente modo: \begin{verbatim} \usepackage[quote=$]{esindex} \end{verbatim} Es importante observar que, a diferencia de la opci'on para alem'an de \textit{MakeIndex}, el uso de \verb|"| en abreviaciones como \verb|"u| es completamente leg'itimo, ya que el paquete reconoce tal combinaci'on y la trata aparte. Lo mismo vale para \verb|'| o \verb|~| en caso de que se usaran como car'acter especial. Es decir \begin{verbatim} \esindex{{"!`}Cig"ue'nas{"!}|textbf} \end{verbatim} equivale a \begin{verbatim} \index{{"!`}Ciguen^^ffas{"!}@{"!`}Cig\"ue\~nas{"!}|textbf} \end{verbatim} Sin embargo, el uso del car'acter \verb|quote| ante \verb|encap| o \verb|level| no se detecta a menos que el grupo est'e encerrado entre llaves. Por ejemplo, en lugar de \verb/\esindex{Pleca: "|}/ debe escribirse \verb/\esindex{Pleca: {"|}}/. (En realidad en este caso podr'ia haberse usado \verb|\index|. Es tan s'olo un ejemplo.) Aunque el hecho de que \verb|@| no se pueda usar en \verb|\esindex| hace que todav'ia algunas entradas se tengan que hacer <>, la mayor parte del trabajo se ve considerablemente simplificado. Finalmente, hay que se'nalar que con este paquete no se crea en el 'indice una entrada propia para la palabras que empiezan por e'ne, sino que tan s'olo se a'naden al final de la ene. En el rar'isimo caso de que hubiera palabras que empiezan por e'ne habria que modificar el archivo \verb|.ind| a mano. % La versión 1.2 corrige la supresión incorrecta de acentos en los % primeros niveles si había más de uno. La versión 1.3 elimina una incompatibilidad con recientes versiones de \LaTeX{} y añade nuevas funciones: \begin{itemize} \item Opción de paquete \verb|ignorespaces|: al formar la clave de ordenación se suprimen los espacios, de forma que: $$\mbox{adentro} < \mbox{a donde} < \mbox{adonde}.$$ \item Opción de paquete \verb|replaceindex|: el comportamiento de \verb|\index| se reemplaza por el de \verb|\esindex|, aunque en este caso no es posible introducir entradas que no se adapten a lo requerido por \verb|\esindex|. \item La orden \verb|\ignorewords| da una lista de palabras separadas por comas que no se cuentan en la ordenación. Por ejemplo, con \verb|\ignorewords{de}| tendríamos: $$\mbox{pino albar} < \mbox{pino laricio} < \mbox{pino de montaña}.$$ Distingue la caja, por lo que las formas con mayúsculas hay que darlas explícitamente, si hicieran falta. \end{itemize} La versión 1.4 elimina un pequeño bicho con \verb|"U| y añade nuevas funciones: \begin{itemize} \item La lista de tókenes \verb|\everyesindex| permite dar definiciones locales para establecer el comportamiento de otras órdenes. Por ejemplo: \begin{verbatim} \everyesindex{\renewcommand\emph[1]{#1}} \end{verbatim} elimina de la clave esa orden. Con: \begin{verbatim} \everyesindex{\renewcommand\emph[1]{#1'}} \end{verbatim} la entrada en cursiva iría detrás de la redonda, si la hubiera. Es una técnica que se puede emplear en otros casos para reajustar el orden de entradas idénticas. \item La orden \verb|\esindexsort| permite predefinir claves asociadas a entradas concretas, para ajustar su ordenación (lo que normalmente se consigue añadiendo texto adicional para que makeindex lo tenga en cuenta). Estas correspondencias deben darse antes de la aparición del primer \verb|\esindex| con ese término, y las claves se procesan posteriormente con \verb|ignorespaces|, \verb|\ignorewords| y \verb|\everyesindex|, si están activadas. Por ejemplo: \begin{verbatim} \esindexsort{adonde}{adonde'1} \esindexsort{adónde}{adonde'2} \esindexsort{a donde}{a donde'7} \esindexsort{a dónde}{a donde'8} \end{verbatim} daría el orden \emph{adonde, adónde, a donde, a dónde}, con \verb|ignorespaces|, o bien \emph{a donde, a dónde,} [probablemente otros términos], \emph{adonde, adónde}, sin \verb|ignorespaces|. \end{itemize} \end{document}