[Tex/LaTex] How to create a list of symbols where symbols can be used in math mode

glossariesmath-modesymbols

I describe complex protocols with lots of variables in different files. The problem is that I might change the variable names later. My idea was to define variable names as Latex commands like \lengthtree (instead of writing e.g. $\ell_t$). Later I can easily change \lengthtree to $L_t$ by just redefine the latex command.

Now I want to create a list of symbols and I am searching for a possibility to create it automatically. I give the glossaries package a try, but I get Latex errors if I use the symbols in math environments.

What would be the "state-of-the-art" solution to define my variables (which can be used also in math mode) at one global point? A list of symbols should be created automatically.

Best Answer

As barbara mentioned, you can use \ensuremath like this:

\documentclass{article}

\usepackage{glossaries}

\makeglossaries

\newglossaryentry{lengthtree}%
{%
  name={\ensuremath{L_t}},
  description={description here},
  sort={L}
}

\begin{document}

In line: \gls{lengthtree}. In math mode: 
\[
  \gls{lengthtree}
\]

\printglossary[title={List of Symbols}]

\end{document}

The arguments against \ensuremath come down to two main issues (see When not to use \ensuremath for math macro?):

Firstly, you might end up with $ inside the argument of \ensuremath. This won't occur in this example, as the argument of \ensuremath is being explicitly set to L_t.

Secondly, there is an issue of semantics. Following this line of argument, you should define the entry without \ensuremath and do $\gls{lengthtest}$, which is fine in the document text that you type, but this will cause a problem in the glossary where the style doesn't automatically shift to math mode when it comes to the entry name. Personally, I think \ensuremath is okay in this context, but for the purists who can't stand it, here's an alternative solution:

\documentclass{article}

\usepackage{glossaries}

\makeglossaries

\newglossaryentry{lengthtree}%
{%
  name={$L_t$},
  text={L_t},
  description={description here},
  sort={L}
}

\begin{document}

In line: $\gls{lengthtree}$. In math mode: 
\[
  \gls{lengthtree}
\]

\printglossary[title={List of Symbols}]

\end{document}

Both the above examples produce:

Image of document

Related Question