在 LaTeX \indexentry 中包含散列标记，别名为 \newcommand

Question

这是一个奇怪的现象。我必须做一些有趣的解决方法才能让它发挥一点作用，但我们还有另一个绊脚石。

我一直在努力创建一个使用大型 .ind 文件的单独文档（使用 makeindex 从串联的小型单独 .idx 文件创建的索引），其想法是我最终将拥有一个指示子文档的单个文档，并且索引数据出现的页码。

为此，我必须定义一个收集所有索引条目的命令，如下所示：

\newcommand{\myindexer}[3]
    {\index{myindex}{#1 : #2.#3!\href{\doctitle.pdf}}}

结果是 myindex.idx 文件中的索引条目如下：

\indexentry{IndexedItemA : 55.iii!\href{Volume 1.pdf}{Volume 1.pdf}}{30}}
\indexentry{IndexedItemB : 23.vi!\href{Volume 3.pdf}{Volume 3.pdf}}{114}}

然而，在尝试创建目标 PDF 的超引用时存在问题。为了在特定页面打开 PDF，需要采用以下格式（感谢本板上的其他人指出了 hyperref 包中的 #page.xx 语法）：

\href{FILENAME#page.XX}{Link Text}

wihch 意味着需要使用散列标记声明 myindex 时，包含在 \newcommand 的输出流中，可能使用转义哈希标记 # as:

\newcommand{\myindexer}[3]
    {\index{myindex}{#1 : #2.#3!\href{\doctitle.pdf\#page.\thepage}}}

或根据我发现 某处 的某些片段，使用双哈希标记 as:

\newcommand{\myindexer}[3]
    {\index{myindex}{#1 : #2.#3!\href{\doctitle.pdf##page.\thepage}}}

前者导致在为正在索引的多个文档编译 Latex 源期间出现以下错误：

! Illegal parameter number in definition of \@gtempa.
<to be read again>
                   \thepage
l.31 \myindex{IndexedItemA}{55}{iii}

而后者会导致生成的 myindex.idx 文件中出现不需要的反斜杠：

\indexentry{IndexedItemA : 55.iii!\href  {Volume 1.pdf\#page.33}{Volume 1}}{33}

这会导致目标 PDF 无法正确打开。

知道如何强制 new 命令输出哈希标记以支持 PDF 的超链接吗？

Answer 1

将 \href 包装在 \protect 中怎么样？

Answer 2

你可以交换#和%的catcode：

\catcode`\%=6 \catcode`\#=12

然后用%来标记参数：

\newcommand{\myindexer}[3]
    {\index{myindex}{%1 : %2.%3!\href{\doctitle.pdf#page.\thepage}}}

之后恢复通常的catcodes：

\catcode`\%=12 \catcode`\#=6

这有点笨拙，但即使某些东西干扰了通常的转义机制，它也应该可以工作，并且它允许在点 \myindexer< 处扩展 \href使用/代码>。