diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex | 40 |
1 files changed, 35 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex b/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex index e6f12508fea..56e1c4270cc 100644 --- a/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex +++ b/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex @@ -205,13 +205,13 @@ styles (glossaries):>#1={\protect\ttfamily#1}|main}} \DeleteShortVerb{\|} \MakeShortVerb{"} - \title{glossaries-extra.sty v1.19: + \title{glossaries-extra.sty v1.20: an extension to the glossaries package} \author{Nicola L.C. Talbot\\[10pt] Dickimaw Books\\ \url{http://www.dickimaw-books.com/}} - \date{2017-09-08} + \date{2017-09-11} \maketitle \begin{abstract} @@ -855,13 +855,22 @@ This also has a starred version that doesn't automatically switch off hyperlinks. The individual glossary displaying commands \ics{printglossary}, -\ics{printnoidxglossary} and \cs{printunsrtglossary} have an extra -key \gloskey[printglossary]{target}. This is a boolean key which can +\ics{printnoidxglossary} and \cs{printunsrtglossary} have two extra +keys: + +\begin{itemize} +\item \gloskey[printglossary]{target}. This is a boolean key which can be used to switch off the automatic hypertarget for each entry. Unlike \cs{glsdisablehyper} this doesn't switch off hyperlinks, so any cross-references within the glossary won't be affected. This is a way of avoiding duplicate target warnings if a glossary needs to be displayed multiple times. +\item +\gloskey[printglossary]{targetnameprefix}\texttt{=}\marg{prefix}. Another way +of avoiding duplicate target names is to set a prefix +used for the names. Unlike changing \cs{glolinkprefix} this doesn't affect +any hyperlinks (such as those created with \cs{gls}). +\end{itemize} The \cs{newglossaryentry} command has three new keys: \begin{itemize} @@ -6595,6 +6604,27 @@ avoid duplicate hypertarget names. For example: }% } \end{verbatim} +Note that this will cause a problem if your descriptions +contain commands like \cs{gls} that need to link an entry that +doesn't appear in the summary. In this case, it's a better approach +to use: +\begin{verbatim} +\printunsrtglossary*{% + \renewcommand{\printunsrtglossaryhandler}[1]{% + \glsxtrfieldxifinlist{#1}{record.section}{\thesection} + {\glsxtrunsrtdo{#1}}% + {}% + }% + \ifcsundef{theHsection}% + {% + \setkeys{printgloss}{targetnameprefix={record.#2.\csuse{thesection}.}}% + }% + {% + \setkeys{printgloss}{targetnameprefix={record.#2.\csuse{theHsection}.}}% + }% +} +\end{verbatim} + If it's a short summary at the start of a section, you might also want to suppress the glossary header and add some vertical space afterwards: @@ -6617,7 +6647,7 @@ space afterwards: } \end{verbatim} -There's a shortcut command that does this: +There's a shortcut command that essentially does this: \begin{definition}[\DescribeMacro\printunsrtglossaryunit] \cs{printunsrtglossaryunit}\oarg{options}\marg{counter name} \end{definition} |