summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/formation-latex-ul/introduction.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-03-02 22:10:43 +0000
committerKarl Berry <karl@freefriends.org>2019-03-02 22:10:43 +0000
commit3ca2e2c0ec37f510c87a47ebb56eae728cd2ff27 (patch)
treea44daa5bbe2e475545493f07370c87be4deb702b /Master/texmf-dist/source/latex/formation-latex-ul/introduction.tex
parentf406f76fa5ab5e59c3219ebb7e05c31ac19485b3 (diff)
formation-latex-ul (2mar19)
git-svn-id: svn://tug.org/texlive/trunk@50205 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/formation-latex-ul/introduction.tex')
-rw-r--r--Master/texmf-dist/source/latex/formation-latex-ul/introduction.tex149
1 files changed, 101 insertions, 48 deletions
diff --git a/Master/texmf-dist/source/latex/formation-latex-ul/introduction.tex b/Master/texmf-dist/source/latex/formation-latex-ul/introduction.tex
index a8e5e6f5dc6..8454a22f1db 100644
--- a/Master/texmf-dist/source/latex/formation-latex-ul/introduction.tex
+++ b/Master/texmf-dist/source/latex/formation-latex-ul/introduction.tex
@@ -1,3 +1,14 @@
+%%% Copyright (C) 2018 Vincent Goulet
+%%%
+%%% Ce fichier fait partie du projet
+%%% «Rédaction avec LaTeX»
+%%% https://gitlab.com/vigou3/formation-latex-ul
+%%%
+%%% Cette création est mise à disposition sous licence
+%%% Attribution-Partage dans les mêmes conditions 4.0
+%%% International de Creative Commons.
+%%% https://creativecommons.org/licenses/by-sa/4.0/
+
\chapter{Introduction}
\label{chap:introduction}
@@ -27,14 +38,77 @@ la Faculté des études supérieures et postdoctorales. Les autres
lecteurs pourront sans mal escamoter ces passages.
Chaque chapitre comporte quelques exercices. Les solutions se trouvent
-en annexe. En consultation électronique, le numéro d'un exercice est,
-le cas échéant, un hyperlien vers sa solution, et vice versa.
+en annexe.
+
+\section*{Fonctionnalités interactives}
+
+En consultation électronique, ce document se trouve enrichi de
+plusieurs fonctionnalités interactives.
+\begin{itemize}
+\item Intraliens entre le numéro d'un exercice et sa solution, et vice
+ versa. Ces intraliens sont aussi marqués par la couleur
+ \textcolor{link}{\rule{1.5em}{1.2ex}}.
+\item Intraliens entre les citations dans le texte et leur entrée dans
+ la bibliographie. Ces intraliens sont marqués par la couleur
+ \textcolor{citation}{\rule{1.5em}{1.2ex}}.
+\item Hyperliens vers des ressources externes marqués par le symbole
+ {\faExternalLink} et la couleur
+ \textcolor{url}{\rule{1.5em}{1.2ex}}.
+\item Table des matières, liste des tableaux et liste des figures
+ permettant d'accéder rapidement à des ressources du document.
+\item Index comprenant les références aux commandes et environnements
+ {\LaTeX}, ainsi qu'aux noms de paquetages et de classes.
+\end{itemize}
+
+\section*{Blocs signalétiques}
+
+Le document est parsemé de divers types de blocs signalétiques
+inspirés de
+\link{https://asciidoctor.org/docs/user-manual/\#admonition}{AsciiDoc}
+qui visent à attirer votre attention sur une notion.
+
+\tipbox{Astuce! Ces blocs contiennent un truc, une astuce, ou tout
+ autre type d'information utile.}
+\vspace{-\baselineskip}
+
+\importantbox{Important! Ces blocs contiennent les remarques les plus
+ importantes. Veillez à en tenir compte.}
+\vspace{-\baselineskip}
+
+\notebox{Ces blocs contiennent des remarques additionnelles sur
+ la matière ou des informations amusantes, mais non essentielles.}
+\vspace{-\baselineskip}
+
+\videobox{Ces blocs contiennent des renvois vers des vidéos dans la %
+ \link{https://www.youtube.com/channel/UCIQia52CHKSCQG3_mwLSNCA}{chaine
+ YouTube} liée ce document.}
+
+\section*{Liens vers la documentation}
+
+Parmi les hyperliens vers des ressources externes, le texte compte
+plusieurs renvois vers la documentation d'un paquetage ou d'une
+classe, par exemple vers la %
+\doc{memoir}{http://texdoc.net/pkg/memoir/} %
+de la classe \class{memoir}. L'hyperlien mène vers la documentation
+dans le site %
+\link{http://texdoc.net}{TeXdoc Online}. On trouve également dans la
+marge le nom du fichier correspondant (sans l'extension \code{.pdf})
+sur un système doté de {\TeX}~Live.
-Un index en fin d'ouvrage collige les références aux commandes et
-environnements {\LaTeX}, ainsi qu'aux noms de paquetages et de
-classes.
+La plupart des logiciels intégrés de rédaction {\LaTeX} offrent une
+interface pour accéder à cette documentation.
+\begin{itemize}
+\item TeXShop: menu \code{Aide|Afficher l'aide pour le
+ package} (\optkey\,\cmdkey\, I).
+\item Texmaker: menu \code{Aide|TeXDoc [selection]}.
+\item GNU~Emacs: commande \code{TeX-doc} (\code{C-c ?}) du mode
+ spécialisé AUC{\TeX}.
+\end{itemize}
+Le lecteur devrait consulter la rubrique d'aide de son éditeur pour
+savoir s'il offre une interface au système de gestion de la
+documentation Texdoc de {\TeX}~Live.
-\subsection*{Autres références utiles}
+\section*{Références additionnelles}
L'ouvrage n'a aucune prétention d'exhaustivité. La consultation de
documentation additionnelle pourra s'avérer nécessaire pour réaliser
@@ -45,11 +119,11 @@ documentation (plus de 600~pages!) de la classe \class{memoir}
\citep{memoir} constitue une autre référence de choix. Nous
recommandons également:
\begin{itemize}
-\item \link{http://fr.wikibooks.org/wiki/LaTeX}{\emph{LaTeX} dans
+\item \link{https://fr.wikibooks.org/wiki/LaTeX}{\emph{LaTeX} dans
Wikilivre} pour de la documentation en ligne, en français et
libre;
\item le très actif forum de discussion
- \link{http://tex.stackexchange.com}{{\TeX}--{\LaTeX} Stack Exchange}
+ \link{https://tex.stackexchange.com}{{\TeX}--{\LaTeX} Stack Exchange}
(avant de penser y poser une question, vérifier que la réponse ne se trouve
pas déjà dans le forum\dots\ ce qui risque fort d'être le cas);
\item la très complète
@@ -58,60 +132,39 @@ recommandons également:
utilisateurs de {\LaTeX} du Royaume-Uni.
\end{itemize}
-\subsection*{Installation d'une distribution}
+\section*{Installation d'une distribution}
L'utilisation de {\LaTeX} requiert évidemment une distribution du
système. Nous recommandons la distribution {\TeX}~Live administrée par
-le {\TeX} Users Group. Les hyperliens ci-dessous mènent vers des
-vidéos qui expliquent comment installer cette distribution.
-\begin{itemize}
-\item \capsule{https://youtu.be/kA53EQ3Q47w}{%
- Installation sur macOS}
-\item \capsule{https://youtu.be/7MfodhaghUk}{%
- Installation sur Windows}
-\end{itemize}
-
-\subsection*{Hyperliens vers la documentation}
+le {\TeX} Users Group.
-Le texte comporte plusieurs renvois vers la documentation d'un
-paquetage ou d'une classe, par exemple vers la %
-\doc{memoir}{http://texdoc.net/pkg/memoir/} %
-de la classe \class{memoir}. L'hyperlien mène vers la version en ligne
-de la documentation dans le site %
-\link{http://texdoc.net}{TeXdoc Online}. On trouve également dans la
-marge le nom du fichier correspondant (sans l'extension \code{.pdf})
-sur un système doté de {\TeX}~Live.
-
-La plupart des logiciels intégrés de rédaction {\LaTeX} offrent une
-interface pour accéder à cette documentation.
-\begin{itemize}
-\item TeXShop: menu \code{Aide|Afficher l'aide pour le
- package} (\optkey\,\cmdkey\, I).
-\item Texmaker: menu \code{Aide|TeXDoc [selection]}.
-\item GNU~Emacs: commande \code{TeX-doc} (\code{C-c ?}) du mode
- spécialisé AUC{\TeX}.
-\end{itemize}
-Le lecteur devrait consulter la rubrique d'aide de son éditeur pour
-savoir s'il offre une interface au système de gestion de la
-documentation Texdoc de {\TeX}~Live.
+\videobox{Visionnez les vidéos qui expliquent comment installer la
+ distribution {\TeX}~Live \link{https://youtu.be/uJFbhQkDbU8}{sur
+ macOS} et \link{https://youtu.be/wO2FlNmye14}{sur Windows}.}
-\subsection*{Fichiers d'accompagnement}
+\section*{Fichiers d'accompagnement}
Ce document devrait être accompagné des fichiers nécessaires pour
compléter certains exercices figurant à la fin des chapitres, ainsi
que d'un gabarit \fichier{exercice\_gabarit.tex} pour composer les
solutions des autres exercices. Si ce n'est pas le cas, récupérer les
-fichiers dans le site \href{\ctanurl}{\emph{Comprehensive TeX Archive
- Network}} (CTAN).
+fichiers dans le site \link{\ctanurl}{\emph{Comprehensive TeX Archive
+ Network} (CTAN)}.
-\begin{flushright}
- Vincent Goulet \\
- Québec, novembre \year
-\end{flushright}
+\section*{Document libre}
+
+Tout comme {\TeX}, {\LaTeX} et l'ensemble des outils présentés dans ce
+document, le projet «Rédaction avec {\LaTeX}» s'inscrit dans le
+mouvement de
+l'\link{https://www.gnu.org/philosophy/free-sw.html}{informatique
+ libre}. Vous pouvez accéder à l'ensemble du code source en suivant
+le lien dans la page de copyright. Vous trouverez dans le fichier
+\code{README.md} toutes les informations utiles pour composer le
+document.
%%% Local Variables:
%%% mode: latex
-%%% TeX-engine: xetex
%%% TeX-master: "formation-latex-ul"
+%%% TeX-engine: xetex
%%% encoding: utf-8
%%% End: