diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/bezos/esindex.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/bezos/esindex.tex | 179 |
1 files changed, 179 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bezos/esindex.tex b/Master/texmf-dist/doc/latex/bezos/esindex.tex new file mode 100644 index 00000000000..6e042442913 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bezos/esindex.tex @@ -0,0 +1,179 @@ +% +--------------------------------------------------+ +% | 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 <<a mano>>, +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} |