summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-05-24 21:35:50 +0000
committerKarl Berry <karl@freefriends.org>2018-05-24 21:35:50 +0000
commit7f3c84d5d08d7a3c4047e31edfb3164ef787de97 (patch)
tree3a2143921e1eae624611bc3c1df190c533825c2c /Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
parentdda5f2b19723c40bd75b36316e7651896f74013d (diff)
glossaries-extra (24may18)
git-svn-id: svn://tug.org/texlive/trunk@47827 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex')
-rw-r--r--Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex67
1 files changed, 61 insertions, 6 deletions
diff --git a/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex b/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
index a4acda830c1..0938849b99d 100644
--- a/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
+++ b/Master/texmf-dist/doc/latex/glossaries-extra/glossaries-extra-manual.tex
@@ -226,13 +226,13 @@ styles (glossaries):>#1={\protect\ttfamily#1}|main}}
\DeleteShortVerb{\|}
\MakeShortVerb{"}
- \title{glossaries-extra.sty v1.31:
+ \title{glossaries-extra.sty v1.32:
an extension to the glossaries package}
\author{Nicola L.C. Talbot\\[10pt]
Dickimaw Books\\
\url{http://www.dickimaw-books.com/}}
- \date{2018-05-09}
+ \date{2018-05-24}
\maketitle
\begin{abstract}
@@ -279,11 +279,14 @@ Additional resources:
\item \styfmt{glossaries-extra} and \gls{bib2gls}: An Introductory
Guide. (\href{http://mirrors.ctan.org/support/bib2gls/bib2gls-begin.pdf}{\texttt{bib2gls-begin.pdf}}).
-\item \href{http://www.dickimaw-books.com/software/bib2gls}{\appfmt{bib2gls}}
-
\item
-\href{http://www.latex-community.org/know-how/latex/55-latex-general/263-glossaries-nomenclature-lists-of-symbols-and-acronyms}{Glossaries,
-Nomenclature, Lists of Symbols and Acronyms}.
+\href{https://www.dickimaw-books.com/latex/buildglossaries/}{Incorporating
+makeglossaries or makeglossaries-lite or bib2gls into the document
+build}.
+
+\item The
+\href{http://www.dickimaw-books.com/software/bib2gls}{\appfmt{bib2gls}}
+application.
\item The base \href{https://ctan.org/pkg/glossaries}{\styfmt{glossaries}} package.
\end{itemize}
@@ -9362,6 +9365,58 @@ which is just a synonym for \cs{@endfortrue}.
The loop is performed within the true part of \cs{glsxtrifhasfield}
so scoping is automatically applied.
+As from version 1.32, if the field given by
+\begin{definition}[\DescribeMacro\GlsXtrForeignTextField]
+\cs{GlsXtrForeignTextField}
+\end{definition}
+(which defaults to \texttt{userii}) contains a locale tag, then
+\begin{definition}[\DescribeMacro\GlsXtrForeignText]
+\cs{GlsXtrForeignText}\marg{entry label}\marg{text}
+\end{definition}
+can be used to encapsulate \meta{text} in
+\cs{foreignlanguage}\marg{dialect}\marg{text} where \meta{dialect}
+is obtained from the locale tag through \sty{tracklang}'s
+\ics{GetTrackedDialectFromLanguageTag} command. You need at least
+\sty{tracklang} v1.3.6 for this to work properly. The \meta{dialect}
+must be one that's tracked (which typically means that \sty{babel}
+or \sty{polyglossia} has been loaded with the appropriate setting
+for that language). If \cs{foreignlanguage} hasn't been defined,
+this just does \meta{text}.
+For example:
+\begin{verbatim}
+\documentclass{article}
+
+\usepackage[main=british,brazilian,ngerman]{babel}
+\usepackage{glossaries-extra}
+
+\setabbreviationstyle{long-short-user}
+\newabbreviation
+ [user1={Associa\c{c}\~ao Brasileria de Normas T\'ecnicas},
+ user2= {pt-BR}
+ ]
+ {abnt}{ABNT}{Brazilian National Standards Organization}
+
+\newabbreviation
+ [user1={Deutsches Institut f\"ur Normung e.V.},
+ user2={de-DE-1996}]
+ {din}{DIN}{German Institute for Standardization}
+
+\renewcommand*{\glsxtruserparen}[2]{%
+ \glsxtrfullsep{#2}%
+ \glsxtrparen
+ {#1%
+ \ifglshasfield{\glsxtruserfield}{#2}%
+ {, \emph{\GlsXtrForeignText{#2}{\glscurrentfieldvalue}}}%
+ {}%
+ }%
+}
+
+\begin{document}
+\gls{abnt}, \gls{din}.
+\end{document}
+\end{verbatim}
+
+
When using the \pkgopt{record} option, in addition to recording the
usual location, you can also record the current value
of another counter at the same time using the preamble-only command: