Meu objetivo é ter entradas de índice que forneçam hiperlinks para exemplos específicos em uma página, usando xindy. Isto decorre de umpergunta anterior; essa pergunta tem um código que funciona com makeindex. Ele cria um .idxarquivo com entradas como esta:
\indexentry {First example|indexanchor{example:2}}{1(2)}
\indexentry {Second example|indexanchor{example:3}}{1(3)}
\indexentry {Third example|indexanchor{example:4}}{1(4)}
A execução de tal .idxarquivo xindyproduz erros como este, pois xindyinterpreta a entrada como referências cruzadas:
WARNING: unknown cross-reference-class `indexanchor'! (ignored)
Como posso xindyprocessar esses arquivos?
Responder1
A solução que encontrei é ensinar xindya reconhecer comandos de hiperlink como tipos de referências de página. (O código a seguir não permite referências de intervalo de páginas, mas simplesmente não incluí isso porque é irrelevante para meu aplicativo.)
O código gera um .idxarquivo como este, com o comando do hiperlink incluído como parte da referência da página. ( \indexanchoré definido abaixo; as "marcas são apenas escapes para {.
\indexentry{First example}{\indexanchor{example:1"}{1(1)"}}
\indexentry{Second example}{\indexanchor{example:2"}{1(2)"}}
\indexentry{Third example}{\indexanchor{example:3"}{1(3)"}}
xindysó precisa saber como são esses intervalos de páginas. Isso é xindy-hyperref.xdy:
(define-location-class "page-example-hyperref" ( :sep "\indexanchor{example:" "arabic-numbers" :sep "}{" "arabic-numbers" :sep "(" "arabic-numbers" :sep ")}" ))
Para produzir .idxno formato adequado, precisei criar minha própria estrutura de saída. (Eu ficaria interessado se alguém tivesse uma maneira mais elegante de redefinir uma macro a partir de um pacote de indexação. Quando cheguei a esse ponto, fiquei surpreso com o quão simples era escrever meu próprio código de indexação.)xindy-hyperref.tex:
\documentclass{book}
\usepackage{expex,hyperref,lipsum}
% open the index file
\newwrite\outputstream
\immediate\openout\outputstream=xindy-hyperref.idx
% Index references like 2(3)
\newcommand{\PageExample}{\thepage (\the\excnt)}
% Write the index entries to a file
\def\xindex#1#2#3{%
\immediate\write#3{\string\indexentry {#2}{\string\indexanchor{example:\the\excnt"}{\PageExample"}}}
}
\def\indexanchor#1#2{\hyperlink{#1}{#2}}
% clean output
\def\iex#1{%
\xindex{my-index}{#1}{\outputstream}%
\ex %
\raisebox{\baselineskip}{\hypertarget{example:\the\excnt}{}}\ignorespaces}
\begin{document}
\iex{First example} \lipsum[1] \xe
\iex{Second example} \lipsum[2] \xe
\iex{Third example} \lipsum[3] \xe
\iex{Fourth example} \lipsum[4] \xe
\iex{Fifth example} \lipsum[5] \xe
\iex{Sixth example} \lipsum[6] \xe
\iex{Seventh example} \lipsum[7] \xe
\InputIfFileExists{xindy-hyperref.ind}{}{}
\end{document}
Para compilar o exemplo:
xelatex xindy-hyperref.tex
texindy -L english xindy-hyperref.idx -o xindy-hyperref.ind -M xindy-hyperref
xelatex xindy-hyperref.tex