\documentclass[12pt,a4paper,twoside]{report} \usepackage[utf8]{inputenc} %encodage des caractères \usepackage[french]{babel} %règle typographique du français, francisation des titres, etc. \usepackage{csquotes} \usepackage[T1]{fontenc} %encodage des caractères accentués \usepackage{amsmath} \usepackage{amsfonts} \usepackage{amssymb} \usepackage{graphicx} \usepackage{lmodern} \usepackage{multirow} %permet de fusionner les lignes des tableaux \usepackage{colortbl} %permet de coloriser les cellules des tableaux \usepackage{wrapfig} %permet d'enrober une image de texte \usepackage{hyperref} %package pour les liens urls \usepackage{color} %package permettant de coloriser le texte \usepackage[backend=biber,style=apa]{biblatex} \usepackage[left=1.5cm,right=1.5cm,top=2cm,bottom=2cm]{geometry} %gestion titre / auteurs \usepackage{multicol} \title{Mon premier document LaTeX} \author{Dimitri Donzé, Vincent Huber, Igor Milhit} \addbibresource{références_LaTeX.bib} \begin{document} \maketitle \tableofcontents \chapter{LaTeX et ses principes} \section{Définition et principes de base} LaTeX est un langage informatique permettant de rédiger et mettre en page des textes. Il est donc utilisé dans certains domaines comme un traitement de texte où l'utilisateur se concentre avant tout sur la structure du document \parencite{tailletBienDebuterLaTeX2022,gautreletIntroductionLaTeX2020}. Un éditeur LaTeX n'étant pas WYSIWYG, il sera nécessaire à l'utilisateur/trice de taper à la fois le texte proprement dit, mais également les commandes structurant et mettant en page le contenu \parencite{maguisRedigezDocumentsQualite2010,gerinPetitGuidePour2008}. Ce contrôle dans la structure et la mise en forme du document demande généralement un temps d'apprentissage et d'adaptation non négligeables lors de la création de ses premiers documents. Pour autant, votre utilisation fréquente et sa popularité dans certaines disciplines gommeront la majorité de ses difficultés. Ainsi, certaines institutions proposent des templates déjà préparés pour les différents types de documents rédigés au sein de celles-ci. De plus, il est relativement aisé de reprendre la structure d'un ancien document pour la réutiliser dans un nouveau ; le rédacteur ou la rédactrice n'aura ainsi plus qu'à se concentrer sur le contenu du document, la mise en forme ayant été définie \textit{a priori} \parencite{gerinPetitGuidePour2008}. LaTeX affiche également divers avantages en comparaison des éditeurs de texte WYSIWYG tels que WORD. Ce contrôle permet une personnalisation accrue des besoins du rédacteur/trice. D'une manière générale presque tout dans LaTeX est personnalisable ou paramétrable \parencite{maguisRedigezDocumentsQualite2010}.\\ Les avantages de LaTeX sont notamment \parencite{tailletBienDebuterLaTeX2022,maguisRedigezDocumentsQualite2010}: \begin{itemize} \item Hiérarchisation des différentes parties d'un document (parties, chapitres, sections, etc.). Les différentes parties sont alors numérotées automatiquement \item Gestion typographique des éléments mathématiques (équations...) et des caractères spéciaux (lettres grecques, symboles, etc.). \item Gestion des \textit{éléments flottants} tels que les images, graphiques, tableaux, etc. \item Facilité de faire référence à un élément antérieur en le labelisant. \item Le format du document source en texte brut rendant le contenu lisible par de nombreux logiciels mais rendant les instructions prévisibles et reproductibles. \end{itemize} \subsection*{Éditeur et distribution LaTeX} Concrètement, LaTeX fonctionne avec deux outils complémentaires. \begin{enumerate} \item Un éditeur LaTeX \item Une distribution LaTeX \end{enumerate} Certains outils, notamment en ligne \textcolor{blue}{(\href{https://www.overleaf.com}{overleaf}}, \textcolor{blue}{\href{https://papeeria.com/}{papeeria}}...), incluent les deux ensemble, alors que si vous travaillez en local, il sera peut-être nécessaire d'installer un élément de chaque. \textbf{L'éditeur} est l'outil permettant concrètement de structurer et de rédiger votre document LaTeX. Au final, il n'est pas indispensable dans le sens où vous pouvez potentiellement écrire vos commandes LaTeX dans votre bloc-notes mais il propose de nombreux avantages vous facilitant le travail, notamment des commandes pré-dénfinies, une signalisation et analyse des erreurs, etc.\\ \textbf{La distribution LaTeX} est le logiciel permettant de lire et analyser le langage LaTeX ainsi que les autres fichiers affiliés dans le but de les compiler notamment en un fichier PDF lisible pour une personne humaine. C'est également la distribution qui va inclure les packages qui seront appelés dans le document. %test d'image \begin{figure}[!h] \centering \includegraphics[scale=0.5]{Images/shéma_compilation.jpg} \caption{Schéma décrivant le rôle de l'éditeur et de la distribution LaTeX. Inspiré de \parencite{gautreletIntroductionLaTeX2020}} \end{figure} \section{Logiciels à installer} \subsection*{Windows} \begin{itemize} \item Distribution \begin{itemize} \item \textcolor{blue}{\href{https://miktex.org/download}{MiKTeX}}. Pour installer MiKTeX, veuillez vous référer \textcolor{blue}{\href{https://www.xm1math.net/doculatex/install_miktex.html}{au tutoriel complet décrit sur le site de TeXmaker}} \end{itemize} \item Éditeurs \begin{itemize} \item \textcolor{blue}{\href{https://www.xm1math.net/texmaker/download_fr.html}{TeXmaker}}. TeXmaker est un éditeur libre et multiplateforme. C'est le logiciel que nous utiliserons comme exemple dans ce polycopié et durant le cours. \item \textcolor{blue}{\href{https://www.texniccenter.org/download/}{TeXnicCenter}} \item \textcolor{blue}{\href{https://tug.org/texworks/}{TeXworks}} \end{itemize} \end{itemize} \subsection*{MAC} \begin{itemize} \item Distribution \begin{itemize} \item \textcolor{blue}{\href{https://tug.org/mactex/}{MacTeX}} \end{itemize} \end{itemize} \begin{itemize} \item Éditeurs \begin{itemize} \item \textcolor{blue}{\href{https://www.xm1math.net/texmaker/download_fr.html}{TeXmaker}}. TeXmaker est un éditeur libre et multiplateforme. C'est le logiciel que nous utiliserons comme exemple dans ce polycopié et durant le cours. \item \textcolor{blue}{\href{https://pages.uoregon.edu/koch/texshop/}{TeXShop}} \item \textcolor{blue}{\href{https://tug.org/texworks/}{TeXworks}} \end{itemize} \end{itemize} \subsection*{Linux} \begin{itemize} \item Distribution \begin{itemize} \item \textcolor{blue}{\href{https://tug.org/texlive/}{TeX Live}} \end{itemize} \end{itemize} \begin{itemize} \item Éditeurs \begin{itemize} \item \textcolor{blue}{\href{https://www.xm1math.net/texmaker/download_fr.html}{TeXmaker}}. TeXmaker est un éditeur libre et multiplateforme. C'est le logiciel que nous utiliserons comme exemple dans ce polycopié et durant le cours. \item \textcolor{blue}{\href{https://kile.sourceforge.io/}{Kile}} \item \textcolor{blue}{\href{https://tug.org/texworks/}{TeXworks}} \end{itemize} \end{itemize} \subsection{logiciels multi-usage} Possibilité de configurer des éditeurs généralistes pour l'adapter à des langages comme LaTeX pour avoir les mêmes types d'options que les logiciels spécialisés ci-dessus. VS Code\\ Visual Studio \section{Outils en ligne} Les outils en ligne peuvent être une alternative très intéressante aux suites à installer. Dans ce cas-ci, l'éditeur et la distribution sont intégrés dans un outil à utiliser directement dans le navigateur web. Il y est nécessaire de se créer un compte afin de gérer ses projets. L'intérêt est donc un outil souvent plus facile d'accès (rien à installer, une interface WYSIWYG...), plus souple et peut être utiliser sur plusieurs ordinateurs à la fois. De plus, il est généralement possible de partager des projets à plusieurs, ce qui peut être très utile lors de la rédaction en groupe. \\ L'inconvénient principal est que ses fonctions avancées sont généralement payantes. Il est possible de créer un compte gratuit mais les fonctions y sont limitées suite à une période d'essai. De plus, les serveurs y sont parfois surchargés, limitant l'accès à vos projets. Pour l'instant, l'UNIGE ne propose aucune licence institutionnelle pour l'un de ces produits. Par contre, certains laboratoires/bureaux ont leur propre licence. Nous vous conseillons de vous informer auprès de vos collègues. La plupart de ces outils offrent la possibilité de sauvegarder localement ses fichiers permettant de travailler hors ligne. \subsection{Overleaf} \begin{wrapfigure}{R}{0.1\textwidth} \includegraphics[width=0.1\textwidth]{Images/ologo_square_colour_light_bg.png} \end{wrapfigure} \textcolor{blue}{\href{https://fr.overleaf.com}{Overleaf}} est l'un des outils en ligne les plus connus. Vous avez la possibilité de passer facilement d'une vue en commandes LaTeX en éditeur de texte WYSIWYG en un seul clic. La fonction payante est très complète (intégration de Zotero, Mendeley et de GitHub, Projets à plusieurs...) mais coûte cher (plus de 100CHF par année au minimum !!) alors que la version gratuite offre des options limitées mais qui peuvent suffire tout du moins pour se faire la main. Par exemple, le nombre de projets n'y est pas limité. De plus, vous avez accès à de très nombreux modèles de documents prédéfinis que vous pourrez utiliser ou desquels vous inspirer. \subsection{Papeeria} \begin{wrapfigure}{R}{0.1\textwidth} \includegraphics[width=0.1\textwidth]{Images/papeeria.png} \end{wrapfigure} \textcolor{blue}{\href{https://papeeria.com/}{Papeeria}} propose également une version gratuite et une version payante de son outil. La version gratuite propose l'édition à plusieurs mais seul un projet peut être en mode privé. C'est-à-dire que vos autres documents seront visibles sur la plateforme. La version payante est moins onéreuse qu'Overleaf (5\$ par mois) mais n'autorise que 10 projets privés. Papeeria ne semble pas avoir d'éditeur WYSIWYG non plus. \subsection{LaTeXBase} \textcolor{blue}{\href{https://papeeria.com/}{LaTeXBase}} ne propose pas de travaux privés en version gratuite. Cependant, la version payante ne coûte que 4\$ par mois pour les étudiant-es. \section{Structure d'un document LaTeX} Un document LaTeX est composé de divers éléments qu'il est important de distinguer et de maîtriser afin de les compléter ou modifier correctement. D'une manière générale, un document LaTeX est composé de deux parties \parencite{gautreletIntroductionLaTeX2020}: \begin{itemize} \item Le préambule: celui-ci contiendra les commandes définissant le type de document (livre, rapport, présentation, etc.), sa forme générale (marges, format de feuille, orientation, etc.), les extensions (packages), le lien avec le fichier de références bibliographiques, ainsi que des informations complémentaires comme le titre, les auteurs, etc. \item Le corps du document: le corps du document fait suite au préambule. il est composé du texte proprement dit qui sera affiché dans le fichier PDF, dans une structure bien définie (chapitres, sections, sous-sections, etc.). \end{itemize} Voici un exemple de structure de document LaTeX adapté de \parencite{gautreletIntroductionLaTeX2020}: \begin{figure}[!h] \centering \includegraphics[scale=0.5]{Images/structure_doc.jpg} \end{figure} \chapter{TeXmaker} \section{Parties principales d'une fenêtre TeXmaker} METTRE CAPTURE D'éCRAN AVEC DESCRIPTION DES DIFFERENTES PARTIES DE LA FENÊTRE. \section{Paramètres et personnalisation} \chapter{Commandes principales} Les commandes développées ci-dessous ne sont bien sûr pas exhaustives. Il ne s'agit là que de propositions et d'exemples afin de fournir les bases avec lesquelles débuter LaTeX. Nous vous recommandons de vous documenter sur une liste plus complètes des options possibles. De plus, les éditeurs LaTeX proposent généralement pour écrire les commandes automatiquement sans avoir à les taper soi-même. Il s'agit généralement de boutons à cliquer ou d'options à choisir dans les menus. Nous les préciserons au fur et à mesure pour \textbf{TeXmaker} \section{Les types de documents} La première ligne du fichier LaTeX définit le type de document créé. Elle se présente comme ceci:\\ \texttt{\textbackslash documentclass\{type de document\}}\\ Où l'on précise entre les \{\} le type de document en question, par exemple: \begin{itemize} \item \texttt{article} \item \texttt{report} \item \texttt{book} \item \texttt{memoir} \item \texttt{letter} \item etc. \end{itemize} Ce choix de départ peut avoir une importance car il va prédeterminer certaines disponibilités de commandes , certains choix typographiques ou de structure du document. Par exemple, il est prévu que les documents de la classe \textit{article} soient moins longs que les documents de la classe \textit{report} ou \textit{book}. Ainsi, le niveau \textit{Chapter} dans la structuration n'y est pas présent contrairement aux deux autres. De même, le texte débute sur la même page que le titre principal contrairement aux deux autres. Des changements par défaut dans la mise en page y sont également présent. Il est tout de même possible pour l'utilisateur/trice de préciser certaines préférences de mise en page dès cette commande en les mettant entre [ ] après le \texttt{\textbackslash documentclass}. On peut ainsi préciser la taille de la police par défaut en pt, le format de la page, si le texte est sera sur une ou plusieurs colonnes... Exemple:\\ \texttt{\textbackslash documentclass[10pt,a4paper]\{article\}} \textbf{TeXmaker} vous permet de définir toutes ces options très facilement dès le départ. Pour cela, à partir d'une nouveau fichier LaTeX vierge, cliquez sur \textit{Assistants} --> \textit{Assistant nouveau document} --> choisissez vos préférences pour chaque critère. \'A noter que vous pouvez déjà à ce niveau-là sélectionner certains packages que vous prévoyez d'utiliser.\\ \begin{figure}[!h] \centering \includegraphics[width=0.8\textwidth]{Images/assisstant_document_class.jpg} \end{figure} \section{Packages} Les packages sont des extensions stockées dans la distribution LaTeX (MiKTeX dans notre cas). Par défaut, votre éditeur LaTEX local n'est que très limité en termes de personnalisation; pour résumer, vous ne pourriez écrire que du texte brut. Selon vos besoins, vous appelerez donc les packages afin de personnaliser les options de votre documents. Les distributions que nous avons conseillées d'installer comportent de très nombreux packages mais sachez que si certains s'avèrent à manquer, vous pourrez toujours les ajouter à votre distribution. Notez également que lorsque vous définissez une classe de document dans TeXMaker, celui-ci va directement ajouter les packages de base qui lui sembleront nécessaires.\\ Les packages s'appellent en faisant la commande suivante: \texttt{\textbackslash usepackage \{nom du package\}}. Vous pourrez donc les ajouter les uns à la suite des autres dans le préambule du document. Ces extensions entrent en jeu dans presque tous les paramètres de votre document. Par exemple, elles peuvent concerner: \begin{itemize} \item La mise en page (marges, entêtes, pieds de page) avec \texttt {\textbackslash usepackage\{geometry\} et \{fancyhdr\}} \item L'encodage des polices (pour les caractères spéciaux, les accents, etc.) : \begin{itemize} \item Pour l'encodage à l'entrée (écrire avec des accents dans le code source): \\ \texttt {\textbackslash usepackage[utf8]\{inputenc\}} \item Pour l'affichage des caractères à la sortie: \texttt {\textbackslash usepackage[T1]\{fontenc\}} \end{itemize} \item Coloriser la police de texte, les cellules de tableaux, etc.: \texttt {\textbackslash usepackage\{xcolor\}} \item Utilisation des règles typographiques liées à une langue. Par exemple, ajouter un espace après : , titres des chapitres et des sections etc.: \texttt {\textbackslash usepackage[french]\{babel\}} \item Inclusion et mise en page des images: \texttt {\textbackslash usepackage\{graphicx\} et \{wrapfig\}} \item Pratiques des Mathématiques: \texttt {\textbackslash usepackage\{amsmath\}, \{amssymb\}, \{amsfonts\} et \{mathtools\}} \item Gestion des liens urls: \texttt {\textbackslash usepackage\{hyperref\}} \item Gestion avancée des citations: \texttt {\textbackslash usepackage\{csquotes\}} \item Citations et bibliographie à partir d'un fichier de références bibliographiques .bib: \texttt {\textbackslash usepackage[backend=biber]\{biblatex\}} ou \texttt {\textbackslash usepackage[backend=bibtex]\{natbib\}} \item ETC. \end{itemize} \section{Notions de base} Les exemples de commandes qui suivent se trouvent dans le corps du document, c'est-à-dire qu'elles s'appellent après la commande \texttt {\textbackslash begin\{document\}}. Toutes les commandes s'appellent de cette manière: \texttt {\textbackslash [options] \{nom de la commande\}}. Exemples: \texttt {\textbackslash includegraphics[width=1\textbackslash width]\{image.png\}} pour ajouter une image faisant la largeur du texte, ou \texttt {\textbackslash textit\{texte en italique\}} pour écrire une phrase en italique. Il est possible d'annoter/commenter son code LaTeX en mettant au préalable un \$ suivi du commentaire. \section{Structure du corps du document (Chapitrage, etc.)} Selon la classe de document que vous aurez sélectionnée dans le préambule, vous aurez accès à diverses commandes afin de structurer le corps de votre document. Cette hiérarchisation est pratique pour vous, afin de vous retrouvez aisément dans votre document mais elle est également utile pour l'éditeur LaTeX, car elle permettra de mettre en page automatiquement le texte selon cette hiérarchie, numéroter chaque partie et créera également automatiquement une table des matières. Ce système a d'ailleurs été repris dans WORD avec les "styles" \parencite{maguisRedigezDocumentsQualite2010}. La hiérarchie et les commandes des différentes parties se définit comme ceci:\\ Partie \texttt {\textbackslash part\{nom de la partie\}} \setlength{\parindent}{1cm}Chapitre \texttt {\textbackslash chapter\{nom du chapitre\}} \setlength{\parindent}{1.5cm}Section \texttt {\textbackslash section\{nom de la section\}} \setlength{\parindent}{2cm}Sous-section \texttt {\textbackslash subsection\{nom de la sous-section\}} \setlength{\parindent}{2.5cm}Sous-sous-section \texttt {\textbackslash subsubsection\{nom de la sous-sous-section\}} \setlength{\parindent}{3cm}Paragraphe \texttt {\textbackslash paragraph\{nom du paragraphe\}} \setlength{\parindent}{3.5cm}Sous-paragraphe \texttt {\textbackslash subparagraph\{nom du sous-paragraphe\}}\\ \setlength{\parindent}{1cm} Notez que le niveau \texttt {\textbackslash chapter} n'est pas disponible pour les classes de document \texttt {article et letter}. \begin{wrapfigure}{R}{0.6\textwidth} \includegraphics[width=0.6\textwidth]{Images/structure+parties.png} \end{wrapfigure} Dans TeXmaker, vous n'avez pas forcément besoin de créer ces commandes à la main. Il vous suffit de cliquer sur le bouton "+" dans la barre de gauche et de choisir le niveau hiérarchique souhaité. Nous vous conseillons également de naviguer dans votre document LaTeX via la structure hiérarchique de l'éditeur afin de vous y retrouver plus facilement. Il est également possible de préciser à divers endroits du corps de document, les parties générales dans lesquelles nous nous trouvons, qui peuvent exiger une mise en page ou une numérotation particulière. Par exemple, \texttt {\textbackslash frontmatter} pour un avant-propos, \texttt {\textbackslash mainmatter} pour la partie principale du document, \texttt {\textbackslash appendix} pour les annexes, \texttt {\textbackslash backmatter} notamment pour la bibligoraphie. Enfin, sachez que vous pouvez créer un nouveau chapitre/section, etc. sans numéro. Pour cela, il suffit d'ajouter une * après la précision du type de partie. EX: \texttt {\textbackslash section* \{nom de la section\}} \section{Mise en page} TeXmaker n'étant pas un éditeur WYSIWYG, vos personnalisations dans votre texte brut doivent être faites sous forme de commandes pour qu'elles soient appliquées. \\ \paragraph*{Sauts de ligne, de paragraphe et de page} Par exemple, taper sur la touche \textit{enter} de votre clavier aura certes comme effet de faire un retour à la ligne dans votre éditeur de texte mais cela n'aura aucune incidence sur la mise en page du texte après compilation. \begin{wrapfigure}{R}{0.35\textwidth} \includegraphics[width=0.35\textwidth]{Images/ex_paragraphe_saut_ligne.png} \end{wrapfigure} Autrement dit, il est nécessaire de préciser une commande \textit{retour à la ligne} pour que celui-ci soit fait dans la mise en page du document final. Ainsi, un retour à la ligne se fait en ajoutant \texttt {\textbackslash}\texttt {\textbackslash} au bout de votre ligne.\\ Un changement de paragraphe se fait de manière plus simple en ajoutant une ligne vierge entre deux phrase dans votre éditeur ou en ajoutant la commande \texttt {\textbackslash par} à la fin de votre paragraphe.\\ Le saut de page, lui, se fait en utilisant la commande \texttt {\textbackslash newpage}. \paragraph*{Alignement du texte} LaTeX justifie par défaut les paragraphes. Ce sera donc à vous de préciser si vous préférez avec le texte aligné à gauche, droite ou encore centré. Pour cela, vous pouvez entrer les commandes\\ \texttt {\textbackslash begin\{commande\}}\\ \texttt {\textbackslash end\{commande\}}\\ Où vous préciserez \texttt \{flushleft\} pour aligner le texte à gauche, \texttt \{flushright\} à droite et \texttt \{center\} pour centrer le texte.\\ Notez enfin que vous avez dans la barre de commandes de TeXmaker les boutons vous permettant d'appeler facilement ces commandes \paragraph*{Marges} Les marges sont gérées par défaut par LaTe \textbf{selon le type de classe de document que vous avez choisi.} Vous pouvez néanmoins les personnaliser à votre aise, en appelant l'extension \texttt {geomtry} dans laquelle vous précisez vos préférences.\\ Exemple: \texttt {\textbackslash usepackage[left=2cm, right=2cm, top=1.5cm, bottom=1cm]\{geometry\}} \paragraph*{Interlignes} Le package \texttt {setspace} à appeler conjuguer aux commandes \texttt {\textbackslash begin\{onehalfspace\}} ou \texttt {\textbackslash begin\{doublespace\}} suivi de la commande \texttt {\textbackslash end\{doublespace\}} permet de préciser des parties du texte où l'interligne sera réduit de moitié ou, au contraire, doublé. \paragraph*{Notes de bas de page, en-têtes et pieds de page} l'insértion d'une note de bas de page se fait via la commande \texttt {\textbackslash footnote\{texte apparaissant en note de bas de page\}} qui s'insérera au milieu de votre texte. Par défaut, l'appel de note de bas de page est un numéro en expostant. Mais sachez que vous pouvez également le personnaliser (astérisk, chiffre romain, etc.).\\ Pour personnaliser les en-têtes et pieds de page, utilisez le package \texttt {\textbackslash usepackage \{fancyhdr\}}. Par la suite vous appellez la commande \texttt {\textbackslash pagestyle\{fancy\}} pour que ce soit celui-ci qui soit pris en compte et non pas celui par défaut. Puis, précisez la commande \texttt {\textbackslash fancyhf\{\}} pour initialiser les contenus. Enfin, vous précisez vos préférences concernant respectivement l'en-tête \texttt {\textbackslash fancyhead[position]\{texte à apparaître dans l'en-tête\}} et le pied de page \texttt {\textbackslash fancyfoot[position]\{texte à apparaître dans le pied de page\}} où l'on utilise les termes \textit{L}, \textit{C} ou \textit{R} pour préciser la position du texte. Pour résumer, voilà ce que cela donne:\\ \texttt {\textbackslash usepackage \{fancyhdr\}}\\ \texttt {\textbackslash pagestyle\{fancy\}}\\ \\ \texttt {\textbackslash begin\{document\}}\\ \\ \texttt {\textbackslash fancyhf\{\}}\\ \texttt {\textbackslash fancyhead[C]\{Mon rapport sur LaTeX\}}\\ \texttt {\textbackslash fancyfoot[R]\{\textbackslash thepage\}} \paragraph*{Colonnes} Si vous désirez écrire sur plusieurs colonnes, appelez l'extension \texttt {\textbackslash usepackage\{multicol\}} puis vous créez un environnement avec le nombre de colonne désiré avec la commande \texttt {\textbackslash begin\{multicols\} \{nombre de colonnes\}} puis \texttt {\textbackslash end\{multicols\}}. Exemple:\\ \texttt {\textbackslash usepackage \{fancyhdr\}}\\ \\ \texttt {\textbackslash begin\{document\}}\\ Texte sur une ligne entière\\ \\ \texttt {\textbackslash begin\{multicols\}\{2\}}\\ Texte qui apparaitra sur deux colonnes\\ \texttt {\textbackslash end\{multicols\}}\\ Texte appraissant sur une ligne entière \paragraph*{Les citations} L'extension \texttt {\textbackslash usepackage[babel=true]\{csquotes\}} permet d'adapter vos types de guillemets aux règles de la langue utilisée (extension babel). Pour créer une citation, utlisez la commande \texttt {\textbackslash enquote\{texte de la citation\}}. \section{Mise en forme du texte} \paragraph*{Taille du texte} La taille par défaut du texte est définie dès la commande \texttt {\textbackslash documentclass [12pt]\{classe\}} à la première ligne de votre document LaTeX. A partir de là, vous pouvez accentuer ou diminuer une partie du texte via la commande \texttt {\textbackslash commande\_taille\{texte dont la taille est modifiée\}} où vous précisez la commande telle que \texttt {\textbackslash small} pour petit, \texttt {\textbackslash Large} pour grand, \texttt {\textbackslash huge} pour très grand, etc. (Voir document de commandes pour plus de détails). \paragraph*{Police de caractère} LaTeX fonctionne également avec des packs de polices: \texttt {\textbackslash usepackage\{nom\_du\_pack\}}. Par exemple, vous pourrez appelez le pack de police \texttt {lmodern} (la police classique de LaTeX) mais également \texttt {newcent}, \texttt {charter}, etc. A vous de vous renseigner sur la police qui vous sied le mieux!\\ \paragraph*{Gras, italique, etc.} Voici quelques exemples de préférences de style:\\ \texttt {\textbackslash textbf \{texte\_à\_modifier\}} = texte en \textbf{gras}\\ \texttt {\textbackslash textit \{\}} = texte en \textit{italique}\\ \texttt {\textbackslash texttt \{\}} = texte \texttt {style machine à écrire}\\ \texttt {\textbackslash emph \{\}} = texte avec \emph{emphase}\\ Etc. \paragraph*{Liste} Une liste basique se fait en créant un environnement sous cette forme: Ouverture d'un environnement \texttt{itemize}, lister les éléments avec la commande \texttt{\textbackslash item}, puis fermeture de l'environnement \texttt{itemize}\\ \texttt {\textbackslash begin\{itemize\}}\\ \texttt {\textbackslash item Pomme}\\ \texttt {\textbackslash item Poire}\\ \texttt {\textbackslash Etc}.\\ \texttt {\textbackslash end\{itemize\}}\\ \\ Sachez que vous pouvez imbriquer les environnements \texttt{itemize} avec de créer des listes à plusieurs niveaux. Exemple:\\ \texttt {\textbackslash begin\{itemize\}}\\ \texttt {\textbackslash item Fruits}\\ \texttt {\textbackslash begin\{itemize\}}\\ \texttt {\textbackslash item Pomme}\\ \texttt {\textbackslash item Poire}\\ \texttt {\textbackslash end\{itemize\}}\\ \texttt {\textbackslash item Légumes}\\ \texttt {\textbackslash begin\{itemize\}}\\ \texttt {\textbackslash item Carotte}\\ \texttt {\textbackslash item Courgette}\\ \texttt {\textbackslash end\{itemize\}}\\ \texttt {\textbackslash end\{itemize\}}\\ \\ Notez enfin que par défaut, le type de marqueur pour la liste est déterminé par la langue choisie dans le package Babel. Vous pouvez néanmoins les modifier individuellement pour chaque liste.\\ Il existe également la possibilité de faire des liste numérotées. Celles-ci fonctionne de manière identique, mais avec un environnement \texttt{enumerate}. \paragraph*{Couleurs} Par défaut, les documents produits par LaTeX sont en noir et blanc. Vous pouvez gérer l'ajout et la personnalisation de couleurs en appelant soit l'extension \texttt{\textbackslash usepackage\{color\}}, soit l'extension \texttt{\textbackslash usepackage [option]\{xcolor\}}, où dans le dernier cas, vous devez sélectionner une option (par exemple \texttt dvipsnames). La première extension est plus limitée en nombre de couleurs disponibles mais est un peu plus facile à utiliser que le second. A partir de là, vous pouvez utiliser des commandes pour \textcolor {cyan}{coloriser le texte en lui-même} ou \colorbox {cyan}{coloriser le fond, créant un effet de surlignage}.\\ \\ La commande pour coloriser le texte est \texttt{\textbackslash textcolor \{couleur\}\{Texte colorisé\}}.\\ La commande pour coloriser le fond est \texttt{\textbackslash colorbox \{couleur\}\{Fond colorisé\}}.\\ \\ Vous pouvez bien sûr imbriquer ces deux commandes pour avoir un texte d'une certaine couleur dans un fond d'une autre couleur.\\ Notez enfin que si vous ne trouvez pas votre bonheur dans les couleurs à disposition, vous pouvez en définir à la main en amont avec la commande \texttt{\textbackslash definecolor \{nom de la nouvelle couleur\}\{code de couleur\}\{composition numérique\}}. Exemple: \texttt{\textbackslash definecolor \{rose\}\{rgb\}\{1, 0.4, 0.6\}} \paragraph*{Hyperliens} Pour que votre document LaTeX gère les hyperliens qui seront cliquables, il vous faut appeler le package \texttt{\textbackslash usepackage\{hyperref\}}. Notez que ces liens peuvent être externes, notamment vers des pages web, mais peuvent être également internes, renvoyant à d'autres parties du document en question. Une fois ce package chargé, toutes les références appelées notamment avec les commandes \texttt{\textbackslash label} et \texttt{\textbackslash ref}, les éléments de la table des matières, et les notes de bas de page deviendront cliquables \parencite{tailletBienDebuterLaTeX2022}.\\ Vous pouvez alors utiliser la commande \texttt{\textbackslash url\{lien url\}} pour afficher un lien cliquable,(exemple: \textcolor{blue}{\url{https://www.wikipedia.org/}}, ou la commande \texttt{\textbackslash href\{lien url\}\{texte à afficher à la place du lien\}} pour pointer vers une page web via un mot/texte. \textcolor{blue}{\href{https://www.quaternum.net/2020/04/29/fabriques-de-publication-latex/}{EXEMPLE}}.\\ Notez également que, bien que ces liens soient cliquables, ils ne se démarquent pas du texte classique visuellement. Si vous désirez que le lien soit souligné et/ou qu'il s'affiche en bleu par exemple, il vous faudra inclure votre commande de lien dans une commande de forme correspondante. \section{Images} Pour ajouter des images dans votre document, appelez dans un premier temps le package \texttt{graphicx}. Celui-ci permet de gérer les images au format pdf, jpeg et png.\\ Dans un second temps, vous pourrez appeler la commande \texttt{\textbackslash includegraphics [option]\{adresse + nom\_du\_fichier sur votre ordinateur\}} où les options concernent notamment l'emplacement de l'image sur la page, sa largeur (\texttt{width=...}) en cm ou vis-à-vis de la page, sa hauteur (\texttt{height=...}), sa mise à l'échelle (\texttt{scale=...})ou son angle de rotation (\texttt{angle=...}). Par exemple: \texttt{\textbackslash includegraphics [height=2cm, angle=20]\{mon\_image\}}\\ Ou \texttt{\textbackslash includegraphics [width=0.5\textbackslash textwidth]\{mon\_image\}} \subsection{Les éléments flottants} Pour personnaliser davantage la mise en page de vos images, notamment leur positionnement sur la page, l'enrobage ou l'ajout d'une légende, il faut enrober votre commande \texttt{\textbackslash includegraphics} dans un environnement \texttt{\textbackslash begin \{figure\}[paramètre de placement]}\\ \\ \texttt{\textbackslash end \{figure\}} où vous préciserez une des options suivantes: \begin{itemize} \item \textbf{h} = place l'élément flottant (l'image) à l'endroit où il apparaît dans le code de l'éditeur) \item \textbf{p} = place l'élément flottant sur une page particulière réservée aux flottants \item \textbf{t} = place l'élément flottant en haut de la page \item \textbf{b} = place l'élément flottant en bas de la page \end{itemize} En plaçant le caractère \textbf{!} avant le paramètre souhaité, vous forcez LaTeX à disposer l'image comme vous le désirez même si cela va à l'encontre de ses paramètres par défaut. \subsubsection*{Exemple} \texttt{\textbackslash begin \{figure\}[t]}\\ \texttt{\textbackslash includegraphics [scale=0.5]\{image.png\}}\\ \texttt{\textbackslash end \{figure\}} \subsubsection*{Légendes} Pour ajouter une légende à votre image, en précisant la commande \texttt{\textbackslash caption\{Texte\}} dans l'environnement. Selon où vous placez la commande par rapport à la commande \texttt{includegraphics}, votre légende apparaîtra au-dessus ou en dessous de votre image. \subsection{L'enveloppement des éléments flottants} Vous pouvez envelopper votre image flottante de texte pour que celle-ci soit "inclue" dans un paragraphe de texte, via l'environnement \texttt{wrapfig}.\\ \texttt{\textbackslash begin \{wrapfigure\}\{alignement\}\{largeur\}}\\ \\ \texttt{\textbackslash end \{wrapfigure\}}\\ Où l'argument \texttt{alignement} va définir si la figure sera collée à gauche (\texttt{L}) ou à droite (\texttt{R}) du texte. \subsubsection*{Exemple} \texttt{\textbackslash begin\{wrapfigure\}\{R\}\{0.5\textbackslash textwidth\}}\\ \texttt{\textbackslash includegraphics [width=0.5\textbackslash textwidth]\{image.png\}}\\ \texttt{\textbackslash caption \{Légende de mon image\}}\\ \texttt{\textbackslash end \{wrapfigure\}}\\ \section{Tableaux} La création de tableaux dans LaTeX comprend deux étapes. L'élaboration du tableau en lui-même d'une part, puis son placement en tant qu'élément flottant d'autre part. Les tableaux sont en réalité des structures où l'information est défini en lignes et colonnes. Il \\ \subsection*{Tableau sans bordure} Un tableau simple sans bordure se fait via l'environnement \texttt{tabular}. Dans cet environnement, il faut dans un premier temps définir comment sont justifié des éléments dans les cellules pour chaque colonne. Ainsi, nous spécifierons \texttt{r} pour un alignement à droite, \texttt{l} à gauche et \texttt{c} pour un alignement centré, et ce pour chaque colonne. Ensuite, il suffit de rentrer de ligne en ligne le contenu de chaque cellule, séparées par le caractère "\&" afin de changer de colonne. Chaque ligne se terminera par \texttt{\textbackslash \textbackslash}. Exemple:\\ \texttt{\textbackslash begin\{tabular\}\{ccc\}}\\ \texttt{1 \& 2 \& 3}\texttt{\textbackslash \textbackslash} \\ \texttt{4 \& 5 \& 6}\texttt{\textbackslash \textbackslash} \\ \texttt{\textbackslash end\{tabular\}}\\ Ce qui donne comme tableau: \begin{tabular}{ccc} 1 & 2 & 3 \\ 4 & 5 & 6 \\ \end{tabular} \subsection*{Tableau avec bordures} Le tableau avec bordures pour colonnes et/ou ligne fonctionne avec le même principe mais nous devons définir quelle(s) colonne(s) et quelle(s) ligne(s) doivent avoir des bordures. \subsubsection*{Colonnes} Préciser une bordure de colonne se fait dans la commande de l'environnement, dans la partie \texttt{\{ccc\}}. Dans celle-ci, il faudra ajouter un "|" entre chaque précision de justification. Ainsi, \texttt{\{ccc\}} deviendra \texttt{\{|c|c|c|\}}. Nous pouvons préciser des largeur de colonnes en ajoutant une indication pour chacune dans la commande ci-dessus. Exemple: \texttt{\{|c\{2cm\}|c\{1cm\}|c\{3cm\}|\}} \subsubsection*{Lignes} Contrairement aux colonnes, l'indication des bordures de lignes ne se fait pas dans la commande d'environnement mais directement entre les lignes de texte du tableau, avec la commande \texttt{\textbackslash hline}. Il suffit alors de l'insérer dans chaque ligne où nous désirons une bordure.\\ Exemple pour colonnes et lignes:\\ \texttt{\textbackslash begin\{tabular\}\{|c|c|c|\}}\\ \texttt{\textbackslash hline}\\ \texttt{1 \& 2 \& 3}\texttt{\textbackslash \textbackslash} \texttt{[1cm]}\\ \texttt{\textbackslash hline}\\ \texttt{4 \& 5 \& 6}\texttt{\textbackslash \textbackslash} \\ \texttt{\textbackslash hline}\\ \texttt{\textbackslash end\{tabular\}}\\ Ce qui donne comme résultat: \begin{tabular}{|c|c|c|} \hline 1 & 2 & 3 \\[1cm] \hline 4 & 5 & 6 \\ \hline \end{tabular}\\ Notez également, dans l'exemple ci-dessus, comme il est possible de préciser la hauteur d'une ligne en ajoutant une taille après les \texttt{\textbackslash \textbackslash} de la ligne en question. \subsection*{Environnement flottant} Créer un tableau flottant, c'est-à-dire un tableau qu'il est possible de déplacer dans le document à sa guise, se fait en insérant l'environnement \texttt{tabular} dans un environnement qui est, lui, flottant, et dont le nom est \texttt{table}. Le fonctionnement de ce dernier est similaire à celui de \texttt{figure} vu précédemment pour les images. Il faut donc préciser dans cet environnement-ci sa position sur la page avec les options \texttt{center, left ou right} avant de créer le tableau lui-même ainsi que la commande \texttt{caption} pour ajouter une légende. Exemple:\\ \texttt{\textbackslash begin\{table\}}\\ \texttt{\textbackslash begin\{center\}}\\ \texttt{\textbackslash begin\{tabular\}\{|c|c|c|\}}\\ \texttt{\textbackslash hline}\\ \texttt{1 \& 2 \& 3}\texttt{\textbackslash \textbackslash}\texttt{[1cm]}\\\texttt{\textbackslash hline}\\ \texttt{4 \& 5 \& 6}\texttt{\textbackslash \textbackslash} \\ \texttt{\textbackslash hline}\\ \texttt{\textbackslash end\{tabular\}}\\ \texttt{\textbackslash caption\{Ce beau tableau flottant m'apprend à compter\}}\\ \texttt{\textbackslash end\{table\}}\\ \\ Ce qui va donner: \begin{table}[h] \begin{center} \begin{tabular}{|c|c|c|} \hline 1 & 2 & 3 \\[1cm] \hline 4 & 5 & 6 \\ \hline \end{tabular} \end{center} \caption{Ce beau tableau flottant m'apprend à compter} \end{table} \subsection*{Autres paramétrages de tableau} \subsubsection*{Fusion de colonnes ou de lignes} \paragraph*{Colonne} la commande de fusion de colonne est la suivante:\\ \texttt{\textbackslash multicolumn\{nombre de colonnes fusionnées\}\{|alignement|\}\{texte de la cellule\}}. Celle commande \textbf{doit être précisée pour chaque ligne du tableau}lorsque lont précise le contenu de chaque cellule de la ligne (donc dans la partie où nous trouvons en théorie \texttt{1 \& 2 \& 3 \textbackslash \textbackslash}. Exemple:\\ \texttt{\textbackslash begin\{tabular\}\{|c|c|c|\}}\\ \texttt{\textbackslash hline}\\ \texttt{1 \& \textbackslash multicolumn\{2\}\{c|\}\{2\}}\texttt{\textbackslash \textbackslash}\\ \texttt{\textbackslash hline}\\ \texttt{3 \& 4 \& 5}\texttt{\textbackslash \textbackslash} \\ \texttt{\textbackslash hline}\\ \texttt{\textbackslash end\{tabular\}}\\ \\ Ce qui donne: \begin{tabular}{|c|c|c|} \hline 1 & \multicolumn{2}{c|}{2} \\ \hline 3 & 4 & 5 \\ \hline \end{tabular}\\ \paragraph*{Ligne} La fusion des lignes se fait via la command \texttt{multirow} contenue dans le package du même nom. En théorie, cela donne ça: \texttt{\textbackslash multirow\{nombre de lignes fusionnées\}\{largeur de la colonne comprenant les lignes fusionnées\}\{texte *potentiel" de la cellule fusionnée\}}.\\ La commande se place dans la cellule de la première ligne à fusionner. les lignes suivantes, selon le nombre de lignes fusionnées précisé, resteront vides dans le script\parencite{gautreletIntroductionLaTeX2020}. Exemple: \texttt{\textbackslash usepackage\{multirow\}}\\ \texttt{...}\\ \texttt{\textbackslash begin\{tabular\}\{|c|c|c|\}}\\ \texttt{\textbackslash hline}\\ \texttt{\textbackslash multirow\{2\}\{*\}\{1\} \& 2 \& 3}\texttt{\textbackslash \textbackslash}\\ \texttt{\& 4 \& 5}\texttt{\textbackslash \textbackslash} \\ \texttt{\textbackslash hline}\\ \texttt{6 \& 7 \& 8}\texttt{\textbackslash \textbackslash} \\ \texttt{\textbackslash hline}\\ \texttt{\textbackslash end\{tabular\}}\\ \\ Donnant le résultat: \begin{tabular}{|c|c|c|} \hline \multirow{2}{*}{1} & 2 & 3\\ & 4 & 5 \\ \hline 6 & 7 & 8 \\ \hline \end{tabular}\\ \\ Où les deux premières lignes sont fusionnées. Vous remarquez que dans la première cellule, le chiffre 1 prend la place de toute la cellule fusionnée. Cela est le cas parce que nous l'avons mis entre \{\} dans la commande de la fusion, alors que les chiffres 2, 3, 4 et 5 sont indiqués de manière normales dans la ligne. Pour autant ces dernières cellules sont également fusionnées, mais le texte, lui, est distinct. \subsubsection*{Coloriser le tableau} La colorisation de cellules, lignes ou colonnes peut être utile pour mettre en évidence un élément en particulier ou des entêtes au tableau. On commence par appeler l'extension \texttt{colortbl}\\ \paragraph*{Cellule} Pour modifier la couleur de fond d'une cellule, il faut utiliser la commande \texttt{\textbackslash cellcolor \{couleur\}} qui sera placée juste avant le texte, dans la cellule du tableau.\\ Pour changer la couleur de police d'une cellule, le principe est le même en faisant cette fois-ci la commande \texttt{\textbackslash color \{couleur\}}. Voici un exemple des deux commandes conjuguées:\\ \texttt{\textbackslash usepackage \{colortbl\}}\\ \texttt{...}\\ \texttt{\textbackslash begin\{tabular\}\{|c|c|c|\}}\\ \texttt{\textbackslash hline}\\ \texttt{1 \& \textbackslash cellcolor\{yellow\}2 \& 3}\texttt{\textbackslash \textbackslash}\\ \texttt{\textbackslash hline}\\ \texttt{4 \& \textbackslash color \{red\}5 \& 6}\texttt{\textbackslash \textbackslash} \\ \texttt{\textbackslash hline}\\ \texttt{\textbackslash end\{tabular\}}\\ \\ Donnant le résultat: \begin{tabular}{|c|c|c|} \hline 1 & \cellcolor{yellow}2 & 3\\ \hline 4 & \color{red}5 & 6 \\ \hline \end{tabular}\\ \paragraph*{Ligne} Pour changer la couleur de fond de toute une ligne, il faut utiliser la commande suivante en début de ligne: \texttt{\textbackslash rowcolor\{couleur\}}. Exemple:\\ \texttt{\textbackslash \{blue\} 1 \& 2 \& 3 \textbackslash \textbackslash} \paragraph*{Colonne} Le changement de couleur de fond d'une colonne se fait dans les options du tableau, juste avant l'argument correspondant à la colonne:\\ \texttt{>\{\textbackslash columncolor\{couleur\}\}}\\ Et pour changer la couleur de la police:\\ \texttt{>\{\textbackslash color\{couleur\}\}}\\ \\ Exemple:\\ \texttt{\textbackslash begin\{tabular\}\{|>\{\textbackslash columncolor\{magenta\}\}c|c|>\{\textbackslash color\{cyan\}\}c|\}}\\ \texttt{\textbackslash hline}\\ \texttt{1 \& 2 \& 3}\texttt{\textbackslash \textbackslash}\\ \texttt{\textbackslash hline}\\ \texttt{4 \& 5 \& 6}\texttt{\textbackslash \textbackslash} \\ \texttt{\textbackslash hline}\\ \texttt{\textbackslash end\{tabular\}}\\ \\ Donnant comment résultat: \begin{tabular}{|>{\columncolor{magenta}}c|c|>{\color{cyan}}c|} \hline 1 & 2 & 3 \\ \hline 4 & 5 & 6 \\ \hline \end{tabular}\\ \section{Équations Mathématiques} L'écriture des mathématiques se fait également via des environnements. Nous allons indiquer une zone dans laquelle le compilateur lira une formule mathématique à la place de texte normal. Sachez qu'il vous est possible de suivre les commandes proposées dans les sections suivantes afin de créer à la main ces équations. \textbf{Mais certaines options dans TeXmaker ainsi que des outils en ligne ou à installer vous permettent de créer des commandes d'équations LaTeX complexes à partir de formules mathématiques que vous créez en WYSIWYG}. Nous vous conseillons de les utiliser afin de vous faciliter le travail. Voir plus bas pour certains de ces outils. \paragraph*{Intégration d'une formule dans une phrase} Si l'on veut intégrer une formule au milieu de texte, il suffit d'utiliser \$...\$. Exemple: Ceci est une équation $(a+b)^2=a^2+2 a b+b^2$ au milieu d'une phrase. \paragraph*{Mettre en évidence une formule} Pour mettre en évidence une équation, il faut l'écrire entre \textbackslash [ ... \textbackslash ] ou \$\$ ... \$\$. Cette commande fera aller à la ligne et centrera la formule: \[(a+b)^2=a^2+2 a b+b^2\] \paragraph*{Equations numérotées} L'environnement \texttt{\textbackslash begin \{equation\} ... \textbackslash end \{equation\}}. Cela permet de numéroter les équations, dans le but d'y faire référence plus tard dans votre document. Exemple: \begin{equation} f(x)=a(c)^x \end{equation} \paragraph*{Ajouter du texte dans une équation} Pour ajouter une info texte au milieu d'une équation mathématique, insérer la commande \texttt{\textbackslash text \{ \}} à l'intérieur de votre commande de formule. \subsubsection{Commandes de base des fonctions mathématiques} En premier lieu, il est nécessaire d'appeler les packages \texttt{amsmath} et \texttt{amssym}. Un autre package nommé \texttt{mathtools} permet d'étendre encore davantage les options. Nous vous conseillon donc d'appeler pour tous vos documents ces trois extensions afin d'avoir des options exhaustives.\\. D'une manière générale, les commandes se feront sous la forme suivante où l'on précise un exposant et un indice: $$\textbf{\texttt{\textbackslash commande\_\{en-dessous\}\textasciicircum\{au dessus\}}}$$ \paragraph*{Exposant et indice} L'exposant s'exprime via l'accent circonflexe \textasciicircum . L'indice, lui, s'écrit via l'underscore \_: \texttt{(U\_n) = 4\textasciicircum n + 3.14\textasciicircum \{n+1\}} donnant comme équation $U_n = 4^n + 3.14^{n+1}$\\ \paragraph*{Fraction} Une fraction se fait avec la commande \texttt{\textbackslash frac \{numérateur\}\{dénominateur\}}. Ex: \texttt{\textbackslash frac \{2\}\{5\}} donnant $\frac{2}{5}$ \paragraph*{Fractions en cascade} Avec le package amsmath, vous pouvez créez des fractions imbriquées en utilisant la commande \texttt{\textbackslash cfrac}. Exemple. \texttt{\textbackslash frac\{2\}\{5 + \textbackslash cfrac\{6\}\{3\}\}\textbackslash }, donnant $\cfrac{2}{5 + \cfrac{6}{3}}$ \paragraph*{Racine} \texttt{\textbackslash sqrt[3]\{4\}} $\rightarrow$ $\sqrt[3]{4}$ \paragraph*{Limite} \texttt{\textbackslash lim\_\{1 \textbackslash to n\} x+42} $\rightarrow$ $\lim_{1 \to n} x+42$ \paragraph*{Sommes} \texttt{\textbackslash sum\_\{k=0\}\textasciicircum\{p\}U\_k} $\rightarrow$ $\sum_{k=0}^{p} U_k$ \paragraph*{Intégrales} \texttt{\textbackslash int\_0\textasciicircum\{\textbackslash infty\}f(x)dx} $\rightarrow$ $\int_0^{\infty}f(x)dx$.\\ Notez qu'il est possible d'imbriquer les commandes d'intégrales afin de créer des intégrales doubles ou triples. \paragraph*{Produit} \texttt{\textbackslash prod\_\{k=2\}\textasciicircum\{47\}k+1} $\rightarrow$ $\prod_{k=2}^{47}k+1$ \paragraph*{Accolades (ensembles)} Créer un environnement \texttt{\textbackslash cases}, p. ex: \\ \$ \\ \texttt{\textbackslash begin\{cases\}}\\ \texttt{f(x) = 3x+2}\textbackslash \textbackslash \\ \texttt{f(x) = 4x\textasciicircum4 + 12x\textasciicircum3 - 2x\textasciicircum2 + x-5}\\ \texttt{\textbackslash end\{cases\}}\\ \$ \\ Donnant le résultat: $ \begin{cases} f(x) = 3x+2\\ g(x) = 4x^4 + 12x^3 - 2x^2 + x-5 \end{cases} $ \subsubsection{Fonctions} Les fonctions telles que cos, sin, tan, etc. se font via une commande simple propre à chacune. Exemple: \texttt{\textbackslash arctan\textasciicircum\{42\}(x)} $\rightarrow$ $\arctan^{42}(x)$\\ Voir les feuilles annexes pour toutes les fonctions usuelles. \subsubsection{Matrices} Une matrice se créé via un environnement classique selon une commande propre à chaque forme de matrice (parenthèses, crochets, etc.) et se remplit comme un tableau en utilisant des "\& " pour séparer les éléments des différentes colonnes. Exemple:\\ \$\\ \texttt{\textbackslash begin\{pmatrix\}}\\ \texttt{1 \& 2 \& 3} \textbackslash \textbackslash \\ \texttt{4 \& 5 \& 6} \textbackslash \textbackslash \\ \texttt{7 \& 8 \& 9} \textbackslash \textbackslash \\ \texttt{\textbackslash end\{pmatrix\}}\\ \$\\ Donnant $\begin{pmatrix} 1 & 2 & 3\\ 4 & 5 & 6\\ 7 & 8 & 9 \\ \end{pmatrix}$ \\ \texttt{\textbackslash begin\{vmatrix\}} $\rightarrow$ $ \begin{vmatrix} 1 & 2 & 3\\ 4 & 5 & 6\\ \end{vmatrix} $ \\ \texttt{\textbackslash begin \{Vmatrix\}} $\rightarrow$ $ \begin{Vmatrix} 1 & 2 & 3\\ 4 & 5 & 6\\ \end{Vmatrix} $ \\ \texttt{\textbackslash begin\{bmatrix\}} $\rightarrow$ $ \begin{bmatrix} 1 & 2 & 3\\ 4 & 5 & 6\\ \end{bmatrix} $ \\ \texttt{\textbackslash begin\{Bmatrix\}} $\rightarrow$ $ \begin{Bmatrix} 1 & 2 & 3\\ 4 & 5 & 6\\ \end{Bmatrix} $ \subsubsection{Vecteurs et barres} Pour une flèche apparaissant au dessus d'une seule lettre (ex. $ \vec{v} $), il est possible d'utiliser la commande \texttt{\$ \textbackslash vec\{lettre\} \$}, mais si la chaîne de caractères sous la flèche est plus longue, il vous faudra utiliser la commande \texttt{\textbackslash overrightarrow\{mot\}} (ex. $ \overrightarrow{AB} $).\\ On retrouve un binôme de commandes analogue pour placer une barre au-dessus des lettres, avec respectivement les commandes \texttt{\$ \textbackslash bar\{lettre\} \$} (ex. $ \bar{x} $) et \texttt{\textbackslash overline\{mot\}} (ex. $ \overline{AB} $). \subsection{Lettres grecques et autres symboles} Globalement, les lettres grecques (ex. $\alpha$, $\lambda$, $\Omega$...)sont représentées par des commandes portant le nom de la lettre (ex. \texttt{\$ \textbackslash alpha \$, \$ \textbackslash lambda \$...}. Pour avoir la afficher la lettre en majuscule, il faut mettre l'initiale en majuscule (ex. \texttt{\$ \textbackslash Omega \$ }.Pour avoir une liste complète, voir feuille de commandes.\\ Le principe est le même pour les autres symboles mathématiques tels que $\neq$, $\approx$, $\infty$, etc. Chacun a sa commande propre. \subsection{Affichage et alignement des équations} Nous avons vu précédement qu'il était possible soit d'inclure une équation dans une ligne classique, au milieu du texte, ou de la mettre en évidence sur une ligne à part entière. Ces options fonctionnement correctement telles quelles mais peuvent avoir quelques désagréments. Il existe donc des options \textit{displaystyle} des commandes mathématiques pour améliorer cela. Premièrement, lorsqu'une équation est comprise dans une ligne de texte, celle-ci a par défaut la hauteur définie dans l'interligne et pas plus. Ce qui fait que selon le type de formule mathématique, par exemple une fraction ou une fraction en cascade, l'affichage de l'équation sera très (trop?) compact, et donc difficile à lire. Pour corriger ce problème, il est possible d'utiliser la commande \texttt{\textbackslash dfrac\{\}\{\}} pour "display frac" offrira un affichage plus aéré, à la place de \texttt{\textbackslash frac \{\}\{\}}, ce qui donne $\dfrac{2}{5}$ au lieu de $\frac{2}{5}$. Notez qu'à la place de \texttt{\textbackslash dfrac}, vous auriez pu utiliser la commande \texttt{\textbackslash displaystyle \textbackslash frac\{\}\{\}}, cela serait revenu au même!\\ De même, la commande \texttt{\textbackslash displaystyle} peut être utiliser lorsque vous affichez plusieurs équations les unes en dessous des autres, même lorsqu'elles sont mises en évidence. Ainsi, le code suivant:\\ \$\$ \\ \texttt{\textbackslash begin\{cases\}}\\ \texttt{\textbackslash displaystyle f(x) = \textbackslash sqrt\{\textbackslash ell\textasciicircum 2+ x\textasciicircum 2\} \& \textbackslash text\{lorsque \$ x\textbackslash geq 0\$ \}}\\ \texttt{\textbackslash displaystyle f(x) = \textbackslash frac\{1\}\{1+x\} \& \textbackslash text\{sinon\}}\\ \texttt{\textbackslash end \{cases\}}\\ \$\$ \\ Donne une équation aérée: $$ \begin{cases} \displaystyle f(x) = \sqrt{\ell^2+ x^2} & \text{lorsque $x\geq 0$}\\ \displaystyle f(x) = \frac{1}{1+x} & \text{sinon}\\ \end{cases} $$ \\ Plutôt que la suivante sans le displaystyle qui est "ramassée": $$ \begin{cases} f(x) = \sqrt{\ell^2+ x^2} & \text{lorsque $x\geq 0$}\\ f(x) = \frac{1}{1+x} & \text{sinon}\\ \end{cases} $$\\ Cette personnalisation de l'affichage des équations se poursuit concernant l'alignement de celle-ci. Par défaut, les équations sont alignées au centre de la page. Néanmoins, l'environnement \texttt{eqnarray} pour les équations numérotées et \texttt{eqnarray*} non numérotées permettent de centrer les équations tout en alignant les éléments de celles-ci. L'alignement se fait via les caractères "\& " qui servent de repaire comme pour les colonnes des tableaux. L'environnement \texttt{eqnarray} permet également de faire un \textit{regroupement} d'équations, formant ainsi un seul bloc plutôt qu'une suite d'équations indépendantes les unes des autres. Exemple: \begin{eqnarray*} y &=& x - y + z\\ x &=& y\\ z &=& y \end{eqnarray*} Le résultat ci-dessus paraît plus propre et plus lisible que des listes d'équations centrée au milieu de la page comme celles-dessous: $$y = x - y + z$$ $$x = y$$ $$z = y$$ \subsection{Aides dans TeXmaker} Vous n'aurez pas à connaître les commandes ci-dessus par coeur. TeXmaker propose un panel de commandes préformattées pour les formules mathématiques ainsi que pour les lettres et symboles directement dans la barre d'outils sur la gauche. Il vous suffit de cliquer sur l'onglet correspondant pour rechercher et utiliser l'objet voulu:\\ \begin{figure}[!h] \centering \includegraphics[scale=0.45]{Images/raccourcis_math_texmaker.png} \caption{Raccourcis pour symboles et commandes} \end{figure} \begin{figure}[!h] \centering \includegraphics[scale=0.45]{Images/raccourcis_math_texmaker_2.png} \caption{Raccourcis et commandes dans le menu} \end{figure} \subsection{Générateurs d'équations en ligne} Comme nous l'avons dit précédemment, il ne vous sera pas forcément nécessaire de créer vos équations en commandes et environnement LaTeX. Il existe des générateurs d'équation en ligne gratuits + ou - complets vous permettant de créer vos formules et dont le code LaTeX se créera en parallèle. Par exemple, vous pourrez tester \textcolor{blue}{\href{https://www.tutorialspoint.com/latex_equation_editor.htm}{ce LaTeX Equation Editor}}, \textcolor{blue}{\href{https://latexeditor.lagrida.com/}{cet autre LaTeX Equation Editor}} ou encore \textcolor{blue}{\href{https://latex.codecogs.com/eqneditor/editor.php}{celui-ci}}. Le principe est le même: vous utilisez les options pré-formatées pour créer votre équation, et les commandes LaTeX vous sont présentées, prêtes à être copiées-collées dans votre éditeur. Exemple: \begin{figure}[!h] \centering \includegraphics[width=1\textwidth]{Images/ex_editeur_en_ligne.png} \caption{Exemple d'un éditeur d'équation en ligne proposé} \end{figure} \section{Citer ses cources et créer une bibliographie} La citation de références et la création de bibliographie dans un fichier LaTeX se font à l’aide d’un fichier aux formats \textbf{BibTeX} ou \textbf{BibLaTeX} (les deux ont l’extension .bib) qui contient les références que l’on souhaite citer. Ce fichier .bib, que l’on va « appeler » à chaque fois que l’on cite une référence, est sauvegardé dans le même dossier que le fichier LaTeX utilisé. Ainsi, le dossier doit, au minimum, comporter ces deux fichiers (d’autres éléments s’y ajouteront éventuellement). \begin{figure}[!h] \centering \includegraphics[scale=1]{Images/fichier_bib.png} \end{figure} La personnalisation et les fonctions avancées des méthodes de citation dans LaTeX sont nombreuses mais exigerait un document propre à ce sujet. Nous nous intéresserons ici qu'aux principes de base. Veuillez donc vous référer au polycopié complet sur ce sujet pour avoir davantage d'informations. \subsection{Structure d'une référence bib} Les références dans le fichier .bib ressemblent à cela : \begin{figure}[!h] \centering \includegraphics[scale=1]{Images/référence_bib.png} \end{figure} La première ligne correspond au type de document dont il s’agit (@book, @article, @phdthesis, etc.) accompagné de la clé de citation (Citekey), c’est-à-dire l’identifiant unique de la référence qui sera appelé dans le fichier LaTeX lorsque l’on désirera citer cette référence. Les lignes suivantes correspondent aux champs d’information de la référence. On y trouve notamment le champs title, author, journal, volume (volume d’une revue), number (info additionnelle, p.ex. issue numéro d’une revue), pages, date, etc. \subsection{Différences entre le format BibTeX et BibLaTeX} Un fichier bibliographique .bib peut être créé dans deux formats : BibTeX ou BibLaTeX. Il est important de choisir le bon type de format dès le départ car chacun d’eux aura ses avantages et inconvénients et devra être utilisé avec des packages et des moteurs de compilation propre à chacun. Voici ci-dessous, en résumé, le processus pour chacun d’eux : \begin{figure}[!h] \centering \includegraphics[scale=0.3]{Images/bibtexVSbiblatex.png} \end{figure} \subsection{Création du fichier bib depuis Zotero} Une fois que l'on a décidé quel format de fichier bibliographique privilégier, il suffit d'aller dans Zotero pour sélectionner les références ou une collection entière et faire un clic-droit \textit{Exporter la collection / les documents} choisir le format BibTeX ou BibLaTeX. Ce procédé très simple a néanmoins un inconvénient, qui est que le fichier créé est statique, c’est-à-dire qu’il ne sera pas mis à jour automatiquement si la collection est complétée dans Zotero. Il faudra recréer et écraser le fichier .bib pour qu’il soit à jour. Pour corriger cet inconvénient, nous vous conseillons d'installer le plugin \textit{BetterbibTeX pour Zotero} qui permet de créer des fichiers bibliographiques dynamiques: \begin{figure}[!h] \centering \includegraphics[scale=1]{Images/betterbibtex.png} \end{figure} \subsection{Préciser les packages et les options dans TeXmaker} Il est nécessaire ensuite de préciser ses options dans TeXmaker. Depuis l'onglet \textit{options} puis \textit{Configurer TeXmaker}, dans l'onglet \textit{commandes}, sélectionnez soit \textit{bibtex \%}, soit \textit{biber \%} selon si vous avez choisi BibTeX ou BibLaTeX: \begin{figure}[!h] \centering \includegraphics[scale=0.3]{Images/configuration_bib.png} \end{figure} Vous appelez par la suite un des deux packages:\\ \begin{itemize} \item \texttt{\textbackslash usepackage[backend=bibtex]\{natbib\}} pour le format BibTeX \item \texttt{\textbackslash usepackage[backend=biber]\{biblatex\}} pour le format BibLaTeX \end{itemize} \subsection{Principes de citation et de création de bibliographie} A partir de là, lorsque vous voudrez citer une référence, vous appelerez la clés de citation avec une commande de citation telle que \texttt{\textbackslash cite\{citation key\}} ou \texttt{\textbackslash parencite \{citation key\}} par exemple.\\ Enfin, pour écrire automatiquement la bibliographie, il vous suffit d'utiliser une des deux commandes \texttt{\textbackslash bibliography} ou \texttt{\textbackslash printbibliography} à l'endroit désiré.A partir de là, lorsque vous voudrez citer une référence, vous appelerez la clés de citation avec une commande de citation telle que \texttt{\textbackslash cite\{citation key\}} ou \texttt{\textbackslash parencite \{citation key\}} par exemple.\\ Enfin, pour écrire automatiquement la bibliographie, il vous suffit d'utiliser une des deux commandes \texttt{\textbackslash bibliography} ou \texttt{\textbackslash printbibliography} à l'endroit désiré. \chapter{Beamer: les fichiers de présentation LaTeX} \chapter{Outils complémentaires} \section{Templates - Modèles} Les templates sont des modèles de fichiers LaTeX pré-formatés en termes de structures et de contenu qu'il est possible de télécharger et d'utiliser tels quels ou de s'en inspirer pour créer des documents adaptés à ses besoins. Ces templates peuvent être proposés par des institutions officielles (par exemple template officiel pour un mémoire de Master), par des éditeurs, par des portails web, etc. En voici quelques exemples: \begin{itemize} \item \textcolor{blue}{\href{https://www.overleaf.com/latex/templates}{Templates proposés par Overleaf}} \item \textcolor{blue}{\href{https://github.com/glederrey/EPFL_thesis_template}{Modèle non officiel de thèses à l'EPFL}} \item \textcolor{blue}{\href{https://www.unifr.ch/inf/softeng/en/resources/thesis-templates.html}{Modèle de thèse à l'Université de Fribourg en trois langues disponibles}} \item \textcolor{blue}{\href {https://journals.plos.org/plosone/s/latex}{Template d'article de la revue PloS One}} \end{itemize} Notez qu'il n'existe pas, à notre connaissance, de modèles officiels créés par et pour l'UNIGE. Nous vous recommandons néanmoins de rechercher et regarder des modèles existants ailleurs car cela peut grandement vous faciliter le processus de rédaction et vous faire gagner un temps important. De plus, cela vous permettra également de vous inspirer d'options LaTeX plus avancées afin de rendre vos documents plus professionnels. \section{MathPix} \textcolor{blue}{\href{https://mathpix.com/}{MathPix}} est un outil en ligne permettant de créer en un clic une équation mathématique en LaTeX à partir de textes ou documents. Concrètement MathPix vous permet de faire une capture d'écrant d'une formule mathématique et celui-ci va reconnaître automatiquement son contenu et va créer une équation LaTeX correspondante. Cela permet de gagner un temps important si d'aventure vous devez créer des équations longues et complexes à créer à la main. La version gratuite de MathPix permet seulement 20 captures d'écran avec un compte institutionnel mais une version payante à 5CHF/mois est également proposée. Notez qu'il est également possible de lui faire créer un document LaTeX à partir d'un fichier pdf de 20 pages pour la version gratuite et 500 pages pour la version payante! \section{CTAN Comprehensive TeX Archive Network} \textcolor{blue}{\href{https://ctan.org/}{CTAN}} est un portail permettant de télécharger et installer un grand nombre d'outils liés à LaTeX, notamment des packages supplémentaires non inclus dans votre suite, des macros pré-fabriquées, polices, etc. \printbibliography \end{document}