☰

Xindy 和自定义 Hyperref 索引条目

tag-icon • tag-icon xindy
Xindy 和自定义 Hyperref 索引条目

我的目标是使用 来创建索引条目，以便提供指向页面上特定示例的超链接xindy。这源于先前的问题；该问题有可与 配合使用的代码makeindex。它会创建一个.idx包含如下条目的文件：

\indexentry {First example|indexanchor{example:2}}{1(2)}
\indexentry {Second example|indexanchor{example:3}}{1(3)}
\indexentry {Third example|indexanchor{example:4}}{1(4)}

运行这样的.idx文件xindy会产生如下错误，因为xindy将输入解释为交叉引用：

WARNING: unknown cross-reference-class `indexanchor'! (ignored)

如何xindy处理这些文件？

答案1

我想到的解决方案是教人xindy将超链接命令识别为页面引用的类型。（下面的代码不支持页面范围引用，但我没有将其包括在内，因为它与我的应用程序无关。）

代码生成.idx如下文件，其中超链接命令作为页面引用的一部分。（\indexanchor定义如下；"标记只是的转义符{。

\indexentry{First example}{\indexanchor{example:1"}{1(1)"}}
\indexentry{Second example}{\indexanchor{example:2"}{1(2)"}}
\indexentry{Third example}{\indexanchor{example:3"}{1(3)"}}

xindy只需要告知这些页面范围是什么样的。这是xindy-hyperref.xdy：

(define-location-class "page-example-hyperref" ( :sep "\indexanchor{example:" "arabic-numbers" :sep "}{" "arabic-numbers" :sep "(" "arabic-numbers" :sep ")}" ))

为了以正确的格式生成.idx，我需要创建自己的输出结构。（如果有人有更优雅的方式来重新定义索引包中的宏，我会很感兴趣。当涉及到它时，我很惊讶编写自己的索引代码是多么简单。）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}

编译示例：

xelatex xindy-hyperref.tex
texindy -L english xindy-hyperref.idx -o xindy-hyperref.ind -M xindy-hyperref
xelatex xindy-hyperref.tex

相关内容