summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex')
-rw-r--r--macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex457
1 files changed, 432 insertions, 25 deletions
diff --git a/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex b/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex
index a5caad77b6..d5625142a1 100644
--- a/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex
+++ b/macros/latex/contrib/glossaries-extra/samples/sample-abbr-styles.tex
@@ -5,12 +5,18 @@
\documentclass{report}
+\usepackage[left=1cm,right=0.5cm,marginpar=2.5cm,includemp]{geometry}
\usepackage[T1]{fontenc}
\usepackage{relsize}
+\usepackage{fontawesome}
\usepackage{etoolbox}
+\usepackage{xcolor}
+\usepackage{soul}
\usepackage[colorlinks,linkcolor=magenta]{hyperref}
\usepackage{glossaries-extra}
+\newcommand*{\warningsym}{\textcolor{red}{\faExclamationTriangle}}
+
% If you get any undefined control sequences or undefined
% style errors, make sure you have the latest versions of
% glossaries-extra.sty and glossaries.sty
@@ -33,6 +39,9 @@
% for styles that don't have a designated command:
%\renewcommand{\glsfirstlongdefaultfont}[1]{\textsf{#1}}
+% Test command for "outer" formatting (applied with textformat key)
+\newcommand*{\sampleformat}[1]{\textbf{\color{teal}#1}}
+
% These commands are used by the '-hyphen' styles.
% For example, to switch to small-caps for the short form:
%\renewcommand{\glsabbrvhyphenfont}{\glsabbrvscfont}
@@ -44,16 +53,16 @@
\footnote{\glshyperlink[\glsfmtshort{#1}]{#1}: #2}%
}
-\glssetcategoryattribute{long-hyphen-short-hyphen}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-postshort-hyphen}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-short-hyphen-desc}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-postshort-hyphen-desc}{markwords}{true}
-\glssetcategoryattribute{short-hyphen-long-hyphen}{markwords}{true}
-\glssetcategoryattribute{short-hyphen-postlong-hyphen}{markwords}{true}
-\glssetcategoryattribute{short-hyphen-long-hyphen-desc}{markwords}{true}
-\glssetcategoryattribute{short-hyphen-postlong-hyphen-desc}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-noshort-desc-noreg}{markwords}{true}
-\glssetcategoryattribute{long-hyphen-noshort-noreg}{markwords}{true}
+\glssetcategoryattributes{long-hyphen-short-hyphen}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-postshort-hyphen}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-short-hyphen-desc}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-postshort-hyphen-desc}{markwords,markshortwords}{true}
+\glssetcategoryattributes{short-hyphen-long-hyphen}{markwords,markshortwords}{true}
+\glssetcategoryattributes{short-hyphen-postlong-hyphen}{markwords,markshortwords}{true}
+\glssetcategoryattributes{short-hyphen-long-hyphen-desc}{markwords,markshortwords}{true}
+\glssetcategoryattributes{short-hyphen-postlong-hyphen-desc}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-noshort-desc-noreg}{markwords,markshortwords}{true}
+\glssetcategoryattributes{long-hyphen-noshort-noreg}{markwords,markshortwords}{true}
\newcommand{\stylelist}{}
@@ -63,7 +72,7 @@
\newabbreviation[category=#1,%
%sort={#1},% order by style name
user1={user text}%
- ]{sample-#1}{short}{long form}%
+ ]{sample-#1}{short fm}{long form}%
\csdef{glsxtrpostdesc#1}{ [style: #1]}%
}
@@ -73,7 +82,7 @@
\newabbreviation[category=#1,%
%sort={#1},% order by style name
user1={user text},%
- description={sample description}]{sample-#1}{short}{long form}%
+ description={sample description}]{sample-#1}{short fm}{long form}%
\csdef{glsxtrpostdesc#1}{ [style: #1]}%
}
@@ -215,6 +224,33 @@ change the font). To make the default setting clearer, this document has done:
So any text in this document that's rendered in sans-serif would normally not have any font
change implemented.
+There are additional font changing tests implemented with outer text formatting
+(the textformat key) and inner text formatting (the innertextformat key).
+
+The hyperlink may be placed outside the outer formatting (hyperoutside=true) or
+inside of the outer formatting (hyperoutside=false). Note that when the
+hyperlink is outside, the text colour change applied by the sample formatting
+command (teal) overrides the colour change applied by the hyperlink colour
+setting (magenta). The outer text format can also be changed globally
+by redefining \verb|\glstextformat| or via the \verb|textformat| attribute.
+(Order of precedence: textformat option, textformat attribute,
+\verb|\glstextformat|.)
+
+The inner formatting is implemented within the abbreviation style, so it won't
+show up in custom styles that don't implement it. The outer formatting isn't
+applied to the post-link hook. The inner formatting may be applied to the
+post-link hook, depending whether or not it's supported by the abbreviation
+style.
+
+The outer text format is tested with the custom command defined as:
+\begin{verbatim}
+\newcommand*{\sampleformat}[1]{\textbf{\color{teal}#1}}
+\end{verbatim}
+The inner text format is tested with \verb|\hl| provided by soul.sty.
+(Complex commands such as those provided by soul can only be used
+in the inner text format. The outer format has the text content too
+deeply embedded for those commands to process.)
+
Each test entry is defined using
\begin{verbatim}
\newabbreviation[category=#1,user1={user text}]%
@@ -250,6 +286,13 @@ The test entries that use the \texttt{-hyphen} styles have had the
compound word hyphenation if the inserted text (through the final
optional argument of \verb|\gls|) starts with a hyphen.
+\raisebox{2ex}{\hypertarget{warningnote}{}}%
+\renewcommand*{\GlossariesAbbrStyleTooComplexWarning}[2]{%
+ \warningsym\marginpar{\hyperlink{warningnote}{\warningsym} too complex}}%
+The symbol \warningsym\ indicates that a warning would normally be
+issued at that point in the document for a style that's too complex
+to support the given command.
+
\tableofcontents
\pagenumbering{arabic}
@@ -259,12 +302,45 @@ First use of \verb|\gls|.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\gls{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\glsresetall
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\glsresetall
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\glsresetall
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{Next Use}
Next use of \verb|\gls|.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\gls{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\gls[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{First Use With Insert}
First use of \texttt{\string\gls\marg{label}[-insert]}. The conditional
\verb|\ifglsxtrinsertinside| is used by some styles to
@@ -299,6 +375,32 @@ differences more noticeable this document has done:
\glsreset{\thislabel}\glsxtrinsertinsidetrue
\gls{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsreset{\thislabel}\glsxtrinsertinsidefalse
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsreset{\thislabel}\glsxtrinsertinsidetrue
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsreset{\thislabel}\glsxtrinsertinsidefalse
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsreset{\thislabel}\glsxtrinsertinsidetrue
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsreset{\thislabel}\glsxtrinsertinsidefalse
+\gls[innertextformat=hl]{\thislabel}[-insert];
+\glsreset{\thislabel}\glsxtrinsertinsidetrue
+\gls[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
+
\chapter{Next Use With Insert}
Next use of \texttt{\string\gls\marg{label}[-insert]}.
@@ -314,6 +416,30 @@ conditional.
\glsxtrinsertinsidetrue
\gls{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\gls[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\gls[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\gls[innertextformat=hl]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\gls[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Full Form}
Full form using \verb|\glsxtrfull| (inline full style).
This may differ from the display form used by \verb|\gls|
@@ -322,6 +448,21 @@ on first use, depending on the style.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glsxtrfull{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrfull[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrfull[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrfull[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{Short Form}
Short form using \verb|\glsxtrshort|.
This may differ from the display form used by \verb|\gls|
@@ -331,12 +472,46 @@ on subsequent use, depending on the style.
\glsxtrshort{\thislabel}.\glspar
}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrshort[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar
+}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrshort[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar
+}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrshort[innertextformat=hl]{\thislabel}.\glspar
+}
+
+
\chapter{Long Form}
Long form using \verb|\glsxtrlong|.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glsxtrlong{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrlong[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrlong[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrlong[innertextformat=detokenize]{\thislabel}.\glspar}
+
\chapter{Full Form With Insert}
Full form using \texttt{\string\glsxtrfull\marg{label}[-insert]} (inline full style).
In this test chapter, each entry is displayed
@@ -350,6 +525,30 @@ with \verb|\glsxtrinsertinsidefalse| and then displayed with
\glsxtrinsertinsidetrue
\glsxtrfull{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrfull[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrfull[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrfull[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrfull[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrfull[innertextformat=hl]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrfull[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Short Form With Insert}
Short form using \texttt{\string\glsxtrshort\marg{label}[-insert]}.
@@ -364,6 +563,30 @@ with \verb|\glsxtrinsertinsidefalse| and then displayed with
\glsxtrinsertinsidetrue
\glsxtrshort{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrshort[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrshort[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrshort[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrshort[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrshort[innertextformat=hl]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrshort[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Long Form With Insert}
Long form using \texttt{\string\glsxtrlong\marg{label}[-insert]}.
Note that the \texttt{hyphen} styles with the \texttt{markwords}
@@ -380,20 +603,82 @@ with \verb|\glsxtrinsertinsidefalse| and then displayed with
\glsxtrinsertinsidetrue
\glsxtrlong{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrlong[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrlong[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrlong[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrlong[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsxtrinsertinsidefalse
+\glsxtrlong[innertextformat=hl]{\thislabel}[-insert];
+\glsxtrinsertinsidetrue
+\glsxtrlong[innertextformat=hl]{\thislabel}[-insert].\glspar}
+\glsxtrinsertinsidefalse
+
\chapter{First Form}
First form using \verb|\glsfirst|. This may be different
from the first use of \verb|\gls| depending on the style.
+In general, it's better not to use \verb|\glsfirst| with
+abbreviations. Use \verb|\gls| (possibly with a reset)
+or \verb|\glsxtrfull| instead.
+Some styles are too complicated to work with \verb|\glsfirst|.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glsfirst{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[textformat=sampleformat,hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[textformat=sampleformat,hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{Text Form}
Text form using \verb|\glstext|. This may be different
from the subsequent use of \verb|\gls| depending on the style.
+In general, it's better not to use \verb|\glstext| with
+abbreviations. Use \verb|\gls| (possibly with an unset)
+or \verb|\glsxtrshort| instead.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glstext{\thislabel}.\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[textformat=sampleformat, hyperoutside=true]{\thislabel}.\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[textformat=sampleformat, hyperoutside=false]{\thislabel}.\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[innertextformat=hl]{\thislabel}.\glspar}
+
\chapter{First Form With Insert}
First form using \texttt{\string\glsfirst\marg{label}[-insert]}.
This is different from the first use of \verb|\gls|
@@ -406,30 +691,152 @@ to use \verb|\glsfirst| with abbreviations. Use either
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glsfirst{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glsfirst[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Text Form With Insert}
Text form using \texttt{\string\glstext\marg{label}[-insert]}.
This doesn't check for the conditional
\verb|\ifglsxtrinsertinside|.
+In general, it's better not to use \verb|\glstext| with
+abbreviations. Use \verb|\gls| (possibly with an unset)
+or \verb|\glsxtrshort| instead.
\forglsentries{\thislabel}{\glscategory{\thislabel}:
\glstext{\thislabel}[-insert].\glspar}
+\section{textformat=sampleformat, hyperoutside=true}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[textformat=sampleformat,hyperoutside=true]{\thislabel}[-insert].\glspar}
+
+\section{textformat=sampleformat, hyperoutside=false}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[textformat=sampleformat,hyperoutside=false]{\thislabel}[-insert].\glspar}
+
+\section{innertextformat=hl}
+
+\forglsentries{\thislabel}{\glscategory{\thislabel}:
+\glstext[innertextformat=hl]{\thislabel}[-insert].\glspar}
+
\chapter{Summary}
\renewcommand{\do}[1]{\section{#1}
-First use \texttt{\string\gls\marg{label}}:
-\glsreset{sample-#1}\gls{sample-#1}.\par\noindent
-Next use \texttt{\string\gls\marg{label}}: \gls{sample-#1}.\par\noindent
-First use \texttt{\string\gls\marg{label}[-insert]}:
-\glsreset{sample-#1}\gls{sample-#1}[-insert].\par\noindent
-Next use \texttt{\string\gls\marg{label}[-insert]}:
-\gls{sample-#1}[-insert].\par\noindent
-\texttt{\string\glsxtrfull\marg{label}[-insert]}:
-\glsxtrfull{sample-#1}[-insert].\par\noindent
-\texttt{\string\glsxtrshort\marg{label}[-insert]}:
-\glsxtrshort{sample-#1}[-insert].\par\noindent
-\texttt{\string\glsxtrlong\marg{label}[-insert]}:
-\glsxtrlong{sample-#1}[-insert].\par\noindent
+\subsection{First Use}
+\texttt{\string\gls\marg{label}} / \texttt{\string\Gls\marg{label}} /
+\texttt{\string\GLS\marg{label}}:
+\gls[prereset]{sample-#1};
+\Gls[prereset]{sample-#1};
+\GLS[prereset]{sample-#1}.\par\noindent
+With insert:
+\gls[prereset]{sample-#1}[-insert];
+\Gls[prereset]{sample-#1}[-insert];
+\GLS[prereset]{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glspl\marg{label}} / \texttt{\string\Glspl\marg{label}} /
+\texttt{\string\GLSpl\marg{label}}:
+\glspl[prereset]{sample-#1};
+\Glspl[prereset]{sample-#1};
+\GLSpl[prereset]{sample-#1}.\par\noindent
+With insert:
+\glspl[prereset]{sample-#1}[-insert];
+\Glspl[prereset]{sample-#1}[-insert];
+\GLSpl[prereset]{sample-#1}[-insert].
+\subsection{Next Use}
+\texttt{\string\gls\marg{label}} / \texttt{\string\Gls\marg{label}} /
+\texttt{\string\GLS\marg{label}}:
+\gls{sample-#1};
+\Gls{sample-#1};
+\GLS{sample-#1}.\par\noindent
+With insert:
+\gls{sample-#1}[-insert];
+\Gls{sample-#1}[-insert];
+\GLS{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glspl\marg{label}} / \texttt{\string\Glspl\marg{label}} /
+\texttt{\string\GLSpl\marg{label}}:
+\glspl{sample-#1};
+\Glspl{sample-#1};
+\GLSpl{sample-#1}.\par\noindent
+With insert:
+\glspl{sample-#1}[-insert];
+\Glspl{sample-#1}[-insert];
+\GLSpl{sample-#1}[-insert].
+\subsection{Full Inline}
+\texttt{\string\glsxtrfull\marg{label}} /
+\texttt{\string\Glsxtrfull\marg{label}} /
+\texttt{\string\GLSxtrfull\marg{label}}:
+\glsxtrfull{sample-#1};
+\Glsxtrfull{sample-#1};
+\GLSxtrfull{sample-#1}.\par\noindent
+With insert:
+\glsxtrfull{sample-#1}[-insert];
+\Glsxtrfull{sample-#1}[-insert];
+\GLSxtrfull{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glsxtrfullpl\marg{label}} /
+\texttt{\string\Glsxtrfullpl\marg{label}} /
+\texttt{\string\GLSxtrfullpl\marg{label}}:
+\glsxtrfullpl{sample-#1};
+\Glsxtrfullpl{sample-#1};
+\GLSxtrfullpl{sample-#1}.\par\noindent
+Plural with insert:
+\glsxtrfullpl{sample-#1}[-insert];
+\Glsxtrfullpl{sample-#1}[-insert];
+\GLSxtrfullpl{sample-#1}[-insert].
+\subsection{Short}
+\texttt{\string\glsxtrshort\marg{label}} /
+\texttt{\string\Glsxtrshort\marg{label}} /
+\texttt{\string\GLSxtrshort\marg{label}}:
+\glsxtrshort{sample-#1};
+\Glsxtrshort{sample-#1};
+\GLSxtrshort{sample-#1}.\par\noindent
+With insert:
+\glsxtrshort{sample-#1}[-insert];
+\Glsxtrshort{sample-#1}[-insert];
+\GLSxtrshort{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glsxtrshortpl\marg{label}} /
+\texttt{\string\Glsxtrshortpl\marg{label}} /
+\texttt{\string\GLSxtrshortpl\marg{label}}:
+\glsxtrshortpl{sample-#1};
+\Glsxtrshortpl{sample-#1};
+\GLSxtrshortpl{sample-#1}.\par\noindent
+Plural with insert:
+\glsxtrshortpl{sample-#1}[-insert];
+\Glsxtrshortpl{sample-#1}[-insert];
+\GLSxtrshortpl{sample-#1}[-insert].
+\subsection{Long}
+\texttt{\string\glsxtrlong\marg{label}} /
+\texttt{\string\Glsxtrlong\marg{label}} /
+\texttt{\string\GLSxtrlong\marg{label}}:
+\glsxtrlong{sample-#1};
+\Glsxtrlong{sample-#1};
+\GLSxtrlong{sample-#1}.\par\noindent
+With insert:
+\glsxtrlong{sample-#1}[-insert];
+\Glsxtrlong{sample-#1}[-insert];
+\GLSxtrlong{sample-#1}[-insert].\par\noindent
+Plural \texttt{\string\glsxtrlongpl\marg{label}} /
+\texttt{\string\Glsxtrlongpl\marg{label}} /
+\texttt{\string\GLSxtrlongpl\marg{label}}:
+\glsxtrlongpl{sample-#1};
+\Glsxtrlongpl{sample-#1};
+\GLSxtrlongpl{sample-#1}.\par\noindent
+Plural with insert:
+\glsxtrlongpl{sample-#1}[-insert];
+\Glsxtrlongpl{sample-#1}[-insert];
+\GLSxtrlongpl{sample-#1}[-insert].
+\subsection{Other}
Name: \glsentryname{sample-#1}.\par\noindent
Sort: \texttt{\glsentrysort{sample-#1}}.\par\noindent
Description: \glsentrydesc{sample-#1}.\par