About 🛈
Shop 🛒Shop 🛒
LaTeX 🖹
Software 💾
Books 📚
Gallery 🖺
News 📢
Contact 📧
Blog 🖋
Smashwords Summer/Winter Sale 1st July – 31st July 2019: 75% off ebook crime fiction novel The Private Enemy, and 100% off (free!) ebook crime short story I've Heard the Mermaid Sing.


A selection of images related to my books or packages or to code I have helped develop. For some great examples of images created using LaTeX, have a look at the TikZ and PGF gallery on texample.net, or for some examples of what can be done with TeX have a look at The TeX showcase.


These are some sample glossary styles created using the glossaries package. All these examples use dummy lorum ipsum text, one of them uses the sample images files provided by the mwe package, which is available on both MiKTeX and TeX Live, and one of them uses the sample bibliography file xampl.bib, which should be readily available in your TeX distribution. Make sure you have an up-to-date version of the glossaries package if you want to try any of these examples.

There are also some samples of each of the predefined styles on a separate page.

The purpose of this section of the gallery is to illustrate various styles that can be created with the glossaries package. If you want to know how to do something not illustrated here or you want to know how to adapt one of these examples, please post your query to an appropriate site such as TeX on StackExchange or The LaTeX Community Forum.

Click on the images below for details of the example.

Brief Descriptions

Image of brief descriptions sample

Long Descriptions

Image of long descriptions sample

Multi-Paragraph Descriptions

Image of multipar descriptions sample

Symbols Glossary

Image of symbols glossary sample

Images in Glossary

Image of images in glossary sample

Hierarchical Entries

Image of hierarchical sample

Homograph Entries

Image of homograph sample

Citations in Glossary

Image of citations in glossary sample


Image of cross-references sample

URLs in Glossary

Image of urls in glossary sample

Abbreviations (No Descriptions)

Image of abbreviations (no description) sample

Abbreviations (With Descriptions)

Image of abbreviations (with description) sample

Abbreviations (With Translations)

See also the glossaries-extra version of this example below.

Image of abbreviations (with translations) sample

Mixed Glossary

Image of mixed glossary sample

Mixed Glossary with Emphasis

Image of mixed glossary with emphasis sample

Units (glossaries.sty)

This example is a modification of the Units (glossaries-extra) example, listed below. The symbolic representation is in the name field and the symbol name is now in the symbol field. The first field is used to alter the first use representation.

Image of units example


The glossaries-extra package is an extension to the glossaries package. It provides better abbreviation handling and extra features.


The dots in the abbreviations in this example are automatically inserted through the use of category attributes. The sentence terminator following commands like \gls can be automatically discarded for those entries.

Image of initialisms sample

Abbreviations With Translations

An alternative to the earlier glossaries.sty example this example uses the more convenient glossaries-extra settings.

Image of abbreviations with translations sample

Mixing Styles

This rather colourful example isn't encouraging garish documents, but is illustrating how you can apply different styles to entries according to their category and category attributes. With just the basic glossaries.sty package, different styles may only be applied per glossary type, whereas in this example all entries are in the same glossary.

Image of mixed styles sample

Adjusting Parenthetical Style

This example adjusts the user parenthetical style so that only the long form is displayed on first use and the short form on subsequent use. Both the long and short form are emphasized.

Image of user parenthetical style sample

Abbreviations with Footnotes Sample

This example compares the footnote and postfootnote styles (using the small-caps variant).

Image of footnote styles sample

Adjusting the alttree Style

The alttree style is redefined by the glossaries-extra-stylemods package to make it more flexible. This example uses the commands provided by this package to adjust the style. The location list and associated image are placed in the right margin and the entry name is on the left.

Image of alttree stylemods sample

Abbreviation Styles

This example demonstrates the predefined abbreviation styles.

Image of abbreviation styles sample


This example demonstrates the use of the alias key.

Image of aliases example

Units (glossaries-extra.sty)

This example demonstrates the use of the category key in combination with the post-link hook to append the entry's symbol in the text on first use. This is an alternative to using the abbreviation mechanism.

Image of units example

Standalone Entries

Instead of displaying a sorted list, this example uses standalone entries. Since no sorting or indexing is required, the build process is quite simple.

Image of standalone example


This example provides an environment that displays a mini list of terms at the end of it. This is in addition to the main glossary at the end of the document.

Image of mini-glossary example


With the base glossaries package you can sort and collate using makeindex or xindy or using TeX. (See the glossaries performance page for a comparison.)

The glossaries-extra package additionally provides a way of simply listing all defined entries in the order of definition without the need for an external tool, but it also provides another sorting and collation method and that's with bib2gls. Some of the examples below can be found in bib2gls's examples directory and are described in more detail in the ‘Examples’ chapter of the bib2gls user manual.

Logical Glossary Divisions (type vs group vs parent)

There's a new section added to the bib2gls manual (version 1.9) regarding this topic. This example is an abridged version of that section. If you have a document with many terms that need listing, it's likely that you may want to divide the terms into separate blocks for easier reading, but should you use type, group or parent?

Image of logical divisions example

Constants (bib2gls)

In this example, all defined entries are selected (without being referenced in the document) and listed in numerical order, where the numeric value is the approximate value of the given constant.

Image of bib2gls constants example

Icons (bib2gls)

In this example, all defined entries are selected (without being referenced in the document) and sorted according to the description field since the name is a symbol with no intuitive order.

Image of bib2gls icons example

Mini-Glossary (bib2gls)

This example is an alternative to the earlier mini-glossary example with \makeglossaries. It provides an environment that displays a mini list of terms at the end of it. This is in addition to the main glossary at the end of the document.

Image of mini-glossary bib2gls example



Documents that use the datatool package can take a long time to run, but there are ways to speed things up, especially if you use the datatooltk helper application.

Image of datatooltk


Documents that use the glossaries package can take a long time to run, but different options can improve the build time, depending on your requirements.

Image of test document


Paulo Cereda's cool automation tool arara is being upgraded to version 4.0 and with it comes some new localisation! Here are some screenshots. (That's Broad Norfolk, in case you're confused.)

$  arara -L qn test


Hold yew hard, ole partner, I'm gornta hev a look at 'test.tex'
(thass 119 bytes big, that is, and that was last chearnged on
03/14/2015 14:54:52 in case yew dunt remember).

(MakeGlossaries) The Make....... THAT ENT GORN RIGHT, OLE PARTNER

Wuh that took 0.24 seconds but if thass a slight longer than you
expected, dunt yew go mobbing me abowt it cors that ent my fault.
My grandf'ar dint have none of these pearks. He had to use a pen
and a bit o' pearper, but thass bin nice mardling wi' yew. Dew
yew keep a troshin'!

$ arara -L qn -help


arara 4.0
Copyright (c) 2012, Paulo Roberto Massa Cereda
Orl them rights are reserved, ole partner

usage: arara [file [--dry-run] [--log] [--verbose] [--timeout N]
             [--max-loops N] [--language L] | --help | --version]
 -h,--help                 wuh, cor blast me, my bewty, but that'll tell
                           me to dew jist what I'm dewun rite now
 -L,--language <code>      that'll tell me what language to mardle in
 -l,--log                  that'll make a log file wi' orl my know dew
                           suffin go wrong
 -m,--max-loops <number>   wuh, yew dunt want me to run on forever, dew
                           you, so use this to say when you want me to
 -n,--dry-run              that'll look like I'm dewun suffin, but I ent
 -t,--timeout <number>     wuh, yew dunt want them system commands to run
                           on forever dew suffin' go wrong, dew you, so
                           use this to set the execution timeout (thass in
 -v,--verbose              thass dew you want ter system commands to hav'
                           a mardle wi'yew an'orl
 -V,--version              dew yew use this dew you want my know abowt
                           this version

Book Launch Photos

Quack, Quack, Quack. Give My Hat Back!

image of cake
image of cake
image of cake
being cut

The Private Enemy

Image of books arranged on old printing press

© 2015 Dickimaw Books. "Dickimaw", "Dickimaw Books" and the Dickimaw parrot logo are trademarks. The Dickimaw parrot was painted by Magdalene Pritchett.

Terms of Use Privacy Policy Cookies Site Map FAQs