News (2018-01-05): glossaries-extra v1.26 released.

# Gallery (All Styles Provided by glossaries)

This is a list of all the styles provided by the glossaries package. You can download the test file used to generate the documents below. The samples here used the test files example-glossaries-brief.tex, example-glossaries-symbols.tex, example-glossaries-childnoname.tex, example-glossaries-parent.tex or example-glossaries-multipar.tex provided with the glossaries package. If you have the glossaries package installed, they should already be on your path. If you get any undefined control sequence or undefined style errors, you probably need to update your version of glossaries. You can click on the sample images below to view the PDF.

The number 1 appearing in red after the description indicates the position of the location (number) list. The locations are all page 1 in these examples, as the entries were all indexed on the first page of the sample document. In general, the location list will typically contain a comma-separated list of page numbers or number ranges. The number list can be suppressed using the nonumberlist option. (The number appears in red because the hyperref package has been loaded with internal hyperlinks set to that colour.)

The glossary is typically divided into groups: symbols, numbers and then each letter group. In the case of the letter groups, the identifying group is given by the initial letter of the sort key. Most of the styles provide a visual separation between the letter groups. This may be either just a vertical gap or a group heading. If your glossary hasn't been sorted alphabetically, then don't have a visual indicator between groups, as the grouping no longer makes sense. Most of the basic predefined styles allow you to suppress the vertical gap between groups with the nogroupskip option.

Note that some styles use the post description hook \glspostdescription. This displays a full stop and adjusts the space factor if nopostdot=false and does nothing if nopostdot=true. The hook can be suppressed on an individual basis by using \nopostdesc in the entry's description. The glossaries-extra package modifies \glspostdescription so that it first does \glsxtrpostdescription, which allows further customization according to the entry's category. Version 1.02 of glossaries-extra provides patches to all the predefined styles that are missing \glspostdescription through the glossaries-extra-stylemods package. For example, to patch the styles in the glossary-longbooktabs package:

\usepackage{glossaries-extra}
\usepackage{glossary-longbooktabs}
\usepackage{glossaries-extra-stylemods}

or, more simply:
\usepackage[stylemods=longbooktabs]{glossaries-extra}


For other examples of glossary styles, see the main gallery.

## glossary-inline

The glossary-inline package must be explicitly loaded using
\usepackage{glossary-inline}

This package only provides one style.

### inline

The inline style is for in-line glossaries. This by default suppresses the location list (regardless of the nonumberlist setting) and the symbol (if provided). The chances are that you will probably also need to suppress the section header, which you can do using
 \renewcommand*{\glossarysection}[2][]{}

or change it to a non-sectioning tag, for example:
 \renewcommand*{\glossarysection}[2][]{\textbf{#2}: }

Note that the post description hook is done just once at the end of the glossary rather than after each entry. The glossaries-extra-stylesmods package changes this style to use just the \glsxtrpostdescription hook after each description, and doesn't use the \glspostdescription hook.

The name is formatted using \glsinlinenameformat. The default definition is:

\newcommand*{\glsinlinenameformat}[2]{\glstarget{#1}{#2}}

This can be redefined as required. For example, to make the name appear in small caps:
\renewcommand*{\glsinlinenameformat}[2]{\glstarget{#1}{\textsc{#2}}}


One-level sub-entries are supported, but the child name won't be displayed. For example, using the example-glossaries-childnoname.tex dummy entries and the subentrycounter option, which automatically numbers the sub-entries:

Note that this inserts a colon between the top-level description and the sub-level entry.

## glossary-list

The glossary-list package is automatically loaded by the glossaries package, unless explicitly excluded using the package option nolist or nostyles. The list styles use a description environment, and the style of that may be changed by the document class. All the list styles ignore the symbol field. You may prefer one of the tree-like styles instead.

Most of the list styles are incompatible with classicthesis. If you are using the classicthesis package with glossaries, you will need to change the default style (unless you are using v4.26+ which checks for classicthesis and switches the default style to index).

### list

The list style puts the name in the optional argument of \item and so is not generally suitable for glossaries with long entry names. It works best with long descriptions. If you have short names and short descriptions, consider using one of the mcol styles. For long names and long descriptions, consider using one of the altlist styles instead. An extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically.

Note that the list style doesn't display the names of sub-entries, and generally doesn't work well with child entries. If I change the test file to example-glossaries-childnoname.tex then the glossary is as shown below. The space before the location list and the dot after it are hard-coded into the sub-entry style, so this style isn't suitable for sub-entries with the location lists suppressed. If you have sub-entries, consider one of the other styles instead. (Versions below 4.22 were missing the space before the sub-entry descriptions, which made the location lists run into the next description, but even with that fixed, it's still not a good style for glossaries with child entries.)

### listgroup

The listgroup style is like the list style but adds a heading to each letter group. This style is inappropriate for entries that haven't been sorted alphabetically.

### listhypergroup

The listhypergroup style is like the listgroup style but also adds a navigation line at the start of the list. There's no point using this style if your document doesn't have hyperlinks.

### altlist

The altlist style is like the list style but inserts a paragraph break after the name. This style is best suited for entries with long names and long descriptions. As with the list style, an extra vertical gap occurs between letter groups.

The altlist style allows one-level child entries and will start a new paragraph for each child entry, but the child name won't be displayed. In the sample below I've used the example-glossaries-childnoname.tex file with the subentrycounter package option, which automatically numbers the sub-entries. This just makes them a bit easier to see in the sample and distinguishes them from the parent entry's description.

### altlistgroup

The altlistgroup style is like the altlist style but adds a heading to each letter group. This style is inappropriate for entries that haven't been sorted alphabetically.

### altlisthypergroup

The altlisthypergroup style is like the altlistgroup style but also adds a navigation line at the start of the list. There's no point using this style if your document doesn't have hyperlinks.

### listdotted

The listdotted style leaves the optional argument of \item empty and after it places a box whose horizontal width is given by \glslistdottedwidth. (This length may be adjusted using \newlength as required.) This box contains the name and dotted leaders. The description is placed after the box. The location list is ignored regardless of the nonumberlist setting. The post description hook is also ignored. This style is only suitable for glossaries with both short entry names and short descriptions. This style inserts an extra vertical gap between groups, so use nogroupskip if you haven't sorted your entries.

This style is inappropriate for child entries. In the sample below, I've used the example-glossaries-parent.tex file with the subentrycounter option on, which automatically numbers the child entries.

The numbering helps to highlight the sub-entries but the hierarchy has been flattened to just the top-level and one sub-level.

### sublistdotted

The sublistdotted style is only suitable for one sub-level hierarchical entries. The parent (top-level) entry only has the name displayed (not the description). The top-level name is placed in the optional argument of \item and so will typically appear bold. This style is not suitable for documents where entries haven't been sorted alphabetically. The post description hook isn't used.

The above sample image shows how poorly this style performs for glossaries with only top-level entries. If the sample file switches from example-glossaries-brief.tex to example-glossaries-parent.tex for the dummy entries, the result is much better:

## glossary-tree

The glossary-tree package is automatically loaded by the glossaries package unless you have used the notree or nostyles options. If you have short descriptions, you might want to consider one of the mcol styles that wrap the tree styles in the multicols environment.

### index

The index style is like a standard index except that the entry name appears in bold (adjust by redefining \glstreenamefmt) and the symbol, if present, is placed in parentheses. A vertical gap appears between each letter group, so use nogroupskip for documents where the entries haven't been sorted alphabetically. As with the standard theindex environment, this only allows for up to three levels (\item, \subitem and \subsubitem).

To illustrate the way this style displays symbols, the test file can be modified to use example-glossaries-symbols.tex instead of example-glossaries-brief.tex. This will also require the package option nopostdot as the symbol dummy entries contain the required sentence terminators.

To illustrate the way this style displays child entries, the test file can be modified to use example-glossaries-parent.tex.

Note that the index style isn't well-suited for multi-paragraph descriptions. To illustrate this, the test file can be modified to use example-glossaries-multipar.tex.

Only the first paragraph of the description for each entry obeys the hanging indent. The subsequent paragraphs have lost the left indent.

This can be overcome for multi-paragraph descriptions in top-level entries with glossaries v4.26 and the following adjustment:

\renewcommand{\glstreeitem}{%
\parindent0pt\par\hangindent40pt
\everypar{\parindent50pt\hangindent40pt}}

This now produces:

This provides a convenient alternative to the list style. An alternative to altlist can be achieved by adding

\renewcommand{\glstreepredesc}{\par
\glstreeitem\parindent\hangindent}


### indexgroup

The indexgroup style is like the index group style but it inserts group headers. This style is not appropriate for documents where the entries haven't been sorted alphabetically.

### indexhypergroup

The indexhypergroup style is like the indexgroup group style but it also has a navigation line at the start of the list. This is only of any use if your document has hyperlinks enabled.

### tree

The tree style is like the index style except that there's no maximum depth for sub-levels (to within the limits of the line width, naturally). Note that the more sub-levels that you have, the more confusing it can be to the reader. As with the index style, a vertical gap is inserted between the letter groups so use nogroupskip if your document doesn't sort the entries alphabetically.

To illustrate the way this style displays child entries, the test file can be modified to use example-glossaries-parent.tex.

### treegroup

The treegroup style is like the tree style but it inserts group headers. This style is not appropriate for documents where the entries haven't been sorted alphabetically.

### treehypergroup

The treehypergroup style is like the treegroup style but it also has a navigation line at the start of the list. This is only of any use if your document has hyperlinks enabled.

### treenoname

The treenoname style is like the tree style except that, as it's designed for homographs, the sub-entries don't have the name displayed. If you don't have any sub-entries, it appears the same as the tree style, so for the sample below I switched the dummy entry file from example-glossaries-brief.tex to example-glossaries-childnoname.tex. As with the tree style, a vertical gap is inserted between the letter groups, but even with the nogroupskip option, this style is still inappropriate for entries that haven't been sorted alphabetically as sub-entries are likely to become separated from their parent entry.

### treenonamegroup

The treenonamegroup style is like the treenoname style but it inserts group headers. As with the treenoname example, the sample below uses the example-glossaries-childnoname.tex test file.

### treenonamehypergroup

The treenonamehypergroup style is like the treenonamegroup style but it also has a navigation line at the start of the list. This is only of any use if your document has hyperlinks enabled. As with the treenoname example, the sample below uses the example-glossaries-childnoname.tex test file.

### alttree

The alttree style is like the tree style except that the width available for the entry names must be supplied by the user. This can be a useful alternative to the tabular-like styles, such as the long style. The widest name can be specified with the command:
\glssetwidest[level]{widest name}

where widest name is the widest entry name. For example, for the test file example-glossaries-brief.tex:
\glssetwidest{consectetuer}

The optional argument can be used to set the name width for sub-levels. (The default value is 0 for the top-level.) If you forget to set the widest entry, the description will overlap the name. If no widest name has been specified for a particular sub-level, then the top-level name is used.

The drawback with this is that it means you need to know the widest name or work it out programmatically by looping over all entries. As from v4.22, the glossary-tree package provides

\glsfindwidesttoplevelname[glossary list]

which iterates over all the glossaries listed in the optional argument and finds the widest name over all entries that don't have a parent. If the optional argument is omitted, the list contains all defined glossaries. For example:
\glsfindwidesttoplevelname
\setglossarystyle{alttree}
\printglossaries

This ensures that all the glossaries have the same width available for the name. Alternatively, you can redefine \glossarypreamble to compute the widest entry just for the current glossary. For example:
\renewcommand{\glossarypreamble}{\glsfindwidesttoplevelname[\currentglossary]}
\setglossarystyle{alttree}
\printglossaries


As with the tree style, a vertical gap is inserted between letter groups, so use the nogroupskip option if your entries aren't sorted alphabetically.

If the widest name for any sub-entry level hasn't been specified, the child names are given the same width box as the top-level names. This can lead to strange results. In the sample below I've used the example-glossaries-parent.tex file with

\renewcommand{\glossarypreamble}{%
\glsfindwidesttoplevelname[\currentglossary]%
}

Since this only sets the widest name for the top-level, the second sub-level isn't wide enough for “nonummy quis” and the third level has excess space.

This can be corrected with

\glssetwidest[1]{nonummy quis}
\glssetwidest[2]{duisnibh}


### alttreegroup

The alttreegroup style is like the alttree style but it inserts group headers. This style is not appropriate for documents where the entries haven't been sorted alphabetically. As with the alttree style, you need to indicate the widest entry name.

### alttreehypergroup

The alttreehypergroup style is like the alttreegroup style but it also has a navigation line at the start of the list. This is only of any use if your document has hyperlinks enabled.

## glossary-mcols

The glossary-mcols package must be explicitly loaded using
\usepackage{glossary-mcols}

This automatically loads the multicol package and the glossary-tree package (if not already loaded). The styles provided by this package are analogous to the tree styles above but the multicols environment is also used. The number of columns is given by \glsmcols, which defaults to 2. For example, to have a three column glossary:
\renewcommand{\glsmcols}{3}
\setglossarystyle{mcolindex}

Take care not to confuse this with the columns within the tabular-like styles, such as the long style.

### mcolindex

The mcolindex style is like the index style but contained within a multicols environment. As with the index style, a vertical gap is inserted between the letter groups so use nogroupskip if your document doesn't sort the entries alphabetically.

### mcolindexgroup

The mcolindexgroup style is like the indexgroup style but contained within a multicols environment. As with the indexgroup style, this style is inappropriate for entries that haven't been alphabetically sorted.

### mcolindexhypergroup

The mcolindexhypergroup style is like the indexhypergroup style but contained within a multicols environment. As with the indexhypergroup style, this style is inappropriate for documents that don't have hyperlinks enabled.

Note that this style bunches up the navigation line at the start of the first column. If you feel this is inappropriate, the next style mcolindexspannav may look better.

### mcolindexspannav

The mcolindexspannav style (new to v4.22) is like the mcolindexhypergroup style but the navigation line is placed inside the optional argument of the multicols environment. This allows it to span across the columns.

### mcoltree

The mcoltree style is like the tree style but contained within a multicols environment. As with the tree style, a vertical gap is inserted between the letter groups so use nogroupskip if your document doesn't sort the entries alphabetically.

### mcoltreegroup

The mcoltreegroup style is like the treegroup style but contained within a multicols environment. As with the treegroup style, this style isn't suitable for documents that don't sort the entries alphabetically.

### mcoltreehypergroup

The mcoltreehypergroup style is like the treehypergroup style but contained within a multicols environment. As with the treehypergroup style, this style is inappropriate for documents that don't have hyperlinks enabled.

Note that this style bunches up the navigation line at the start of the first column. If you feel this is inappropriate, the next style mcoltreespannav may look better.

### mcoltreespannav

The mcoltreespannav style (new to v4.22) is like the mcoltreehypergroup style but the navigation line is placed inside the optional argument of the multicols environment. This allows it to span across the columns.

### mcoltreenoname

The mcoltreenoname style is like the treenoname style but contained within a multicols environment. As with the treenoname example above, the sample below uses the example-glossaries-childnoname.tex test file.

### mcoltreenonamegroup

The mcoltreenonamegroup style is like the treenonamegroup style but contained within a multicols environment. As with the treenonamegroup example above, the sample below uses the example-glossaries-childnoname.tex test file.

### mcoltreenonamehypergroup

The mcoltreenonamehypergroup style is like the treenonamehypergroup style but contained within a multicols environment. As with the treenonamegroup example above, the sample below uses the example-glossaries-childnoname.tex test file.

Note that this style bunches up the navigation line at the start of the first column. If you feel this is inappropriate, the next style mcoltreenonamespannav may look better.

### mcoltreenonamespannav

The mcoltreenonamespannav style (new to v4.22) is like the mcoltreenonamehypergroup style but the navigation line is placed inside the optional argument of the multicols environment. This allows it to span across the columns.

### mcolalttree

The mcolalttree style is like the alttree style but contained within a multicols environment. As with the alttree style, the widest name must be specified using \glssetwidest or \glsfindwidesttoplevelname, as described above for the alttree style.

### mcolalttreegroup

The mcolalttreegroup style is like the alttreegroup style but contained within a multicols environment. Again, the widest name must be specified.

### mcolalttreehypergroup

The mcolalttreehypergroup style is like the alttreehypergroup style but contained within a multicols environment. Again, the widest name must be specified.

Note that this style bunches up the navigation line at the start of the first column. If you feel this is inappropriate, the next style mcolalttreespannav may look better.

### mcolalttreespannav

The mcolalttreespannav style (new to v4.22) is like the mcolalttreehypergroup style but the navigation line is placed inside the optional argument of the multicols environment. This allows it to span across the columns.

## glossary-long

The glossary-long package is automatically loaded by the glossaries package, unless explicitly excluded using the package option nolong or nostyles. The long styles use the longtable environment, so the glossary-long package automatically loads the longtable package.

Take care not to confuse these table styles with the mcols styles.

### long

The long style starts the longtable environment with:
\begin{longtable}{lp{\glsdescwidth}}

The first column (left-aligned) is used for the entry name and the second column (a paragraph column whose width is given by \glsdescwidth) is used for the description and location list. The symbol field is ignored. If you want to change the horizontal alignment of the entire table, you can redefine the theglossary environment after you've set the style. For example:
\setglossarystyle{long}
\renewenvironment{theglossary}%
{\begin{longtable}[l]{lp{\glsdescwidth}}}%
{\end{longtable}}

(see the longtable documentation for further details). Note that the default is to centre the table, but this may not be apparent with brief descriptions. If you temporarily switch to the longborder, style you will be able to see the table bounds.

An extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically.

This style omits the name for sub-entries and is unsuitable for deeper than one-level sub-entries. The sample below uses the example-glossaries-childnoname.tex file with the subentrycounter option set, which automatically numbers the sub-entries.

### longborder

The longborder style is like the long style, but includes vertical and horizontal rules. Note that the long-booktabs style looks better, but this style can be useful for testing purposes if you're not sure how much space the table is occupying.

The longheader style is like the long style, but includes a header row.

The longheaderborder style is like a combination of the longheader and longborder styles. Note that the long-booktabs style looks better.

### long3col

The long3col style is like the long style, but has three columns instead of two. In this style, the longtable environment is begun using:
\begin{longtable}{lp{\glsdescwidth}p{\glspagelistwidth}}

The first column contains the name field, the second column contains the description and the third column contains the location list. Note that, as with the long style, the symbol isn't displayed. Also, this style doesn't use the post description hook, so the nopostdot option is ignored. A vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically.

As with the long style, this style omits the name for sub-entries and is unsuitable for deeper than one-level sub-entries. The sample below uses the example-glossaries-childnoname.tex file with the subentrycounter option set, which automatically numbers the sub-entries.

### long3colborder

The long3colborder style is like the longborder style, but with three columns.

The long3colheader style is like the longheader style, but with three columns.

The long3colheaderborder style is like the longheaderborder style, but with three columns. Note that if you want rules, the long3col-booktabs style looks better.

### long4col

The long4col style is similar the long style, but has four columns instead of two. In this style, the longtable environment is begun using:
\begin{longtable}{llll}

The first column contains the name field, the second column contains the description, the third column contains the symbol, and the final column contains the location list. Note that that all four columns are specified using l which means that no line-breaking is permitted. Therefore this style is only suitable for entries with brief descriptions and an accompanying symbol. A vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. This style doesn't use the post description hook.

Note that the test file loads example-glossaries-brief.tex, which doesn't provide symbols for any of the dummy entries, so the symbol column is blank in the sample below. (The example-glossaries-symbols.tex test file has descriptions that are too long for this style.)

As with the long style, this style omits the name for sub-entries and is unsuitable for deeper than one-level sub-entries. The sample below uses the example-glossaries-childnoname.tex file with the subentrycounter option set, which automatically numbers the sub-entries.

### long4colborder

The long4colborder style is like the long4col style, but includes vertical and horizontal rules. The empty symbol column is more noticeable with this style.

The long4colheader style is like the long4col style, but includes a header row.

The long4colheaderborder style is like the long4col style, but includes a header row and rules. Note that the long4col-booktabs style is preferable.

### altlong4col

The altlong4col style is similar the long4col style, but in this style, the longtable environment is begun using:
\begin{longtable}{lp{\glsdescwidth}lp{\glspagelistwidth}}

This means that multi-lined descriptions and long location lists may be present.

To illustrate the way this style displays symbols, the test file can be modified to use example-glossaries-symbols.tex instead of example-glossaries-brief.tex. A vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. This style doesn't use the post description hook.

As with the long style, this style omits the name for sub-entries and is unsuitable for deeper than one-level sub-entries. The sample below uses the example-glossaries-childnoname.tex file with the subentrycounter option set, which automatically numbers the sub-entries. Since this set of test entries don't have symbols, the symbol column is empty.

### altlong4colborder

The altlong4colborder style is like the altlong4col style, but includes vertical and horizontal rules.

The altlong4colheader style is like the altlong4col style, but includes a header row.

The altlong4colheaderborder style is like the altlong4col style, but includes a header row and vertical and horizontal rules. Note that the altlong4col-booktabs style is preferable.

## glossary-longragged

The glossary-longragged package is not automatically loaded by the glossaries package, but is loaded by the glossary-longbooktabs package, so you either need
\usepackage{glossary-longragged}

or
\usepackage{glossary-longbooktabs}

The glossary-longragged package will automatically load the longtable and array packages. The styles provided in this package are analogous to the styles in the glossary-long package that define paragraph columns. The corresponding styles in this package use \raggedright to make the paragraph columns have ragged-right formatting. With narrow columns, this can look better than forcing normal paragraph justification. Note that there are no equivalent styles to the styles in the glossary-long package that don't have paragraph columns (such as the long4col style).

### longragged

The longragged style is similar the long style, but in this style, the longtable environment is begun using:
\begin{longtable}{l>{\raggedright}p{\glsdescwidth}}

As with the long style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. With brief one-line descriptions, this appears the same as the long style, so the sample images here use the example-glossaries-symbol.tex test file with the nopostdot package option. Note that the symbol isn't displayed with this style.

### longraggedborder

The longraggedborder style is like the longragged style, but includes vertical and horizontal rules.

The longraggedheader style is like the longragged style, but includes vertical and horizontal rules.

The longraggedheaderborder style is like the longragged style, but includes a header row and vertical and horizontal rules. Note that the longragged-booktabs style is preferable.

### longragged3col

The longragged3col style is similar the long3col style, but in this style, the longtable environment is begun using:
\begin{longtable}{l>{\raggedright}p{\glsdescwidth}%
>{\raggedright}p{\glspagelistwidth}}

As with the long3col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. Again the symbol isn't displayed. Note that this style doesn't use the post description hook so the nopostdot setting has no effect.

### longragged3colborder

The longragged3colborder style is like the longragged3col style, but includes vertical and horizontal rules.

The longragged3colheader style is like the longragged3col style, but includes a header row.

The longragged3colheaderborder style is like the longragged3col style, but includes a header row and vertical and horizontal rules. Note that the longragged3col-booktabs style is preferable.

### altlongragged4col

The altlongragged4col style is similar the altlong4col style, but in this style, the longtable environment is begun using:
\begin{longtable}{l>{\raggedright}p{\glsdescwidth}l%
>{\raggedright}p{\glspagelistwidth}}

As with the altlong4col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. Note that this style does use the post description hook, so the nopostdot setting has no effect.

### altlongragged4colborder

The altlongragged4colborder style is like the altlongragged4col style, but includes vertical and horizontal rules.

The altlongragged4colheader style is like the altlongragged4col style, but includes a header row.

The altlongragged4colheaderborder style is like the altlongragged4col style, but includes a header row and vertical and horizontal rules. Note that the altlongragged4col-booktabs style is preferable.

## glossary-longbooktabs

The glossary-longbooktabs style needs to be loaded explicitly, if required, using
\usepackage{glossary-longbooktabs}

This package automatically loads the booktabs package as well as the glossary-long and glossary-longragged packages. The glossary-longbooktabs package applies a patch to the longtable when any of the booktabs glossary styles are set. If the style setting is localised (for example, through the style key in \printglossary), then the patch is also localised. Most of the examples below all use the example-glossaries-symbols.tex test file, which has entries defined with an associated symbol.

### long-booktabs

The long-booktabs style is similar the long style, but there is also a header row, and the horizontal rules \toprule, \midrule and \bottomrule provided by the booktabs package are used. As with the long style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. Note that the symbol isn't displayed with this style.

### long3col-booktabs

The long3col-booktabs style is similar the long3col style, but there is also a header row, and the horizontal rules \toprule, \midrule and \bottomrule provided by the booktabs package are used. As with the long3col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. Note that the symbol isn't displayed with this style nor is the post description hook used.

### long4col-booktabs

The long4col-booktabs style is similar the long4col style, but there is also a header row, and the horizontal rules \toprule, \midrule and \bottomrule provided by the booktabs package are used. As with the long4col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. The test file example-glossaries-symbols.tex can't be used with this example as some of the descriptions are too long, so the example-glossaries-brief.tex file has been used instead. Since none of the entries in that file have symbols, the third column is empty (except for the header). The post description hook isn't used by this style.

### altlong4col-booktabs

The altlong4col-booktabs style is similar the altlong4col style, but there is also a header row, and the horizontal rules \toprule, \midrule and \bottomrule provided by the booktabs package are used. As with the altlong4col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. The post description hook isn't used by this style.

### longragged-booktabs

The longragged-booktabs style is similar the longragged style, but there is also a header row, and the horizontal rules \toprule, \midrule and \bottomrule provided by the booktabs package are used. As with the longragged style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. Note that the symbol isn't displayed with this style.

### longragged3col-booktabs

The longragged3col-booktabs style is similar the longragged3col style, but there is also a header row, and the horizontal rules \toprule, \midrule and \bottomrule provided by the booktabs package are used. As with the longragged3col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. Note that the symbol isn't displayed with this style nor is the post description hook used.

### altlongragged4col-booktabs

The altlongragged4col-booktabs style is similar the altlongragged4col style, but there is also a header row, and the horizontal rules \toprule, \midrule and \bottomrule provided by the booktabs package are used. As with the altlongragged4col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. This style doesn't use the post description hook.

## glossary-super

The glossary-super package is automatically loaded by the glossaries package, unless explicitly excluded using the package option nosuper or nostyles. The super styles use the supertabular environment, so the glossary-super package automatically loads the supertabular package.

Take care not to confuse these table styles with the mcols styles.

These styles are all analogous to the long styles.

### super

The super style starts the supertabular environment with:
\tablehead{}\tabletail{}%
\begin{supertabular}{lp{\glsdescwidth}}

The first column (left-aligned) is used for the entry name and the second column (a paragraph column whose width is given by \glsdescwidth) is used for the description and location list. The symbol field is ignored. Note that, unlike the long style, the glossary isn't centred. The alignment can be changed by redefining the theglossary environment after the super style has been set. For example:
\setglossarystyle{super}
\renewenvironment{theglossary}%
\begin{supertabular}{lp{\glsdescwidth}}}%
{\end{supertabular}}%


This style omits the name for sub-entries and is unsuitable for deeper than one-level sub-entries. The sample below uses the example-glossaries-childnoname.tex file with the subentrycounter option set, which automatically numbers the sub-entries. Note that this example has problematic page breaks. The long style performs much better.

### superborder

The superborder style is like the super style, but includes vertical and horizontal rules.

The superheader style is like the super style, but includes a header row.

The superheaderborder style is like a combination of the superheader and superborder styles.

### super3col

The super3col style is like the super style, but has three columns instead of two. In this style, the supertabular environment is begun using:
\tablehead{}\tabletail{}%
\begin{supertabular}{lp{\glsdescwidth}p{\glspagelistwidth}}

The first column contains the name field, the second column contains the description and the third column contains the location list. Note that, as with the super style, the symbol isn't displayed. Also, this style doesn't use the post description hook, so the nopostdot option is ignored. A vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically.

This style omits the name for sub-entries and is unsuitable for deeper than one-level sub-entries. The sample below uses the example-glossaries-childnoname.tex file with the subentrycounter option set, which automatically numbers the sub-entries. Note that this example has problematic page breaks. The long3col style performs much better.

### super3colborder

The super3colborder style is like the superborder style, but with three columns.

The super3colheader style is like the superheader style, but with three columns.

The super3colheaderborder style is like the superheaderborder style, but with three columns.

### super4col

The super4col style is similar the super style, but has four columns instead of two. In this style, the supertabular environment is begun using:
\tablehead{}\tabletail{}%
\begin{supertabular}{llll}

The first column contains the name field, the second column contains the description, the third column contains the symbol, and the final column contains the location list. Note that that all four columns are specified using l which means that no line-breaking is permitted. Therefore this style is only suitable for entries with brief descriptions and an accompanying symbol. A vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. This style doesn't use the post description hook so the nopostdot option has no effect.

Note that the test file loads example-glossaries-brief.tex, which doesn't provide symbols for any of the dummy entries, so the symbol column is blank in the sample below. (The example-glossaries-symbols.tex test file has descriptions that are too long for this style.)

This style omits the name for sub-entries and is unsuitable for deeper than one-level sub-entries. The sample below uses the example-glossaries-childnoname.tex file with the subentrycounter option set, which automatically numbers the sub-entries.

### super4colborder

The super4colborder style is like the super4col style, but includes vertical and horizontal rules. The empty symbol column is more noticeable with this style.

The super4colheader style is like the super4col style, but includes a header row.

The super4colheaderborder style is like the super4col style, but includes a header row and rules.

### altsuper4col

The altsuper4col style is similar the super4col style, but in this style, the supertabular environment is begun using:
\tablehead{}\tabletail{}%
\begin{supertabular}{lp{\glsdescwidth}lp{\glspagelistwidth}}

This means that multi-lined descriptions and super location lists may be present. Note that this style doesn't use the post description hook, so the nopostdot setting has no effect.

To illustrate the way this style displays symbols, the test file can be modified to use example-glossaries-symbols.tex instead of example-glossaries-brief.tex. A vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically.

This style omits the name for sub-entries and is unsuitable for deeper than one-level sub-entries. The sample below uses the example-glossaries-childnoname.tex file with the subentrycounter option set, which automatically numbers the sub-entries. Note that this example has problematic page breaks. The altlong4col style performs much better.

### altsuper4colborder

The altsuper4colborder style is like the altsuper4col style, but includes vertical and horizontal rules.

The altsuper4colheader style is like the altsuper4col style, but includes a header row.

The altsuper4colheaderborder style is like the altsuper4col style, but includes a header row and vertical and horizontal rules.

## glossary-superragged

The glossary-superragged package is not automatically loaded by the glossaries package, so you need to use
\usepackage{glossary-superragged}

The glossary-superragged package will automatically load the supertabular and array packages. The styles provided in this package are analogous to the styles in the glossary-super package that define paragraph columns. The corresponding styles in this package use \raggedright to make the paragraph columns have ragged-right formatting. With narrow columns, this can look better than forcing normal paragraph justification. Note that there are no equivalent styles to the styles in the glossary-super package that don't have paragraph columns (such as the super4col style).

### superragged

The superragged style is similar the super style, but in this style, the supertabular environment is begun using:
\tablehead{}\tabletail{}%
\begin{supertabular}{l>{\raggedright}p{\glsdescwidth}}

As with the super style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. With brief one-line descriptions, this appears the same as the super style, so the sample images here use the example-glossaries-symbol.tex test file (which have longer descriptions than the brief dummy entries) with the nopostdot package option. Note that the symbol isn't displayed with this style.

### superraggedborder

The superraggedborder style is like the superragged style, but includes vertical and horizontal rules.

The superraggedheader style is like the superragged style, but includes vertical and horizontal rules.

The superraggedheaderborder style is like the superragged style, but includes a header row and vertical and horizontal rules.

### superragged3col

The superragged3col style is similar the super3col style, but in this style, the supertable environment is begun using:
\tablehead{}\tabletail{}%
\begin{supertabular}{l>{\raggedright}p{\glsdescwidth}%
>{\raggedright}p{\glspagelistwidth}}

As with the super3col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. Again the symbol isn't displayed. Note that this style doesn't use the post description hook so the nopostdot setting has no effect.

### superragged3colborder

The superragged3colborder style is like the superragged3col style, but includes vertical and horizontal rules.

The superragged3colheader style is like the superragged3col style, but includes a header row.

The superragged3colheaderborder style is like the superragged3col style, but includes a header row and vertical and horizontal rules.

### altsuperragged4col

The altsuperragged4col style is similar the altsuper4col style, but in this style, the supertabular environment is begun using:
\tablehead{}\tabletail{}%
\begin{supertabular}{l>{\raggedright}p{\glsdescwidth}l%
>{\raggedright}p{\glspagelistwidth}}

As with the altsuper4col style, an extra vertical gap is inserted between letter groups, so use the nogroupskip option if your entries haven't been sorted alphabetically. Note that this style doesn't use the post description hook, so the nopostdot setting has no effect.

### altsuperragged4colborder

The altsuperragged4colborder style is like the altsuperragged4col style, but includes vertical and horizontal rules.