[Tex/LaTex] Using the glossaries package for English acronyms in German documents

glossaries

This is a repost of the original message I posted to comp.text.tex in August, which is still unanswered there. I'm sorry for reposting, but I want to spread this to a wider readership.

I found couple of similar questions (along with helpful answers) on StackExchange, however, they are more focused on how to deal with the variety of cases the German language has. This is not my actual problem, since the suggested workarounds for this issue are sufficient. They mostly incorporate the use of \glslink and \glsdisp.

Below is the text of my original post.

I would like to use the glossaries package for German documents
including many English based acronyms. For better understanding, let's
have a look at a simple example:

Acronym: PSK
English long: Phase Shift Keying
German long: Phasenumtastung

Im most cases, there is not corresponding acronym in German, therefore
I would like to use the English acronym in my document. Upon first
use, the inserted text shall look like

Phasenumtastung (PSK, Phase Shift Keying)

Upon further use, only

PSK

shall be used.

Finally, in the list of acronyms, it shall look like:

PSK – Phasenumtastung (Phase shift Keying)

I tried to to setup something customized by renewing
\CustomAcronymFields, \SetCustomDisplayStyle and \glossaryentryfield following the user documentation. I'm using the current version 3.01 of glossaries.

My approach is basically to put the string ", Phase Shift Keying" into
the description field while defining with \newacronym and then use it
with customized \defglsdisplayfirst and \glossaryentryfield.

This is to demonstrate how it should look like:

% compile this with
%    pdflatex example.tex
%    makeindex  -s "example.ist" -t "example.alg" -o "example.acr" "example.acn"
%    pdflatex example.tex

\documentclass{scrartcl}

\usepackage[ngerman]{babel}

\usepackage[acronym,nomain,sanitize={description=false,symbol=false}]{glossaries}
\makeglossaries

%% Desired style:
% first: "German long (acronym[, English long])"
% following: "acronym"
\renewcommand*{\CustomAcronymFields}{%
    name={\the\glsshorttok},%
    symbol={\the\glslongtok},%
    text={\the\glsshorttok},%
    plural={\the\glsshorttok\noexpand\acrpluralsuffix}%
}

\renewcommand*{\SetCustomDisplayStyle}[1]{%
  % ##1 corresponds to the 'first' key
  % ##2 corresponds to the 'description' key
  % ##3 corresponds to the 'symbol' key
  % ##4 is the inserted text given by the final optional argument to
  % commands like \gls
  % The short form can be obtained via \glsentryshort{\glslabel}
  % The plural short form can be obtained via
  %\glsentryshortpl{\glslabel}
  % The long form can be obtained via \glsentrylong{\glslabel}
  % The plural long form can be obtained via
  %\glsentrylongpl{\glslabel}
  \defglsdisplayfirst[#1]{##3 (##1##4##2##4)}%
  % ##1 corresponds to the 'text' key
  % the rest as above
  \defglsdisplay[#1]{##1##4}%
}
\SetCustomStyle

% start the glossary entries with capitals
\newglossarystyle{superuc}{%
  \glossarystyle{super}%
  \renewcommand*\glossaryentryfield[5]{%
    \glstarget{##1}{##2} & \makefirstuc{##4}##3\glspostdescription\space##5\\
  }
}



%% acronym definitions
% italic typeset foreign language terms
\newcommand{\foreignlang}[1]{\emph{#1}}
% define acronym with both German and English long
\newcommand{\newacropair}[4]{\newacronym[description={, \foreignlang{#4}}]{#1}{#2}{#3}}
% define acronym with only German long
\newcommand{\newacrogerman}[3]{\newacronym[description={}]{#1}{#2}{#3}}
% define acronym with only English long
\newcommand{\newacroenglish}[3]{\newacronym[description={}]{#1}{#2}{\foreignlang{#3}}}

% sample acronyms
% English acronym along with its common German counterpart
\newacropair{acr:adc}{ADC}{Analog-Digital-Umsetzer}{Analog to Digital Converter}
% English acronym without a common German counterpart
\newacroenglish{acr:dect}{DECT}{Digital Enhanced Cordless Telecommunications}
% German acronym
\newacrogerman{acr:din}{DIN}{Deutsches Institut fuer Normung}


% Alternative first - to be used if the first use is not nominative singular.
% Problem: I do not find a way to use glossaries' integrated 'first use' flag.
% This macro is my current dirty implementation. It always displays the full form
% and unsets the 'first use' flag afterwards. Bad things happen if at a later point
% it time, I decide to mention the same acronym earlier. I'll be using \glsalt again
% and end up in a double definition of the acronym, which I would like to avoid.
\newcommand{\glsalt}[2]{\glslink{#1}{#2 (\acrshort*{#1}\glsdesc*{#1})}\glsunset{#1}}


\begin{document}

\section{Problems}

% For the first mention, I'll be using \glsalt, since I need to display the 
% German text in genitive.
Die Aufloesung des \glsalt{acr:adc}{Analog-Digital-Umsetzers} beeinflusst\dots

% In the example below, I would need a plural form. That means an 's' would
% have to be attached to both the English acronym as well as the English long form.
% I have no clue how to implement that cleanly, due to my changes in
% \SetCustomDisplayStyle in the preamble.
Die Aufloesung der \glsalt{acr:adc}{Analog-Digital-Umsetzer} beeinflusst\dots


\section{Normal Cases}

\glsreset{acr:adc}

% These are only to show how it should look like for the 'normal' cases.
\gls{acr:adc} -- \gls{acr:adc}

\gls{acr:dect} -- \gls{acr:dect}

\gls{acr:din} -- \gls{acr:din}

\printglossary[type=\acronymtype,style=superuc,nonumberlist=false]

\end{document}

This works for me unless I don't have to use the plural form upon the
first occurence. From then on, the concept behind glossaries, so far I
can understand, does not really allow my tweak.

The main reason, to my understanding, is the fact that when defining a
new acronym by \newacronym, besides the label, only one short form and
one long form can be passed and accessed in \CustomAcronymFields.
These two can be accessed by \glsshorttok and \glslongtok for storing
them under the user-defined keys, such as name, symbol, text,
etc. Especially the description key itself cannot be accessed at
this stage.

From the conceptual point of view, it would be helpful if all three
forms (short, English long, German long) could be passed to
\newacronym separately and then concatenated in a customized fashion
to be finally stored with their corresponding keys, including
firstplural and longplural. Note that for my example, I would e.g.
have to append an "s" for the plural forms of the short form as well
as to the English long form and provide a used-defined plural form for
the German long form in most cases.

For now, my only question is whether you think that my problem can
still be solved with what glossaries offers so far. If not, would it
make sense to try to redefine a couple of commands? I've had the
impression that e.g. \glsentryfull has to be redefined. However, one
major problem I fear is that most of these commands only take a subset
of keys, such as only short and long (not description) in case
of \glsentryfull.

Or is there even another package which would do my task without modifications?

Best Answer

The simplest method is to use the glossaries-extra package. The translation is stored in the user1 key. The long-short-user abbreviation style is designed to include additional information in the parenthetical material on first use. By default it picks up the information from the user1 field.

\documentclass{article}

\usepackage[T1]{fontenc}
\usepackage[colorlinks]{hyperref}
\usepackage[acronym,
            nomain,% don't create "main" glossary
            postdot% put a period after the description
           ]{glossaries-extra}

\makeglossaries

% \glscurrentfieldvalue only works with glossaries v4.23 (and above)
\renewcommand{\glsxtrpostdescacronym}{%
 \ifglshasfield{\glsxtruserfield}{\glscurrententrylabel}%
 { (\glscurrentfieldvalue)}%
 {}%
}

\setabbreviationstyle[acronym]{long-short-user}

\newacronym[user1=Phase Shift Keying]{psk}{PSK}{Phasenumtastung}
\newacronym{aa}{AA}{Another Acronym}

\begin{document}    

First use: \gls{psk}. Subsequent use: \gls{psk}.

First use: \gls{aa}. Subsequent use: \gls{aa}.

\printglossaries

\end{document}

The post-description hook (\glsxtrpostdesccategory) appends information after the description in the glossary. This is a convenient way of making a minor adjustment without having to define a new glossary style.

If you prefer to use \newabbreviation instead of \newacronym, you need to redefine \glsxtrpostdescabbreviation instead of \glsxtrpostdescacronym and use \setabbreviationstyle{long-short-user} instead of \setabbreviationstyle[acronym]{long-short-user}. (\newacronym implicitly sets category=acronym and \newabbreviation implicitly sets category=abbreviation.)

If you want to stick with just the base glossaries package, it's slightly more complicated. The translation is still provided in the user1 field:

\documentclass{article}

\usepackage{glossaries}

\makeglossaries

% define an acronym style for the acronyms with a translation:

\newacronymstyle{acronymslang}%
{%
  \GlsUseAcrEntryDispStyle{long-short}%
}
{%
  \GlsUseAcrStyleDefs{short-long}%
  \renewcommand*{\genacrfullformat}[2]{%
   \glsentrylong{##1}##2\space
   (\protect\firstacronymfont{\glsentryshort{##1}}%
    \ifglshasfield{useri}{##1}%
    {, \glsentryuseri{##1}}{})%
  }%
  \renewcommand*{\Genacrfullformat}[2]{%
   \Glsentrylong{##1}##2\space
   (\protect\firstacronymfont{\glsentryshort{##1}}%
    \ifglshasfield{useri}{##1}%
    {, \glsentryuseri{##1}}{})%
  }%
  \renewcommand*{\genplacrfullformat}[2]{%
   \glsentrylongpl{##1}##2\space
   (\protect\firstacronymfont{\glsentryshortpl{##1}}%
    \ifglshasfield{useri}{##1}%
    {, \glsentryuseri{##1}}{})%
  }%
  \renewcommand*{\Genplacrfullformat}[2]{%
   \Glsentrylongpl{##1}##2\space
   (\protect\firstacronymfont{\glsentryshortpl{##1}}%
    \ifglshasfield{useri}{##1}%
    {, \glsentryuseri{##1}}{})%
  }%
}

\setacronymstyle{acronymslang}

\newacronym[user1=Phase Shift Keying]{psk}{PSK}{Phasenumtastung}
\newacronym{aa}{AA}{Another Acronym}

% glossary style for acronyms with a translation

\newglossarystyle{acronymslang}
{%
  \setglossarystyle{long}%
  \renewcommand*{\glsgroupskip}{}%
  \renewcommand{\glossentry}[2]{%
    \glsentryitem{##1}\glstarget{##1}{\glossentryname{##1}} &
    \glossentrydesc{##1}\glspostdescription
    \ifglshasfield{useri}{##1}{ (\glsentryuseri{##1})}{}%
    \space ##2\tabularnewline
  }%
}

\setglossarystyle{acronymslang}

\begin{document}

First use: \gls{psk}. Subsequent use: \gls{psk}.

First use: \gls{aa}. Subsequent use: \gls{aa}.

\printglossaries
\end{document}

This doesn't have the benefit of the post-description hook so a custom glossary style is required. The difference between the two methods can be seen from the position of the period (full-stop) inserted after the description through the postdot or postpunc=dot (glossaries-extra only) or nopostdot=false package options. With the glossaries-extra post-description hook the terminating punctuation is placed after the hook.

My original answer used an old version of glossaries and had to use internal commands, which isn't desirable. It's better to update to a newer version and use one of the above methods instead. There's no custom glossary style as it uses a hack to append the user1 contents to the description field.

\documentclass{article}

\usepackage{glossaries}
\usepackage{etoolbox}

\newtoks\customtok

\renewcommand*{\newacronymhook}{%
 \edef\dosetkeys{\noexpand\setkeys{glossentry}{user1={},\the\glskeylisttok}}%
 \dosetkeys
 \ifcsempty{@glo@useri}%
 {%
   \expandafter\customtok\expandafter{\the\glsshorttok}%
 }%
 {%
   \edef\custom{\the\glsshorttok, \csexpandonce{@glo@useri}}%
   \expandafter\customtok\expandafter{\custom}%
 }%
}

\newcommand*{\custompostdesc}[1]{%
  \ifcsempty{glo@#1@useri}{}{ (\glsentryuseri{#1})}%
}

\renewcommand*{\CustomAcronymFields}{%
  user1={},%
  name={\the\glsshorttok},%
  description={\the\glslongtok\noexpand\custompostdesc{\the\glslabeltok}},%
  first={\the\glslongtok\space(\the\customtok)},%
  firstplural={\the\glslongtok\noexpand\acrpluralsuffix
    \space (\the\customtok)}%
  text={\the\glsshorttok},%
  plural={\the\glsshorttok\noexpand\acrpluralsuffix}%
}

\SetCustomStyle

\makeglossaries

\newacronym[user1=Phase Shift Keying]{psk}{PSK}{Phasenumtastung}
\newacronym{aa}{AA}{Another Acronym}

\begin{document}

First use: \gls{psk}. Subsequent use: \gls{psk}.

First use: \gls{aa}. Subsequent use: \gls{aa}.

\printglossaries
\end{document}

Related Solutions

[Tex/LaTex] Using glossaries (acronyms) with Beamer

If you know it's definitely the first occurrence, you can explicitly use \glsfirst instead of \gls. Something like this:

\documentclass{beamer}

\usepackage[acronym]{glossaries}
\newacronym{AMA}{AMA}{a meaningless acronym}

\begin{document}

\begin{frame}
  \begin{itemize}
  \item<1-> The first occurrence of the acronym \glsfirst{AMA}.
  \item<1-> The second occurrence of the acronym \glstext{AMA}.
  \item<2-> Something else.
  \end{itemize}
\end{frame}
\glsunset{AMA}

\end{document}

Edit: Here's another approach:

\documentclass{beamer}

\usepackage[acronym]{glossaries}
\newacronym{AMA}{AMA}{a meaningless acronym}

\begin{document}

\ifglsused{AMA}
 {\newcommand{\doAMA}{\gls{AMA}}}
 {\newcommand{\doAMA}{\glsfirst{AMA}\glsunset{AMA}}}

\begin{frame}
  \begin{itemize}
  \item<1-> The first occurrence of the acronym \doAMA.
  \item<1-> The second occurrence of the acronym \gls{AMA}.
  \item<2-> Something else.
\end{itemize}
\end{frame}

\end{document}

[Tex/LaTex] Glossaries acronyms two languages

I recommend you upgrade to the latest version of glossaries (v4.01 at time of writing) as it's more flexible. Here's an example that uses v4.01:

\documentclass[spanish,english]{article}

\usepackage{babel}
\usepackage{etoolbox}
\usepackage[acronym,toc,shortcuts]{glossaries}

\makeglossaries

% Add new key for long Spanish form:
\glsaddkey
{longsp}% key
{}% default value
{\glsentrylongsp}% new command analogous to \glsentrylong
{\Glsentrylongsp}% new command analogous to \Glsentrylong
{\acrlongsp}% new command analogous to \acrlong
{\Acrlongsp}% new command analogous to \Acrlong
{\ACRlongsp}% new command analogous to \ACRlong

% Add new key for plural long Spanish form:
\glsaddkey
{longplsp}% key
{}% default value
{\glsentrylongplsp}% new command analogous to \glsentrylongpl
{\Glsentrylongplsp}% new command analogous to \Glsentrylongpl
{\acrlongplsp}% new command analogous to \acrlongpl
{\Acrlongplsp}% new command analogous to \Acrlongpl
{\ACRlongplsp}% new command analogous to \ACRlongpl

% Provide conditional to test if longsp/longplsp has been set
\newcommand*{\glsifhaslongsp}[3]{%
  \ifcsempty{glo@#1@longsp}{#3}{#2}%
}
\newcommand*{\glsifhaslongplsp}[3]{%
  \ifcsempty{glo@#1@longplsp}{#3}{#2}%
}

% Set up custom acronym style:
\renewcommand*{\CustomAcronymFields}{%
  name={\the\glsshorttok},
  description={\the\glslongtok},%
}

% Set the display style for acronyms (used by commands like \gls, \glspl, \ac, \acp or \glsdisp)
\renewcommand*\SetCustomDisplayStyle[1]{%
  \defglsentryfmt[#1]{%
    \ifdefempty\glscustomtext
    {% \glsdisp not used
      \ifglsused\glslabel
      {% subsequent use
         \glsifplural
         {% plural
           \glscapscase
           {% subsequent, plural, no case change
             \glsentryshortpl{\glslabel}\glsinsert%
           }%
           {% subsequent, plural, first letter upper case
             \Glsentryshortpl{\glslabel}\glsinsert%
           }%
           {% subsequent, plural, all caps
             \MakeTextUppercase{\glsentryshortpl{\glslabel}\glsinsert}%
           }%
         }%
         {% singular
           \glscapscase
           {% subsequent, singular, no case change
             \glsentryshort{\glslabel}\glsinsert%
           }%
           {% subsequent, singular, first letter upper case
             \Glsentryshort{\glslabel}\glsinsert%
           }%
           {% subsequent, singular, all caps
             \MakeTextUppercase{\glsentryshort{\glslabel}\glsinsert}%
           }%
         }%
      }%
      {% first use
         \glsifplural
         {% plural
           \glsifhaslongplsp\glslabel
           {% first use, plural, has Spanish long form
             \glscapscase
             {% first use, plural, Spanish, no case change
               \glsentrylongplsp{\glslabel}\glsinsert\space
               (\glsentryshortpl{\glslabel},\space
                \glsentrylongpl{\glslabel})%
             }%
             {% first use, plural, Spanish, first letter upper case
               \Glsentrylongplsp{\glslabel}\glsinsert\space
               (\glsentryshortpl{\glslabel},\space
                \glsentrylongpl{\glslabel})%
             }%
             {% first use, plural, Spanish, all caps
               \MakeTextUppercase{\glsentrylongplsp{\glslabel}\glsinsert\space
               (\glsentryshortpl{\glslabel},\space
                \glsentrylongpl{\glslabel})}%
             }%
           }%
           {% first use, plural, doesn't have Spanish long form
             \glscapscase
             {% first use, plural, no Spanish, no case change
               \glsentrylongpl{\glslabel}\glsinsert\space
               (\glsentryshortpl{\glslabel})%
             }%
             {% first use, plural, no Spanish, first letter upper case
               \Glsentrylongpl{\glslabel}\glsinsert\space
               (\glsentryshortpl{\glslabel})%
             }%
             {% first use, plural, no Spanish, all caps
               \MakeTextUppercase{\glsentrylongpl{\glslabel}\glsinsert\space
               (\glsentryshortpl{\glslabel})}%
             }%
           }%
         }%
         {% singular
           \glsifhaslongsp\glslabel
           {% first use, singular, has Spanish long form
             \glscapscase
             {% first use, singular, Spanish, no case change
               \glsentrylongsp{\glslabel}\glsinsert\space
               (\glsentryshort{\glslabel},\space
                \glsentrylong{\glslabel})%
             }%
             {% first use, singular, Spanish, first letter upper case
               \Glsentrylongsp{\glslabel}\glsinsert\space
               (\glsentryshort{\glslabel},\space
                \glsentrylong{\glslabel})%
             }%
             {% first use, singular, Spanish, all caps
               \MakeTextUppercase{\glsentrylongsp{\glslabel}\glsinsert\space
               (\glsentryshort{\glslabel},\space
                \glsentrylong{\glslabel})}%
             }%
           }%
           {% first use, singular, doesn't have Spanish long form
             \glscapscase
             {% first use, singular, no Spanish, no case change
               \glsentrylong{\glslabel}\glsinsert\space
               (\glsentryshort{\glslabel})%
             }%
             {% first use, singular, no Spanish, first letter upper case
               \Glsentrylong{\glslabel}\glsinsert\space
               (\glsentryshort{\glslabel})%
             }%
             {% first use, singular, no Spanish, all caps
               \MakeTextUppercase{\glsentrylong{\glslabel}\glsinsert\space
               (\glsentryshort{\glslabel})}%
             }%
           }%
         }%
      }%
    }%
    {% \glsdisp used
      \glscustomtext
    }%
  }%
}

\SetCustomStyle

% Define a new glossary style that checks for the existence of
% the longsp field.
\newglossarystyle{listsp}{%
  \setglossarystyle{list}% base style on the list style
  \renewcommand*{\glossentry}[2]{%
  \item[\glsentryitem{##1}%
        \glstarget{##1}{\glossentryname{##1}}]
    \glossentrydesc{##1}%
    \glsifhaslongsp{##1}{\space(\glsentrylongsp{##1})}{}%
    \glspostdescription\space ##2}%
}

\newacronym
 [longsp=interfaz de programaci\'{o}n de la aplicaci\'{o}n,
  longplsp=interfaces de programaci\'{o}n de la aplicaci\'{o}n
 ]{api}{API}{Application Programming Interface}

\newacronym{aa}{AA}{Another Acronym}

\begin{document}

First use: Las \acp{api} ....  Subsequent use: \acp{api}

\glsresetall

First use: Las \ac{api} ....  Subsequent use: \ac{api}

First use: \gls{aa}. Subsequent use: \gls{aa}.

\printglossary[type=\acronymtype,style=listsp]

\end{document}

This produces:

Image of resulting document

Edit:

If you upgrade to the latest version (v4.02, 2013/12/05) it's easier to define a new acronym style and have \acf match the style. (Although it's also possible to define acronym styles where they don't match, as is the case with the predefined footnote style where \acr doesn't use a footnote.) Here's the above example rewritten using v4.02 code:

\documentclass[spanish,english]{article}

\usepackage{babel}
\usepackage{etoolbox}
\usepackage[acronym,toc,shortcuts]{glossaries}

\makeglossaries

% Add new key for long Spanish form:
\glsaddkey
{longsp}% key
{}% default value
{\glsentrylongsp}% new command analogous to \glsentrylong
{\Glsentrylongsp}% new command analogous to \Glsentrylong
{\acrlongsp}% new command analogous to \acrlong
{\Acrlongsp}% new command analogous to \Acrlong
{\ACRlongsp}% new command analogous to \ACRlong

% Add new key for plural long Spanish form:
\glsaddkey
{longplsp}% key
{}% default value
{\glsentrylongplsp}% new command analogous to \glsentrylongpl
{\Glsentrylongplsp}% new command analogous to \Glsentrylongpl
{\acrlongplsp}% new command analogous to \acrlongpl
{\Acrlongplsp}% new command analogous to \Acrlongpl
{\ACRlongplsp}% new command analogous to \ACRlongpl

% Provide conditional to test if longsp/longplsp has been set
\newcommand*{\glsifhaslongsp}[3]{%
  \ifcsempty{glo@#1@longsp}{#3}{#2}%
}
\newcommand*{\glsifhaslongplsp}[3]{%
  \ifcsempty{glo@#1@longplsp}{#3}{#2}%
}

% Define new acronym style:

\newacronymstyle{spanish}
{% base the display style on 'long-short'
  \GlsUseAcrEntryDispStyle{long-short}%
}%
{% base the definitions on 'long-short'
  \GlsUseAcrStyleDefs{long-short}%  
% Make some custom modifications for the first use display.
% Singular, no case change:
  \renewcommand*{\genacrfullformat}[2]{%
   \glsifhaslongsp{##1}%
   {% has Spanish version:
      \glsentrylongsp{##1}##2\space
      (\firstacronymfont{\glsentryshort{##1}}, \glsentrylong{##1})%
   }%
   {%
     \glsentrylong{##1}##2\space
     (\firstacronymfont{\glsentryshort{##1}})%
   }%
  }%
% Singular, first letter upper case:
  \renewcommand*{\Genacrfullformat}[2]{%
   \glsifhaslongsp{##1}%
   {% has Spanish version:
      \Glsentrylongsp{##1}##2\space
      (\firstacronymfont{\glsentryshort{##1}}, \glsentrylong{##1})%
   }%
   {%
     \Glsentrylong{##1}##2\space
     (\firstacronymfont{\glsentryshort{##1}})%
   }%
  }%
% Plural, no case change:
  \renewcommand*{\genplacrfullformat}[2]{%
   \glsifhaslongplsp{##1}%
   {% has Spanish version:
      \glsentrylongplsp{##1}##2\space
      (\firstacronymfont{\glsentryshortpl{##1}}, \glsentrylongpl{##1})%
   }%
   {%
     \glsentrylongpl{##1}##2\space
     (\firstacronymfont{\glsentryshortpl{##1}})%
   }%
  }%
% Plural, first letter upper case:
  \renewcommand*{\Genplacrfullformat}[2]{%
    \glsifhaslongplsp{##1}%
    {% has Spanish version:
      \Glsentrylongplsp{##1}##2\space
      (\firstacronymfont{\glsentryshortpl{##1}}, \glsentrylongpl{##1})%
    }%
    {%
      \Glsentrylongpl{##1}##2\space
      (\firstacronymfont{\glsentryshortpl{##1}})%
    }%
  }%
}

% switch to the new style:
\setacronymstyle{spanish}

% Define a new glossary style that checks for the existence of
% the longsp field.
\newglossarystyle{listsp}{%
  \setglossarystyle{list}% base style on the list style
  \renewcommand*{\glossentry}[2]{%
  \item[\glsentryitem{##1}%
        \glstarget{##1}{\glossentryname{##1}}]
    \glossentrydesc{##1}%
    \glsifhaslongsp{##1}{\space(\glsentrylongsp{##1})}{}%
    \glspostdescription\space ##2}%
}

\newacronym
 [longsp=interfaz de programaci\'{o}n de la aplicaci\'{o}n,
  longplsp=interfaces de programaci\'{o}n de la aplicaci\'{o}n
 ]{api}{API}{Application Programming Interface}

\newacronym{aa}{AA}{Another Acronym}

\begin{document}

First use: Las \acp{api} ....  Subsequent use: \acp{api}

\glsresetall

First use: Las \ac{api} ....  Subsequent use: \ac{api}

First use: \gls{aa}. Subsequent use: \gls{aa}.

Full form: \acf{api}, \acf{aa}.

\printglossary[type=\acronymtype,style=listsp]

\end{document}

This produces:

Image of resulting document

Edit 2:

In answer to @cacamailg's comment regarding only using the non-English version, the simplest method is just to define a set of commands that check the first use flag like this:

\newcommand*{\acfor}[2][]{%
 \ifglsused{#2}%
 {\acrshort[#1]{#2}}%
 {\acrlongsp[#1]{#2} (\acrshort[#1]{#2})\glsunset{#2}}%
}

\newcommand*{\Acfor}[2][]{%
 \ifglsused{#2}%
 {\Acrshort[#1]{#2}}%
 {\Acrlongsp[#1]{#2} (\acrshort[#1]{#2})\glsunset{#2}}%
}

\newcommand*{\acplfor}[2][]{%
 \ifglsused{#2}%
 {\acrplshort[#1]{#2}}%
 {\acrlongplsp[#1]{#2} (\acrshortpl[#1]{#2})\glsunset{#2}}%
}

\newcommand*{\Acplfor}[2][]{%
 \ifglsused{#2}%
 {\Acrshortpl[#1]{#2}}%
 {\Acrlongplsp[#1]{#2} (\acrshortpl[#1]{#2})\glsunset{#2}}%
}

Then you can do something like:

\acfor{api}. Next use: \acfor{api}.

This has some limitations, for example, you can't use the final insert optional argument used by commands like \gls.

Best Answer

Related Solutions

[Tex/LaTex] Using glossaries (acronyms) with Beamer

[Tex/LaTex] Glossaries acronyms two languages

Related Question