% Source pour un exercice proposé lors d'un rendez-vous de l'info d'introduction
% à LaTeX. Il s'agit de reproduire un document sur la base du rendu PDF, en
% démarrant avec un fichier `.tex` contenant déjà un préambule minimal.
%
% Printemps 2023
% License CC BY-SA 4.0

% ##############
%   Préambule  #
% ##############

% Définition du type de document
\documentclass[a4paper,12pt]{article}

% Paquets de base à charger
\usepackage[T1]{fontenc}                % Caractères accentués dans le PDF de sortie
\usepackage{lmodern}                    % Police dérivée de CM pour les langues latines
\usepackage[french]{babel}              % Localisation du document en français
\usepackage[style=french]{csquotes}     % Gestion des blocs de citations
\usepackage[colorlinks]{hyperref}       % Gestion des liens hypertexte
\usepackage{authblk}                    % Affiliation des auteurs, autrices
\usepackage{enumitem}                   % Paramétrage des listes
\setlist{topsep=12pt}                   % Ajoute un espacement vertical supérieur à
                                        % toutes les listes
% \setlist[itemize]{label=\textbullet}    % Utilise des puces à la place des
                                        % tirets pour les listes non ordonnées
\usepackage{booktabs}                   % Gestion des tableaux améliorée
\usepackage{graphicx}                   % Insertion d'images
\usepackage{xspace}                     % Conserve les espaces après certaines commandes
\usepackage{empheq}                     % Ajoute un cadre par exemple aux équations
\usepackage{tikz}                       % Permet de dessiner
\usepackage{pgfplots}                   % Trace une courbe à partir d'une fonction
\usepackage{mathrsfs}                   % Pour la rédaction d'équations mathématiques
\pgfplotsset{compat=1.15}
\usetikzlibrary{arrows}

\usepackage[backend=biber,
            style=numeric]{biblatex}    % Gestion de la bibliographie
\addbibresource{references.bib}         % Base de donnée des références utilisées

% ################
%   Métadonnées  #
% ################

\title{Un petit pas pour le texte}
\author[1]{Jane Doe}
\author[2]{John Done}
\affil[1]{Faculté des sciences, Université A}
\affil[2]{Faculté des lettres, Université B}
\date{23 mai 2023}

% ##############
%    Document  #
% ##############

\begin{document}

    % Création de la page de titre
    \maketitle

    % Création de la table des matières
    \tableofcontents

    \listoffigures

    \section*{Résumé} \label{sec:abstract}

    Cet \enquote{article} est un exercice dont le but est de découvrir quelques
    éléments de base en LaTeX. Il s'agit, à partir d'un fichier
    \texttt{.tex} et d'un fichier {\scshape{pdf}} de reproduire une mise en
    forme. Il est conseillé de s'aider du support de cours communiqué, ainsi
    que de toute aide trouvée en ligne: le but est d'apprendre à trouver
    l'information désirée.

    Dans certains cas, il y a plusieurs solutions possibles, parfois non
    connues par les personnes proposant cet atelier. Les points essentiels à
    reproduire sont:

    \begin{itemize}
        \item La structure au document.
        \item La page de titre et la table des matières.
        \item Les listes \enquote{à puces}.
        \item Les listes ordonnées.
        \item Les définitions.
        \item Les références croisées (pouvoir faire un lien vers une section,
              par exemple).
        \item Les liens hypertexte.
        \item L'insertion d'images avec une légende.
        \item Les tableaux.
        \item Les équations.
        \item Les graphiques.
    \end{itemize}

    \begin{figure}[!h]
        \centering
        \includegraphics[scale=0.1]{lion.png}
        \caption{La mascotte de \LaTeX}
        \label{fig:lion}
    \end{figure}

    Ces éléments ne sont qu'un petit aperçu des possibilités d'élaboration de
    documents avec \LaTeX. Dès que vous voulez réaliser quelque chose, imaginez
    que c'est possible et chercher comment le faire, si possible de la manière
    la plus économe et générale.

    \section{Des listes et une définition} \label{sec:part1}

    \subsection{Les listes \enquote{à puces}} \label{subsec:lists}

    Les listes sont réalisées dans l'environnement \texttt{itemize}. Elles
    peuvent être configurées pour l'ensemble du document grâce au paquet
    \texttt{enumitem}\footnote{Voir \url{https://ctan.org/pkg/enumitem}}.

    \begin{itemize}
        \item Une liste.
        \item À déjà été vue.
        \item Dans le résumé.
    \end{itemize}
    
    \subsection{Les listes ordonnées} \label{subsec:enum}

    Pour les listes ordonnées, on utilise l'environnement \texttt{enumarate}:

    \begin{enumerate}
        \item Voici.
        \item Une liste.
        \item Numérotée.
    \end{enumerate}

    \subsection{Les définitions} \label{subsec:def}

    L'environnement \texttt{description} est utile pour mettre en évidence une définition. On peut lui donner en option le label utilisé.
    
    \begin{description}
        \item[Définition] \enquote{Une définition est une proposition qui met
            en équivalence un élément définissant et un élément étant défini.}
            \autocite{contributeurs_de_wikipedia_definition_2023}
    \end{description}

    \section{Des liens}

    \subsubsection{Les références croisées} \label{part2}

    Au sein d'un document, il y a des références vers d'autres parties ou éléments du document, qui facilitent la navigation. Certains liens sont gérés automatiquement, par exemple, la table des matière propose des liens vers les différentes sections ou sous-sections.

    Mais il est possible de faire explicitement un lien:

    \begin{itemize}
        \item Vers la section \ref{sec:part4} ou la sous-section \ref{subsec:def}.
        \item Vers un élément, comme l'équation \ref{equ1}.
        \item Vers la figure \ref{fig:lion}.
    \end{itemize}

    \section{Images et tableaux} \label{sec:part3}

    \subsection{Insertion d'images} \label{subsec:images}

    Une image a déjà été insérée dans le résumé, mais plaçons-en une deuxième ici.

    \begin{figure}[!h]
        \centering
        \includegraphics[scale=1.2]{arve.jpg}
        \caption{Image d'illustration de la bibliothèque du site Arve}
    \end{figure}

    \subsection{Insertion de tableaux} \label{subsec:tables}

    Les tableaux peuvent vites s'avérer pénibles à gérer sous LaTeX. Une solution est d'utiliser un générateur de tableau, afin de se faciliter la tâche\footnote{Par exemple \url{https://www.tablesgenerator.com/}}.

    \begin{table}[!h]
        \centering
        \begin{tabular}{@{}lllll@{}}
        \toprule
         & Nom & Prénom & Code postal & Ville \\ \midrule
         & Jane & Doe & 1201  & Genève \\
         & John & Done & 1227 & Carouge \\ \bottomrule
        \end{tabular}
        \caption{Exemple de tableau}
        \label{table:1}
        \end{table}

    \section{Équations et graphiques} \label{sec:part4}

    \subsection{Un graphique à partir d'une équation}

    Pouvez-vous générer un graphique représentant la fonction suivante (\ref{equ1})?

    \begin{empheq}[box=\fbox]{equation} \label{equ1}
        f(x) = x^2 + 2x - 1
    \end{empheq}

    Il y a comme toujours plusieurs solutions possibles, mais ici l'usage de TikZ a été préféré. Pour débuter, afin de comprendre la syntaxe, il est conseillé d'utiliser \texttt{geogebra}\footnote{\url{https://www.geogebra.org/download?lang=fr}} dans sa version \enquote{locale}, de réaliser le graphique désiré, puis de l'exporter dans un format \enquote{texte} compréhensible par LaTeX.

    \begin{figure}[!h]
        \centering
        \begin{tikzpicture}[]
            \begin{axis}[
                x=1.0cm,y=1.0cm,
                axis lines=middle,
                % ymajorgrids=true,
                % xmajorgrids=true,
                xmin=-4.5,
                xmax=4.5,
                ymin=-3.3,
                ymax=3.3,
                xtick={-4.0,-3.0,...,4.0},
                ytick={-3.0,-2.0,...,3.0},]
            \draw[line width=1.pt,smooth,samples=100] plot(\x,{(\x)^(2)+2*(\x)-1});
            \begin{scriptsize}
                \draw[](-2.5,2.3) node {$f(x) = x^2 + 2x - 1$};
            \end{scriptsize}
            \end{axis}
        \end{tikzpicture}
        \caption{Graphique d'une équation du 2\ieme degré}
    \end{figure}

    \section{Conclusion} \label{concl}

    Lorem ipsum dolor sit amet, an per disputando liberavisse. Ea quo iisque
    delicata indoctum, et vix solum dicta imperdiet, vel liber tractatos id.
    Eum timeam intellegat in, perpetua reprimique definitionem eam no, impetus
    docendi sea te. Vel maiestatis delicatissimi ea, quo no eruditi deserunt,
    augue mazim epicuri mea ex. Imperdiet forensibus at mea, eam ut ferri
    iisque urbanitas.

    Id prima vivendum nec, hinc mutat ius ut, eu pro modo fugit dolorum. Eros
    facilis eu pri, qui ridens equidem id. Ei mediocrem definitiones pro. Quem
    feugiat torquatos sed eu. No mei aeque gloriatur, quot fugit tincidunt sit
    et. Illud ludus munere ei sea, liber vituperatoribus est cu, in sed vidisse
    tamquam.

% ################
%  Bibliographie #
% ################

    \printbibliography[title=Bibliographie]

\end{document}
