<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">% !TeX encoding = UTF-8
% !TeX spellcheck = fr_CA
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Document principal pour l'exemple d'utilisation de glosmathtools
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% nohyperref pour charger le package hyperref manuellement 
\documentclass[projet,nohyperref,article,english,french]{ulthese}
%% ===================== packages ============================================
\ifxetex\else \usepackage[utf8]{inputenc} \fi
\usepackage{mathtools,siunitx,amsmath,amsfonts}
\usepackage{hyperref} % dernier package chargÃ© sauf glosmathtools
% option "toc" passÃ© Ã&nbsp; glossaries : ajout nomenclature dans signets du PDF :
\usepackage[qtmarkupright,singlelineskip,toc]{glosmathtools}
%% ===================== preamble ============================================
%% ------------- glosmathtools -----------------------------------------------
\makeglossaries% executÃ© en premier
\setacronymlang{L2}% abbrÃ©viation en langue seconde
\setglossarystyle{nomencl-L2L1}% description bilingue
\loadglsentries{sample_glosmathtools_glos} % fichier des dÃ©finitions
\glssetwidest{LOOP}  % IMPORTANT : entrÃ©e la plus large de la nomenclature
\renewcommand*{\glscatnamefmt}[1]{\textbf{#1}} % format des catÃ©gories
%% ------------- ulthese ----------------------------------------------------
\titre{Documentation et exemple de \texttt{glosmathtools} dans \texttt{ulthese}}
\soustitre{v1.0.0}
\auteur{Francis Gagnon}
\makeatletter\renewcommand*{\UL@typeofdoc}{}\makeatother
%% ============================================================================

\begin{document}
\selectlanguage{french} % pour babel (pas glosmathtool)
\frontmatter         
\frontispice

\printglossary[title=Nomenclature]

\mainmatter                     

\chapter{Documentation et exemple de \texttt{glosmathtools}}

\section{Compilation}
Le package \texttt{glosmathtools} se base sur \texttt{glossaries} inclus dans MiKTeX et TeX Live. Un peu comme une bibliographie, la compilation du glossaire se fait en exÃ©cutant les commandes dans l'ordre suivant :
\begin{enumerate}
	\item \texttt{pdflatex}
	\item \texttt{makeglossaries}
	\item \texttt{pdflatex}
\end{enumerate}
La commande \texttt{makeglossaries} est directement accessible dans les menu de TeXstudio ou avec \texttt{F9}. Pour un autre Ã©diteur, il faut ajouter une commande personnalisÃ©e. Par exemple, dans TexMaker, câ€™est accessible dans le menu \texttt{Utilisateur &gt; Commandes Utilisateur &gt; Ã‰diter Commandes Utilisateur}:
\begin{itemize}
	\item Item menu : \texttt{glossaries} 
	\item Commande : \texttt{makeglossaries \%}
\end{itemize}
Sous Windows avec MiKTeX, il est possible que le script \texttt{makeglossaries} nÃ©cessite une installation de Perl (voir \url{https://tinyurl.com/ybnoyqjp}). Une fois Perl installÃ©, il faut exÃ©cuter le script \texttt{perltex.exe} disponible dans le rÃ©pertoire d'installation de MiKTeX.

\section{Options du package}
Les options du package \texttt{glosmathtools} se rÃ©sument par :
\begin{description}
	\item[qtmarkupright] caractÃ¨re \texttt{&lt;"&gt;} raccourci pour indice sans italique
	\item[singlelineskip] force interligne simple pour la nomenclature
	\item[nodefop] utilisation des opÃ©rateurs et accents sans dÃ©finition
	\item[{[autres options]}] passÃ©s au package \texttt{glossaries}
\end{description}
Par exemple, l'option \textbf{toc} du package \texttt{glossaries} peut Ãªtre ajoutÃ© afin d'inclure la nomenclature dans la table des matiÃ¨res.

\section{Utilisation du package}
Par dÃ©faut, les symboles mathÃ©matiques doivent Ãªtre utilisÃ©s dans le texte pour qu'ils soient ajoutÃ©s Ã&nbsp; la nomenclature, ce qui incite l'auteur Ã&nbsp; introduire ses variables. Il est tout de mÃªme possible de manuellement ajouter un symbole sans y rÃ©fÃ©rer avec la macro \texttt{\textbackslash glsadd\{label\}}, ou \texttt{\textbackslash glsaddall}, pour tout ajouter.

\subsection{Symboles, indices et accentuations}
L'insertion d'un symbole mathÃ©matique simple avec hyperlien se fait avec la macro \texttt{\textbackslash gls} de \texttt{glossaries} : \gls{k}, \gls{mat.A} et \gls{mat.b}. C'est la mÃªme chose pour les abrÃ©viations : la \gls{TL}. Les abrÃ©viations sont uniquement dÃ©finies Ã&nbsp; leur premiÃ¨re utilisation : la \gls{TL}.

Les indices doivent Ãªtre dÃ©finis avec un label du format \texttt{sub.resteDuLabel}: l'indice \gls{sub.a} dÃ©signe l'air. La macro \texttt{\textbackslash glsub} permet d'ajouter un indice Ã&nbsp; une variable : \glsub{d}{v}, \glsub{z}{v}, \glsub{T}{v}, \glsub{D}{a}, \glsub{rho}{w} et \glsub{mu}{v}. En dÃ©finissant les symboles mathÃ©matiques avec \texttt{\textbackslash newglosentrymath}, toutes les macros peuvent s'utiliser autant en mode \texttt{text} qu'en mode \texttt{math} (avec \texttt{\$\$}). Par contre, il est mieux d'Ã©crire explicitement les symboles dans une Ã©quation afin d'allÃ©ger le code (pas d'hyperlien):
\begin{equation}
d"v + \glsub{d}{v} = \SI{10.0}{\centi\meter} = 3.937\qtmark
\end{equation}
Le package peut Ãªtre chargÃ© avec l'option \texttt{qtmarkupright}. Le caractÃ¨re \texttt{&lt;"&gt;} est alors configurÃ© comme raccourci pour l'Ã©criture d'un indice sans italique en mode \texttt{math} (\texttt{&lt;\_&gt;} pour indice italique) \footnote{ La macro \texttt{\textbackslash qtmark} permet d'insÃ©rer le caractÃ¨re \texttt{&lt;"&gt;}. En ISO, les indices reprÃ©sentant l'abrÃ©viation d'un mot s'Ã©crivent sans italique, et, celles reprÃ©sentant une variable, en italique.}. 

La macro \texttt{\textbackslash glsvi} permet d'ajouter une variable en indice Ã&nbsp; une autre variable, et \texttt{\textbackslash glsvisub}, une variable indicÃ©e Ã&nbsp; une autre variable : \glsvi{T}{k} et \glsvisub{T}{z}{v}. Finalement, il est possible d'ajouter deux indices sÃ©parÃ©s par une virgule avec \texttt{\textbackslash glsubs} : \glsubs{D}{w}{a}. En lâ€™occurrence, l'opÃ©rateur virgule est ajoutÃ© dans la nomenclature, qui doit donc Ãªtre dÃ©fini dans le glossaire sous le label \texttt{op.comma}.

Des accents peuvent aussi s'ajouter sur les variables avec la macro \texttt{\textbackslash glsac} : \glsac[dot]{m} et \glsac[bar]{T}. Ã€ leur utilisation respective, un opÃ©rateur est ajoutÃ© dans la nomenclature. Ils doivent donc Ãªtre dÃ©finis Ã&nbsp; leur label respectif. Les accents disponibles sont:
\begin{description} 
\item[dot] $\dot{\bullet}$ (dÃ©fini au label \texttt{op.dot})
\item[ddot] $\ddot{\bullet}$ (dÃ©fini au label \texttt{op.ddot})
\item[bar] $\bar{\bullet}$ (dÃ©fini au label \texttt{op.bar})
\item[hat] $\widehat{\bullet}$ (dÃ©fini au label \texttt{op.hat})
\item[vec] $\vec{\bullet}$ (dÃ©fini au label \texttt{op.vec})
\item[tilde] $\widetilde{\bullet}$ (dÃ©fini au label \texttt{op.tilde})
\end{description}
De plus, un argument optionnel permet d'ajouter des accents Ã&nbsp; toutes les macros prÃ©cÃ©dentes : \glsub[bar]{T}{v} et \glsubs[dot]{m}{v}{a}. Il y a deux arguments optionnels dans le cas de \texttt{\textbackslash glsvi} et \texttt{\textbackslash glsvisub} : \glsvi[dot]{m}{k}, \glsvi[bar][dot]{T}{m} et \glsvisub[][dot]{T}{m}{w}. Finalement, il est possible d'utiliser les accents sans dÃ©finition dans la nomenclature avec l'option \texttt{nodefop}.

\subsection{Langue, abrÃ©viations et nomenclature}
S'il y a des changements de langues Ã&nbsp; travers le document, il faut changer de langue pour les acronymes. La clÃ© \texttt{descseclang} doit Ãªtre prÃ©alablement dÃ©finie dans le glossaire. Par la suite, la macro \texttt{\textbackslash setacronymlang} permet de choisir 4 options de langue: 
\begin{description}
	\item[L1] description langue principale (abrÃ©viations) : \setacronymlang{L1}\acrfull{ODE}
	\item[L2] description langue seconde (abrÃ©viations) : \setacronymlang{L2}\acrfull{ODE}
	\item[L1L2] description bilingue, langue principale (abrÃ©viations, \textit{langue seconde}) : \setacronymlang{L1L2}\acrfull{ODE}
	\item[L2L1] description bilingue, langue seconde (abrÃ©viations, \textit{langue principale}) : \setacronymlang{L2L1}\acrfull{ODE}
\end{description}
\setacronymlang{L2}% retour Ã&nbsp; la langue du document
L'environnement \texttt{acronymlang} fonctionne de maniÃ¨re similaire : \begin{acronymlang}{L2L1}\acrfull{ODE}\end{acronymlang}. La macro \texttt{\textbackslash glslang} affiche l'acronyme dans la langue spÃ©cifiÃ©e : \glslang[L2L1]{ODE}. Les secondes descriptions sont aussi accessibles avec \texttt{\textbackslash glsdescsec} : une \glsdescsec{ODE}.

Pour la nomenclature (ou liste des symboles), il est important de dÃ©finir la plus longue entrÃ©e avec \texttt{\textbackslash glssetwidest} au prÃ©ambule.
Comme les abrÃ©viations, il est possible de changer sa langue avec 4 options de style pour \texttt{\textbackslash setglossarystyle}:
\begin{description}
	\item[nomencl-L1] (ou \textbf{nomencl}) descriptions langue principale
	\item[nomencl-L2] descriptions langue seconde
	\item[nomencl-L1L2] descriptions bilingues, langue principale (\textit{langue seconde})
	\item[nomencl-L2L1] descriptions bilingues, langue seconde (\textit{langue principale})
\end{description}
L'option \texttt{singlespaceglos} du package permet de forcer un interligne simple pour la nomenclature (nÃ©cessite \texttt{ulthese}/\texttt{memoir} ou le package \texttt{setspace}). La macro \texttt{\textbackslash glscatnamefmt} peut Ãªtre redÃ©finie au prÃ©ambule afin de modifier le style de l'en-tÃªte des catÃ©gories. L'exemple de la page ii est une nomenclature bilingue \textbf{nomencl-L2L1} en interligne simple.

Si dÃ©fini, le contenu de la clÃ© \texttt{symbol} est ajoutÃ© a la fin de la description (pour les unitÃ©s ou dimensions). Ã€ noter que les symboles mathÃ©matiques ne sont pas enregistrÃ©s dans cette clÃ©, mais bien dans la clÃ© \texttt{name}.

\end{document}</pre></body></html>