☰

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

相關內容