From 8db1d9ae4386e820a532cc623a875cdca0e5d9fc Mon Sep 17 00:00:00 2001
From: Karl Berry
glossaries-extra.sty v1.23: an extension to the
+class="cmr-17">glossaries-extra.sty v1.24: an extension to the
glossaries package
2017-11-12
-
+
This uses a global assignment. If you need to scope the change you can +use +
+
-
The commands The commands \glossentryname and \glossentrydesc§
If you want to adapt a style to use another field instead of If you want to adapt a style to use another field instead of name, you can
use
-
+
This behaves just like \glossentryname (that is, it obeys description). See the key to field mappings table in the glossaries user
manual.
- There is a hook after There is a hook after \glossentryname and \Glossentryname:
-
+
By default this checks the indexname attribute. If the attribute exists for the
category to which the label belongs, then the name is automatically indexed
using
-
+
See §7 Auto-Indexing for further details.
- As from version 1.04, the post-name hook As from version 1.04, the post-name hook \glsxtrpostnamehook will also use
\glsxtrpostname⟨ (\glsentrysymbol{\glscurrententrylabel})}
- The post-description code used within the glossary is modified so that it also
+
+ The post-description code used within the glossary is modified so that it also
does
-
+
This occurs before the original \glspostdescription, so if the nopostdot=false
option is used, it will be inserted before the terminating full stop.
- This new command will do This new command will do \glsxtrpostdesc⟨category⟩ if it exists, where
⟨general\glsxtrpostdescacronym Since both Since both \glossentry and \subglossentry set
-
+
to the label for the current entry, you can use this within the definition of these
post-description hooks if you need to reference the label.
- For example, suppose you want to insert the plural form in brackets after the
+ For example, suppose you want to insert the plural form in brackets after the
description in the glossary, but only for entries in the general category, then you could
@@ -5664,10 +5676,10 @@ do:
\renewcommand{\glsxtrpostdescgeneral}{\space
This means you don’t have to define a custom glossary style, which you may find
+ This means you don’t have to define a custom glossary style, which you may find
more complicated. (It also allows more flexibility if you decide to change the
underlying glossary style.)
-
-
+
+
The The number list is now placed inside the argument of
-
+
This is internally used by \glossaryentrynumbers. The \glossaryentrynumbers so that it doesn’t display th
id="dx1-16004">number list, but it
still saves the number list in case it’s required.
-
- If you want to, for example, change the font for the entire
+ If you want to, for example, change the font for the entire number list
then redefine \GlsXtrFormatLocationList as appropriate. Don’t modify
\glossaryentrynumbers.
- Sometimes users like to insert “page” or “pages” in front of the Sometimes users like to insert “page” or “pages” in front of the number list. This
is quite fiddly to do with the base glossaries package, but glossaries-extra provides a
way of doing this. First you need to enable this option and specify the text to display
using:
-
+
where ⟨page⟩ is the text to display if the number list only contains a single location and
@@ -5758,28 +5770,28 @@ class="cmti-10">pages An extra run is required when using this command.
- An extra run is required when using this command.
+
- See the accompanying sample file
+ See the accompanying sample file sample-pages.tex.
- Note that Note that bib2gls
+
As from v1.02, As from v1.02, glossaries-extra now includes the package glossaries-extra-stylemods that
@@ -5796,7 +5808,7 @@ class="cmss-10">glossaries-extra Alternatively you can load Alternatively you can load glossary-⟨name⟩.sty at the same time by passing ⟨glossaries-extra-stylemods\usepackage[longragged]{glossaries-extra-stylemods}
Another option is to use the Another option is to use the stylemods key when you load long3col
\usepackage[style=long3col,stylemods]{glossaries-extra}
Or the value of Or the value of stylemods may be a comma-separated list of the style package
@@ -5841,7 +5853,7 @@ identifiers. For example:
Remember to group the value if it contains any commas:
+ Remember to group the value if it contains any commas:
@@ -5849,8 +5861,8 @@ identifiers. For example:
- Note that the
+ Note that the inline style is dealt with slightly differently. The original definition
provided by the nopostdot The The tabular-like styles, such as \printglossary, \printnoidxglossary or \printunsrtglossary, you must also
reset the glossary style.
- As from version 1.21, the hard-coded As from version 1.21, the hard-coded \space before the number list in many of
the predefined styles is replaced with
-
+
This just defaults to \space but may be redefined as required. For example:
@@ -5922,27 +5934,27 @@ class="cmtt-10">\space
- The
+
+
(which defaults to \glsxtrprelocation) for top-level items and
-
+
(which defaults to \glslistprelocation) for child items.
- For just the For just the list style and its letter group variations (not the altlistlistdotted
+
which defaults to a full stop.
- The default value of The default value of \glslistdottedwidth is changed so that it’s set at the start
of the document (if it hasn’t been changed in the preamble). This should
take into account situations where \hsize isn’t set until the start of the
document.
- The The index-like and tree-like styles insert the pre-number list space with
-
+
(which defaults to \glsxtrprelocation) for top-level items and
-
+
(which defaults to \glstreeprelocation) for child items.
- As from version 1.05, the As from version 1.05, the glossaries-extra-stylemods package provides some
additional commands for use with the alttreenotree
+
(New to version 1.21.) This is like \glssetwidest (provided by glossary-tree) but
performs a global assignment.
-
+
This is like \glssetwidest but performs a protected expansion on ⟨name⟩. This has a
localised effect. For a global setting, use
-
+
The following only set the value if ⟨name⟩ is wider than the current value (new to
version 1.23). Local update:
-
+
Global update:
-
+
Locale update (expands ⟨name⟩):
-
+
Global update (expands ⟨name⟩):
-
- The widest entry value can later be retrieved using
-
+ The widest entry value can later be retrieved using
+
+
for the top-level entries and
-
+
for sub-entries, where ⟨level⟩ is the level number.
- The command The command \glsfindwidesttoplevelname provided by glossary-tree has a
CamelCase synonym:
-
+
Similar commands are also provided:
-
+
This has an additional check that the entry has been used. Naturally this is only
useful if the glossaries that use the alttreealttree
+
This is like the previous command but if doesn’t check the parent key. This is useful if
@@ -6173,17 +6185,17 @@ class="cmss-10">parent
+
This is like the previous command but doesn’t check if the entry has been
used.
-
+
This is like \glsFindWidestUsedTopLevelName but also sets the first two sub-levels
as well. Any entry that has a great-grandparent is ignored.
-
+
This is like the previous command but doesn’t check if the entry has been
used.
-
+
This is like \glsFindWidestUsedAnyName but also measures the symbol. The length
of the widest symbol is stored in ⟨register⟩.
-
+
This is like the previous command but it doesn’t check if the entry has been
used.
-
+
This is like \glsFindWidestUsedAnyNameSymbol but also measures the symbol register
+
This is like the previous command but it doesn’t check if the entry has been
used.
-
+
This is like \glsFindWidestUsedAnyNameSymbolLocation but doesn’t measure the
symbol. The length of the widest number list is stored in ⟨register⟩.
-
+
This is like the previous command but doesn’t check if the entry has been
used.
- The layout of the symbol, description and The layout of the symbol, description and number list is governed by
-
+
for top-level entries and
-
+
for sub-entries.
- There is now a user level command that performs the initialisation for the There is now a user level command that performs the initialisation for the alttree
style:
-
- The paragraph indent for subsequent paragraphs in multi-paragraph descriptions
+
+ The paragraph indent for subsequent paragraphs in multi-paragraph descriptions
is provided by the length
- Abbreviations include acronyms (words formed from initial letters, such as
+ Abbreviations include acronyms (words formed from initial letters, such as
“laser”), initialisms (initial letters of a phrase, such as “html”, that aren’t
pronounced as words) and contractions (where parts of words are omitted, often
replaced by an apostrophe, such as “don’t”). The “acronym” code provided by the
@@ -6392,10 +6404,10 @@ to be described for readers unfamiliar with the term). They are therefore
more like a regular term, which may or may not require a description in the
glossary.
- The The glossaries-extra package corrects this misnomer, and provides better
abbreviation handling, with
-
- This sets the
+ This sets the category key to abbreviation by default, but that value may be
@@ -6433,7 +6445,7 @@ href="#sec:categories">§5
Categories for further details.
- See See §2.6 Nested Links regarding the pitfalls of using commands like \glsxtrshort within ⟨short⟩ or ⟨long⟩.
-
- The
+ The \newacronym command provided by the glossaries package is redefined by
@@ -6461,7 +6473,7 @@ class="cmtt-10">acronym
+
is
now
equivalent
@@ -6500,7 +6512,7 @@ class="cmtt-10">} The The \newabbreviation command is superficially similar to the glossaries
package’s abbreviationglossaries The way the abbreviations are displayed by commands like The way the abbreviations are displayed by commands like \gls varies according
to the abbreviation style. The styles are set according to the entry’s category so,
unlike the base glossaries package, you can have different abbreviation styles within
the same glossary.
- There are two types of full forms. The display full form, which is used on
+ There are two types of full forms. The display full form, which is used on
first use by commands like short-footnote, the display and inline full forms are
different.
- These formatting commands aren’t stored in the These formatting commands aren’t stored in the short, shortplural\glsxtrlong You can apply the formatting command used for the short form to some arbitrary
+ You can apply the formatting command used for the short form to some arbitrary
text using
-
+
where ⟨category⟩ is the category label that identifies the abbreviation style. Similarly
for the formatting command use by the long form:
-
+
If you would like to tag the initial letters in the long form such that those letters are
+ If you would like to tag the initial letters in the long form such that those letters are
underlined in the glossary but not in the main part of the document, you can
use
-
+
before you define your abbreviations.
- This command (robustly) defines ⟨ This command (robustly) defines ⟨cs⟩ (a control sequence) to accept a single
argument, which is the letter (or letters) that needs to be tagged. The normal
behaviour of this command within the document is to simply do its argument, but in
@@ -6623,21 +6635,21 @@ href="#catattr.tagging">tagging attribute set to
“true”. For those cases it will use
-
+
This command defaults to \underline{⟨text⟩} but may be redefined as required.
- The control sequence ⟨ The control sequence ⟨cs⟩ can’t already be defined when used with the unstarred
version of \GlsXtrEnableInitialTagging for safety reasons. The starred
@@ -6646,7 +6658,7 @@ class="cmti-10">cs The first argument of The first argument of \GlsXtrEnableInitialTagging is a comma-separated list
of category names. The §5 Categories) but
this must be done before the glossary is displayed.
- The accompanying sample file The accompanying sample file sample-mixtures.tex uses initial tagging for both
the acronymabbreviation This defines the command This defines the command \itag which can be used in the definitions. For
example:
@@ -6690,18 +6702,18 @@ example:
The underlining of the tagged letters only occurs in the glossary and then only for
+ The underlining of the tagged letters only occurs in the glossary and then only for
entries with the tagging attribute set.
-
+
The abbreviation style must be set before abbreviations are defined using:
- The abbreviation style must be set before abbreviations are defined using:
+
+
where ⟨style-name⟩ is the name of the style and ⟨category⟩ is the category label
@@ -6733,11 +6745,11 @@ class="cmss-10">regular
- Note that
+ Note that \setacronymstyle is disabled by glossaries-extra. Use Abbreviations can be used with the standard Abbreviations can be used with the standard glossaries commands, such as \gls,
@@ -6768,7 +6780,7 @@ class="cmtt-10">\acrshort
+
(Use this instead of \acrshort.)
- The long form can be produced with
- The long form can be produced with
+
+
(Use this instead of \acrlong.)
- The The inline full form can be produced with
-
+
(This this instead of \acrfull.)
-
- As mentioned earlier, the inline full form may not necessarily match the format
+
+ As mentioned earlier, the inline full form may not necessarily match the format
used on first use with short-nolongfirst use, but the full form will display the long form followed by the
short form in parentheses.
-
- The arguments ⟨
+ The arguments ⟨options⟩, ⟨label⟩ and ⟨insert⟩ are the same as for commands such as
\glstext. There are also analogous case-changing commands:
- First letter upper case short form:
- First letter upper case short form:
+
- First letter upper case long form:
-
+ First letter upper case long form:
+
- First letter upper case inline full form:
-
+ First letter upper case inline full form:
+
- All upper case short form:
+
+ All upper case short form:
-
- All upper case long form:
-
+ All upper case long form:
+
- All upper case inline full form:
-
+ All upper case inline full form:
+
- Plural forms are also available.
- Short form plurals:
-
+ Plural forms are also available.
+ Short form plurals:
+
-
+
-
+
- Long form plurals:
-
+ Long form plurals:
+
-
+
-
+
- Full form plurals:
-
+ Full form plurals:
+
-
+
-
+
-
+
-
+
+
The abbreviation shortcut commands can be enabled using the package option
+ The abbreviation shortcut commands can be enabled using the package option
shortcutstable 3.1.
- There are two types of abbreviation styles: those that treat the abbreviation as a
+ There are two types of abbreviation styles: those that treat the abbreviation as a
regular entry (so that \gls uses \gls uses \glsxtrgenabbrvfmt).
- The regular entry abbreviation styles set the The regular entry abbreviation styles set the regular attribute to “true” for the
@@ -7442,7 +7454,7 @@ class="cmss-10">long The other abbreviation styles don’t modify the The other abbreviation styles don’t modify the regular attribute. The \glsxtrfullformat that are defined by the
style).
- In both cases, the In both cases, the first use of \gls may not match the text produced by
\glsfirst (and likewise for the plural and case-changing versions).
- The sample file The sample file sample-abbr-styles.tex demonstrates all predefined styles
described here.
-
- The parenthetical styles, such as
+ The parenthetical styles, such as long-short, use
-
+
to set the parenthetical material. This just puts parentheses around the text:
(⟨text⟩).
- The basic abbreviation styles, such as The basic abbreviation styles, such as long-short and short-long use
-
+
for the short form. This just does ⟨text⟩ by default. (That is, no font change is
applied.) On first use,
-
+
is used instead. By default, this just does \glsabbrvdefaultfont. The long form is
formatted according to
-
+
which again just does ⟨text⟩ (no font change). On first use,
-
+
is used instead. This just does \glslongdefaultfont. The plural suffix used for the
short form is given by
-
+
which defaults to \glspluralsuffix.
- The small-cap styles, such as The small-cap styles, such as long-short-sc and short-sc-long, use
-
+
which uses \textsc.3.1
On first use
-
+
is used instead. This uses \glsabbrvscfont by default. So redefine, \glsabbrvscfont
to change first and subsequent uses or \glsfirstabbrvscfont to change just the
first use.
- The long form for the small-cap styles uses The long form for the small-cap styles uses \glslongdefaultfont or
\glsfirstlongdefaultfont, as with the basic style. The suffix is given
by
-
-
-
-
-
-
(plural: \glsentryplural{\glscurrententrylabel})}
2.9.2 Number List
-
-
-2.9.3 The glossaries-extra-stylemods Package
-
\usepackage{glossary-longragged}
\usepackage{glossaries-extra-stylemods}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-3. Abbreviations
-
-
-
-
-3.1 Tagging Initials
-
-
-
\newabbreviation{xml}{XML}
{e\itag{x}tensible \itag{m}arkup \itag{l}anguage}
3.2 Abbreviation Styles
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-3.3 Shortcut Commands
-
-3.4 Predefined Abbreviation Styles
-
-
-
-
-
-
-
-
-