% \iffalse % % Copyright 2017 HEC Montreal % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3c % of this license or (at your option) any later version. % % The latest version of this license is in % http://www.latex-project.org/lppl.txt % and version 1.3c or later is part of all distributions of LaTeX % version 2008/05/04 or later. % % This work has the LPPL maintenance status `maintained'. % % The Current Maintainer of this work is Benoit Hamel % . % % This work consists of the files hecthese.dtx and hecthese.ins % and the derived files listed in the README file. % % \fi % \iffalse %<*dtx> \ProvidesFile{hecthese.dtx} % %\NeedsTeXFormat{LaTeX2e} %\ProvidesClass{hecthese}[2017/11/29 v1.2 Classe pour les theses et memoires de HEC Montreal] %<*driver> \documentclass[10pt,english,frenchb]{ltxdoc} \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage{babel} \usepackage[autolanguage]{numprint} \usepackage{fontawesome} \usepackage{framed} \usepackage{url} \usepackage{color} \usepackage{enumitem} \usepackage{hyperref} \DisableCrossrefs \CodelineIndex \RecordChanges \GlossaryPrologue{\section*{Historique des versions}% \addcontentsline{toc}{section}{Historique des versions}} \definecolor{liens}{rgb}{0,0.35,0.65} \definecolor{shadecolor}{rgb}{0.93,0.97,0.99} \definecolor{TFFrameColor}{rgb}{0,0.235,0.443} \definecolor{TFTitleColor}{rgb}{1,1,1} \hypersetup{ colorlinks=true, allcolors=liens, pdftitle={Guide d'utilisation de la classe hecthese}, pdfauthor={Benoit Hamel, HEC Montréal} } \frenchbsetup{ og=«, fg=» } \addto\captionsfrench{% \renewcommand{\tablename}{Tableau} } \MakeShortVerb{\+} \newcommand{\hecthese}{\textsf{\bfseries hecthese}} \newcommand{\oui}{\color{green}\faCheck} \newcommand{\non}{\color{red}\faBan} \newlist{HECcompilation}{itemize}{1} \setlist[HECcompilation]{label=\faCog} \begin{document} \DocInput{hecthese.dtx} \end{document} % % \fi % \CheckSum{460} % \DoNotIndex{\RequirePackage,\ExecuteOptions,\ifthenelse,\ProcessOptions} % \DoNotIndex{\newcommand,\newcommand*,\newboolean,\setboolean} % \DoNotIndex{\emph,\cite,\LaTeX,\hecthese,\textbf,\item,\footnote} % \DoNotIndex{\label,\ref,\caption,\hline,\multicolumn,\oui,\non,\cmd} % \DoNotIndex{\dots,\url,\clearpage,\bibitem} % \changes{1.2}{2017-11-29}{Mise à jour des liens vers les capsules vidéos dans % la documentation.} % \changes{1.1}{2017-10-20}{Uniformisation de la licence lppl dans tous les fichiers. % Ajout de liens vers des capsules vidéos dans la documentation.} % \changes{1.0}{2017-10-06}{Première version de production lancée publiquement. % Ajout du préfixe HEC à toutes les commandes publiques. Révision, % correction et augmentation de la documentation. Ajout des sections non numérotées % "mots clés" et "méthodes de recherche" dans le résumé et l'abstract. Prise en charge % de l'anglais pour les intitulés de chapitres et sections. Correction du bogue d'affichage % des citations "hors articles" dans les thèses et mémoires par articles.} % \changes{0.4.1}{2017-06-08}{Ajout d'une condition pour vérifier la présence du sous-titre % dans la mise en forme de la page d'identification du jury.} % \changes{0.4}{2017-06-01}{Retrait de la section «Mise en garde» de la documentation et % ajout de l'encadré «Phase de tests de la version bêta. Lancement du package pour fins % de tests.} % \changes{0.3}{2017-05-29}{Retrait du package +mathptmx+ des packages requis par la classe. % Ajout du choix de polices entre +mathptmx+ et +mathpazo+ dans les gabarits. Ajout des % sections «Rédaction» et «Compilation» dans la documentation.} % \changes{0.2}{2017-05-18}{Première version bêta lancée pour les tests usagers} % \title{{\hecthese} : la classe {\LaTeX} pour les thèses et mémoires de HEC Montréal} % \author{Benoit Hamel, Bibliothèque, HEC Montréal} % \date{\today} % \maketitle % % \begin{abstract} % La classe {\LaTeX} {\hecthese} a été conçue pour permettre aux étudiants de HEC Montréal % de rédiger leur thèse ou leur mémoire à l'aide du système de préparation de documents tout % en se conformant aux règles de présentation en vigueur à l'École. À ce titre, la classe % répond en tous points aux normes de présentation énoncées dans le % \emph{Guide pour la rédaction d'un travail universitaire de 1er, 2e et 3e cycles}\cite{guideRedaction}, ci-après % nommé le \emph{Guide de rédaction}. % \end{abstract} % % \section{Installation de la classe} % % \subsection{Prérequis} % % L'utilisation de cette classe suppose que vous avez déjà installé une distribution TeX et % un éditeur de code intégré. Pour la conception de {\hecthese}, la distribution TeXLive 2016\cite{texlive} % et l'éditeur de code TeXStudio\cite{texstudio} ont été utilisés et ses fonctionnalités ont % été testées avec les compilateurs +latex+, +pdflatex+, +bibtex+ et +makeindex+. % Nous vous invitons à tester la classe {\hecthese} avec vos propres distributions TeX et % éditeurs de codes et à l'utiliser de la même manière dont vous vous servez de vos outils pour vos % autres travaux en {\LaTeX}. % % \subsection{Installation} % % L'archive +.zip+ que vous avez téléchargée contient les quatre fichiers suivants : % % \begin{enumerate} % \item \textbf{hecthese.ins} : le fichier d'installation de la classe; % \item \textbf{hecthese.dtx} : le code source documenté de la classe; % \item \textbf{hecthese.pdf} : la documentation de la classe; % \item \textbf{README.md} : le fichier nécessaire à l'affichage de la % description de la classe sur le site ctan.org. % \end{enumerate} % % Suivez les étapes suivantes pour installer la classe % \footnote{Une vidéo d'installation est aussi disponible au \url{https://www.youtube.com/watch?v=nfTEgcJbufs}.} : % % \begin{enumerate} % \item Créez-vous un répertoire de travail. % \item Décompressez l'archive +.zip+ dans votre répertoire de travail. % \item Ouvrez un éditeur de ligne de commande. % \item Changez de répertoire pour atteindre votre répertoire de travail. % \item Saisissez la commande suivante dans l'éditeur : \\ % \begin{shaded*} % +latex hecthese.ins+ % \end{shaded*} % \end{enumerate} % % La commande créera une série de fichiers qui composeront votre travail, et la liste des % fichiers que vous aurez à utiliser dépendra du type de travail que vous composerez. % % \subsection{\label{liste-fichiers}Liste des fichiers constitutifs d'un travail} % % Le Tableau \ref{tableau:fichiers} montre la liste des fichiers composant chaque type de document. En fonction % du type de votre travail, vous devrez choisir l'un des quatre gabarits suivants : % % \begin{itemize} % \item \textbf{gabarit-these-classique.tex} : gabarit pour une thèse rédigée de manière classique; % \item \textbf{gabarit-these-articles.tex} : gabarit pour une thèse rédigée par articles; % \item \textbf{gabarit-memoire-classique.tex} : gabarit pour un mémoire rédigé de manière classique; % \item \textbf{gabarit-memoire-articles.tex} : gabarit pour un mémoire rédigé par articles. % \end{itemize} % % \begin{table}[tb] % \caption{\label{tableau:fichiers} Liste des fichiers constitutifs d'un travail} % \begin{center} % \begin{tabular}{l|cc|cc} % \hline\hline % & \multicolumn{2}{c|}{Thèses} & \multicolumn{2}{c}{Mémoires} \\ % \textbf{Fichier} & Classiques & Par articles & Classiques & Par articles \\ % \hline % gabarit-these-*.tex & \oui & \oui & \non & \non \\ % gabarit-memoire-*.tex & \non & \non & \oui & \oui \\ % resume-francais.tex & \oui & \oui & \oui & \oui \\ % resume-anglais.tex & \oui & \oui & \oui & \oui \\ % liste-abreviations.tex & \oui & \oui & \oui & \oui \\ % dedicace.tex & \oui & \oui & \non & \non \\ % remerciements.tex & \oui & \oui & \oui & \oui \\ % avant-propos.tex & \oui & \oui & \oui & \oui \\ % introduction.tex & \oui & \oui & \oui & \oui \\ % cadre-theorique.tex & \non & \oui & \non & \non \\ % revue-litterature.tex & \non & \non & \oui & \oui \\ % chapitre-1.tex & \oui & \non & \oui & \non \\ % chapitre-2.tex & \oui & \non & \oui & \non \\ % chapitre-3.tex & \oui & \non & \oui & \non \\ % article-1.tex & \non & \oui & \non & \oui \\ % article-2.tex & \non & \oui & \non & \non \\ % article-3.tex & \non & \oui & \non & \non \\ % conclusion.tex & \oui & \oui & \oui & \oui \\ % annexe.tex & \oui & \oui & \oui & \oui \\ % \hline\hline % \end{tabular} % \end{center} % \end{table} % % Une fois que vous aurez choisi un gabarit, supprimez les trois fichiers gabarits dont vous % n'aurez pas besoin. Ce fichier constitue le fichier maître à partir duquel vous lancerez les % diverses compilations nécessaires à la génération de votre document final. C'est également dans le % gabarit que vous saisirez les métadonnées relatives à votre travail (auteur, titre, etc.) et que % vous ajouterez les +packages+, commandes et environnements nécessaires à votre rédaction. % % La rédaction en tant que telle se fera dans les autres fichiers. Chaque fichier représente une % section de votre travail. Leur nom est donc, comme on le dit en chinois, \emph{self-explanatory}. % Vous pourrez en ajouter ou en supprimer à votre guise. Assurez-vous seulement % d'inclure les fichiers ajoutés dans le gabarit avec la commande \cmd{\include}, de supprimer les % \cmd{\include} relatifs aux fichiers supprimés, mais surtout, de respecter les règles du % \emph{Guide de rédaction} en ce qui concerne les sections obligatoires et % l'ordre de présentation des sections. % % \section{Utilisation de la classe} % % La classe {\hecthese} a été conçue pour être la plus simple et la plus flexible possible. Le but premier % de la classe étant la mise en forme de votre thèse ou mémoire selon les normes du % \emph{Guide de rédaction}, vous aurez tout le loisir d'ajouter toutes les fonctionnalités % que vous désirez. % % {\hecthese} est basée sur la classe +memoir+\cite{memoir}, qui fournit déjà de très nombreuses % fonctionnalités. Avant de programmer de nouvelles commandes ou de nouveaux environnements, nous % vous invitons donc à consulter l'imposante documentation de la classe % \footnote{L'auteur de la présente classe n'a d'ailleurs pas encore lu la documentation de la classe +memoir+ % % au complet. \emph{Mea culpa}...}. % % \subsection{Options de la classe} % % La classe comporte très peu d'options de base. Celles-ci ne concernent que la taille de la % police de caractères, la langue du document ainsi que le type de document que vous rédigez. Elles se retrouvent toutes % à l'intérieur de la commande \cmd{\documentclass}. % % \begin{DescribeMacro}{10pt,11pt,12pt} % Le \emph{Guide de rédaction} mentionne à la page 15 que «[la] taille des caractères % varie généralement entre 10 et 12 points pour le texte courant»\cite{guideRedaction}. Vous inscrivez % donc l'une des trois options permises, soit +10pt+, +11pt+ ou +12pt+. Si vous n'inscrivez % aucune taille de police de caractères dans les options, la classe utilisera l'option % +12pt+ par défaut % \footnote{À titre d'exemple, cette documentation a été écrite avec la taille +10pt+}. % \end{DescribeMacro} % % \begin{DescribeMacro}{english,frenchb} % Les options +english+ et +frenchb+ sont propres au +package+ +babel+\cite{babel} et servent à indiquer % au compilateur la ou les langues utilisées dans le document. La dernière langue de la liste % est la langue par défaut du document. Même si ces options sont propres à +babel+, nous % les insérons dans les options de la classe pour qu'elles s'appliquent globalement à % tous les +packages+ qui pourraient en avoir besoin. % \end{DescribeMacro} % % \begin{DescribeMacro}{phdclassique} % \end{DescribeMacro} % \begin{DescribeMacro}{phdarticles} % \end{DescribeMacro} % \begin{DescribeMacro}{mscclassique} % \end{DescribeMacro} % \begin{DescribeMacro}{mscarticles} % Vous utilisez l'option +phdclassique+ lorsque vous rédigez une thèse de manière classique, % +phdarticles+, une thèse par articles, +mscclassique+, un mémoire classique et +mscarticles+ % % lorsque vous rédigez un mémoire par articles. Chacune de ces options est inscrite % automatiquement dans le fichier gabarit approprié au type de % document lorsque vous installez {\hecthese}. La classe considérant par défaut que le travail % que vous rédigez est une thèse classique, vous pourriez à la limite supprimer % l'option +phdclassique+ de la commande \cmd{\documentclass} du fichier % \textbf{gabarit-these-classique.tex}, mais nous vous conseillons de % la laisser dans la liste afin d'éviter des problèmes. % % En ce qui a trait aux trois autres options de types de document, % \textbf{ne supprimez pas l'option de la commande \cmd{\documentclass}!}. Ce faisant, % vous aurez des problèmes lors de la compilation de votre document, notamment pour % la génération des bibliographies et des pages titre. % \end{DescribeMacro} % % \subsection{Commandes de la classe} % % La classe {\hecthese} comprend quelques commandes qu'on pourrait répartir en trois catégories : % \begin{enumerate} % \item les métadonnées de votre document (auteur, titre, etc.) servant à générer la (les) % page(s) titre ; % \item les commandes de mise en forme du document ; % \item les commandes liées aux bibliographies des thèses et mémoires par articles. % \end{enumerate} % % \subsubsection{Métadonnées du document}\label{commandes:meta} % % Les commandes ci-dessous s'appliquent à tous les types de documents. % % \begin{DescribeMacro}{\HECtitre} % Il s'agit du titre de votre thèse ou mémoire. N'utilisez pas la commande {\LaTeX} % \cmd{\title}, car la classe n'en tiendra pas compte. Si votre titre est très long, % séparez-le en plusieurs lignes avec la commande \cmd{\\}. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECsoustitre} % Il s'agit du sous-titre de votre thèse ou mémoire, s'il y a lieu. Si votre travail % comporte un sous-titre, un : séparera automatiquement le titre du sous-titre et ce % dernier s'affichera sous le titre sans qu'il soit nécessaire d'insérer la commande % \cmd{\\} dans le titre. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECauteur} % L'auteur de la thèse ou du mémoire, c'est vous, à moins que vous n'ayez plagié votre % travail\dots Écrivez votre nom sous la forme \emph{Prénom Nom}. N'utilisez pas la commande % {\LaTeX} \cmd{\author}, car la classe n'en tiendra pas compte. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECoption} % La commande \cmd{\HECoption} détermine l'option de votre grade de maîtrise ou de doctorat. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECmoisDepot} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECanneeDepot} % Les commandes \cmd{\HECmoisDepot} et \cmd{\HECanneeDepot} représentent le mois et l'année du % \textbf{dépôt final} de votre travail. Inscrivez le mois en toutes lettres et l'année % au format AAAA. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECpdfauteur} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECpdftitre} % Ces deux commandes sont des variantes de \cmd{\HECauteur} et \cmd{\HECtitre} et servent % exclusivement à l'inclusion de métadonnées dans le document pdf généré. Pour ce % faire, elle sont utilisées avec les options +pdftitle+ et +pdfauthor+ de la commande % \cmd{\hypersetup} du +package+ +hyperref+\cite{hyperref}. % \end{DescribeMacro} % % Les commandes qui suivent ne s'appliquent qu'aux thèses. Si votre travail est un % mémoire, vous pouvez passez à la Section \ref{commandes:layout}. % % \begin{DescribeMacro}{\HECpresidentRapporteur} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECdirecteurRecherche} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECcodirecteurRecherche} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECexaminateurExterne} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECrepresentantDirecteur} % Chacune de ces commandes représentent un intervenant dans votre travail. Le premier % argument est le nom de l'intervenant au format \emph{Prénom Nom}, tandis que le deuxième est le % genre de l'intervenant, homme (M) ou femme (F). Il est important d'indiquer le genre % de chacun des intervenants, car cela va affecter la manière dont sera affiché leur % titre sur la page d'identification du jury, et la remise d'une thèse n'est pas tout à % fait le bon moment pour heurter les sensibilités de ceux et celles qui vont vous % évaluer\dots % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECmembreJury} % Cette commande a la même fonction que les cinq précédentes, c'est-à-dire nommer % explicitement un intervenant dans votre thèse, mais elle ne prend qu'un seul % argument, le nom au format \emph{Prénom Nom}, car le titre de la fonction est % épicène. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECuniversiteCodirecteur} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECuniversiteMembreJury} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECuniversiteExaminateur} % Par défaut, la classe {\hecthese} indique que le codirecteur, le membre du jury ainsi % que l'examinateur externe proviennent de HEC Montréal, mais ils pourraient provenir % d'une autre université. Modifiez le nom de l'université dans toutes les commandes % nécessaires, le cas échéant. % \end{DescribeMacro} % % \subsubsection{Mise en forme}\label{commandes:layout} % % \begin{DescribeMacro}{\HECpagestitre} % Les pages titre diffèrent en fonction du type de document, tel qu'il est montré dans % les modèles de pages titre du \emph{Guide de rédaction}. De plus, une page d'identification % du jury est insérée à la suite de la page titre dans les thèses. La commande % \cmd{\HECpagestitre} met en forme automatiquement toutes les pages de titre en utilisant % le contenu des commandes de la Section \ref{commandes:meta}. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECtitreIntroduction} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECtitreConclusion} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECgenererTitres} % Les commandes \cmd{\HECtitreIntroduction} et \cmd{\HECtitreConclusion} sont placées en % tant qu'argument des commandes \cmd{\chapter*} situées au début des fichiers % \textbf{introduction.tex} et \textbf{conclusion.tex} respectivement. Elles servent % à indiquer le titre de ces parties de votre travail, titre généré à l'aide de la commande % \cmd{\HECgenererTitres}. Si vous rédigez votre thèse ou mémoire de manière classique, % les titres seront tout simplement «Introduction» et «Conclusion» ; dans le cas contraire, % ces sections seront intitulées «Introduction générale» et «Conclusion générale» pour les % distinguer des introductions et des conclusions des articles. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECtdmAbreviations} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECtdmRemerciements} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECtdmAvantPropos} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECtdmCadreTheorique} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECtdmRevueLitterature} % \end{DescribeMacro} % \begin{DescribeMacro}{\HECtdmResumeArticle} % Plusieurs parties d'une thèse ou d'un mémoire étant des sections et chapitres «maison», % il n'existe pas de traduction anglaise d'office pour celles-ci. La classe {\hecthese} pallie % à cette situation en détectant la langue et en générant le titre approprié pour de nombreuses % sections du document : l'introduction et la conclusion générales des thèses et mémoires par articles, % la liste des abréviations, les remerciements, l'avant-propos, le cadre théorique, la revue de littérature % et le résumé de chacun des articles. % \end{DescribeMacro} % % \subsubsection{Les bibliographies des thèses et mémoires par articles} % % Dans les thèses et mémoires rédigés par articles, il y a plusieurs bibliographies : une % par article et une générale pour l'ensemble du travail. La classe {\hecthese} utilise % le +package chapterbib+\cite{chapterbib} pour permettre la publication de ces nombreuses bibliographies. % % \begin{DescribeMacro}{\HECbibliographieArticle} % Le +package chapterbib+ ne s'accorde cependant pas très bien avec la classe +memoir+ en ce qui % concerne la place de chacune des bibliographies dans les divisions du document. La % commande \cmd{\HECbibliographieArticle} s'assure donc que les bibliographies des articles % seront positionnées en tant que section non numérotées à l'intérieur des articles. C'est % pourquoi, dans les gabarits par articles, cette commande est placée après la commande % \cmd{\HECpagestitre}. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECbibliographieGenerale} % Cette commande sert à positionner la bibliographie générale du travail en tant % que «chapitre» (au sens {\LaTeX} du terme) non numéroté. Cette commande est placée % tout juste avant la commande \cmd{\bibliographystyle} du gabarit. % \end{DescribeMacro} % % \begin{DescribeMacro}{\HECreferences} % Le +package chapterbib+ remplit très bien son rôle de création de bibliographies multiples. Le % hic, c'est qu'il faut inclure la commande \cmd{\bibliography} dans chaque fichier inclus % dans un document pour que les citations s'affichent correctement. Ce faisant, une bibliographie % est générée pour chacun de ces fichiers. Or, dans des sections comme l'introduction, % les résumés ou encore la conclusion, la bibliographie ne doit pas être affichée, % car elle est incluse dans la bibliographie générale du document. La commande \cmd{\HECreferences} % permet d'insérer des citations et de les voir s'afficher correctement sans qu'une bibliographie % soit générée dans une section donnée. Sa syntaxe est la suivante : % % \begin{shaded*} % \cmd{\HECreferences\{