显示词汇表中的特定位置

Question 1

版本 4.16glossaries现在有一个钩子\glswriteentry，用于确定是否对诸如之类的命令执行索引\gls。默认定义是：

\newcommand*{\glswriteentry}[2]{%
  \ifglsindexonlyfirst
    \ifglsused{#1}{}{#2}%
  \else
    #2%
  \fi
}

第一个参数是条目的标签，第二个参数是实际执行索引的代码，因此默认定义检查indexonlyfirst包选项，并且仅#2在第一次使用时执行indexonlyfirst=true。

如果您只是想在词汇表开始时关闭索引，您可以重新定义\glswriteentry为在之前不执行任何操作\printglossaries：

\renewcommand*{\glswriteentry}[2]{}

您还可以将此机制用于更复杂的情况，例如首先仅使用特定词汇表类型的索引：

\renewcommand*{\glswriteentry}[2]{%
 \ifthenelse{\equal{\glsentrytype{#1}}{acronym}}
 {\ifglsused{#1}{}{#2}}%
 {#2}%
}

或者，你可以调整sample-chap-hyperfirst.tex例如，它也只对每个章节执行一次索引。

如果您想添加新密钥，如在另一个答案中一样，您可以在中测试密钥的设置\glswriteentry。例如：

\define@boolkey{glslink}{index}[true]{}
\KV@glslink@indexfalse

\renewcommand*{\glswriteentry}[2]{\ifKV@glslink@index #2\fi}

（这需要放在包中或放置在\makeatletter和之间\makeatother。）由于默认值设置为 false，因此除非您明确使用\gls[index]{label}（或类似方法）将其打开，否则不会发生索引。

请注意，\glswriteentry不使用\glsadd（或\glsaddall），因为的全部目的\glsadd是添加索引信息。

更新：

这glossaries-extra扩展了该glossaries包的包，提供了noindexkey（上述 key 的否定index）。它还提供了一种应用于indexonlyfirst特定条目类别的方法。

请注意，glossaries-extra为缩写提供了一种新的（更灵活的）机制。如果您想继续使用\newacronym，则需要使用以下方式设置样式：

\setabbreviationstyle[acronym]{long-short}

或者，替换\newacronym为\newabbreviation。

例如，indexonlyfirst仅适用于首字母缩略词：

\documentclass{scrartcl}
\usepackage{blindtext}
\usepackage{hyperref}
\usepackage[xindy]{glossaries-extra}
\makeglossaries

\glssetcategoryattribute{acronym}{indexonlyfirst}{true}

\newglossaryentry{ex}{name={sample},description={an example}}
\newglossaryentry{oe}{name={{\"o}l},description={{\"O}l}}

\setabbreviationstyle[acronym]{long-short}
\newacronym{svm}{SVM}{support vector machine}

\begin{document}

\gls{ex} liegt im \gls{oe}.

First use: \gls{svm}. Second use: \gls{svm}.

\Blindtext[2][3]

\gls{svm}

\printglossaries

\end{document}

或者，从切换\newacronym到\newabbreviation：

\documentclass{scrartcl}
\usepackage{blindtext}
\usepackage{hyperref}
\usepackage[xindy]{glossaries-extra}
\makeglossaries

\glssetcategoryattribute{abbreviation}{indexonlyfirst}{true}

\newglossaryentry{ex}{name={sample},description={an example}}
\newglossaryentry{oe}{name={{\"o}l},description={{\"O}l}}

\newabbreviation{svm}{SVM}{support vector machine}

\begin{document}

\gls{ex} liegt im \gls{oe}.

First use: \gls{svm}. Second use: \gls{svm}.

\Blindtext[2][3]

\gls{svm}

\printglossaries

\end{document}

可以使用来抑制特定条目的索引\gls[noindex]{svm}。除了使用之外indexonlyfirst，您还可以将其设置noindex=true为默认值：

\GlsXtrSetDefaultGlsOpts{noindex}

这意味着现在\glsetc 不会自动索引条目，除非在可选参数中明确覆盖此新默认值，例如\gls[noindex=false]{svm}。如果第一次使用不是最重要的用途，这将很有用。由于编写有点麻烦[noindex=false]，您可以使用设置快捷方式。这允许您为等命令\GlsXtrSetAltModifier设置第三个修饰符（除了*和）。例如：+\gls

\GlsXtrSetAltModifier{>}{noindex=false}

这意味着\gls>{svm}现在等同于\gls[noindex=false]{svm}。您可以根据需要使用其他字符，但它只能是一个字符（并且您需要小心更改类别代码）。

以下索引了的第一次使用oe和svm但的第二次使用ex：

\documentclass{scrartcl}
\usepackage{blindtext}
\usepackage{hyperref}
\usepackage[xindy]{glossaries-extra}
\makeglossaries

\GlsXtrSetDefaultGlsOpts{noindex}
\GlsXtrSetAltModifier{>}{noindex=false}

\newglossaryentry{ex}{name={sample},description={an example}}
\newglossaryentry{oe}{name={{\"o}l},description={{\"O}l}}

\newabbreviation{svm}{SVM}{support vector machine}

\begin{document}

\gls{ex} liegt im \gls>{oe}.

First use: \gls>{svm}. Second use: \gls{svm}.

\Blindtext[2][3]

\gls{svm}, \gls>{ex}.

\printglossaries

\end{document}

Answer