From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- info/guide-latex-fr/Chapitres/annexes.tex | 381 +++ info/guide-latex-fr/Chapitres/code-base.tex | 18 + info/guide-latex-fr/Chapitres/commandes.tex | 139 + info/guide-latex-fr/Chapitres/intro.tex | 162 ++ info/guide-latex-fr/Chapitres/p1-compilation.tex | 160 ++ info/guide-latex-fr/Chapitres/p1-historique.tex | 123 + info/guide-latex-fr/Chapitres/p1-installation.tex | 95 + info/guide-latex-fr/Chapitres/p2-erreurs.tex | 82 + info/guide-latex-fr/Chapitres/p2-images.tex | 398 +++ info/guide-latex-fr/Chapitres/p2-maths.tex | 451 ++++ info/guide-latex-fr/Chapitres/p2-regles.tex | 185 ++ info/guide-latex-fr/Chapitres/p2-tableaux.tex | 309 +++ info/guide-latex-fr/Chapitres/p2-texte.tex | 803 ++++++ info/guide-latex-fr/Chapitres/p3-beamer.tex | 3 + info/guide-latex-fr/Chapitres/p3-images.tex | 189 ++ info/guide-latex-fr/Chapitres/p3-intro.tex | 37 + info/guide-latex-fr/Chapitres/p3-maths.tex | 65 + info/guide-latex-fr/Chapitres/p3-moteurs.tex | 184 ++ info/guide-latex-fr/Chapitres/p3-pstricks.tex | 510 ++++ info/guide-latex-fr/Chapitres/p3-structuration.tex | 139 + info/guide-latex-fr/Chapitres/p3-tableaux.tex | 458 ++++ info/guide-latex-fr/Chapitres/p3-texte.tex | 967 +++++++ info/guide-latex-fr/Chapitres/p3-tikz.tex | 1151 +++++++++ info/guide-latex-fr/Chapitres/packages.tex | 53 + info/guide-latex-fr/Chapitres/page-fin.tex | 47 + info/guide-latex-fr/Chapitres/page-garde.tex | 53 + info/guide-latex-fr/Images/Aide_LaTeX1.png | Bin 0 -> 339520 bytes info/guide-latex-fr/Images/Aide_LaTeX1.xcf | Bin 0 -> 1075991 bytes info/guide-latex-fr/Images/Aide_LaTeX2.png | Bin 0 -> 58299 bytes info/guide-latex-fr/Images/Aide_LaTeX3.png | Bin 0 -> 696526 bytes info/guide-latex-fr/Images/Aide_LaTeX4.png | Bin 0 -> 35576 bytes info/guide-latex-fr/Images/Aide_LaTeX5.png | Bin 0 -> 58190 bytes info/guide-latex-fr/Images/Aide_LaTeX6.png | Bin 0 -> 193199 bytes info/guide-latex-fr/Images/Aide_LaTeX7.png | Bin 0 -> 232836 bytes .../guide-latex-fr/Images/aide_LaTeX1_original.png | Bin 0 -> 301774 bytes info/guide-latex-fr/Images/apercu_pdf.png | Bin 0 -> 262900 bytes info/guide-latex-fr/Images/apercu_pdf.xcf | Bin 0 -> 1154215 bytes info/guide-latex-fr/Images/apercu_pdf_menu.png | Bin 0 -> 81824 bytes info/guide-latex-fr/Images/apercu_pdf_original.png | Bin 0 -> 242132 bytes .../Images/buque_auteur-eps-converted-to.pdf | Bin 0 -> 6601 bytes info/guide-latex-fr/Images/buque_auteur.eps | 223 ++ info/guide-latex-fr/Images/buque_auteur.svg | 72 + info/guide-latex-fr/Images/compilation_clavier.png | Bin 0 -> 127883 bytes info/guide-latex-fr/Images/compilation_clavier.xcf | Bin 0 -> 598003 bytes info/guide-latex-fr/Images/compilation_clics.png | Bin 0 -> 123936 bytes info/guide-latex-fr/Images/compilation_clics.xcf | Bin 0 -> 485055 bytes .../Images/compilation_diagramme.tex | 63 + info/guide-latex-fr/Images/compilation_menu1.png | Bin 0 -> 37933 bytes info/guide-latex-fr/Images/compilation_menu2.png | Bin 0 -> 50312 bytes .../guide-latex-fr/Images/compilation_original.png | Bin 0 -> 68887 bytes info/guide-latex-fr/Images/compilation_rapide.png | Bin 0 -> 145736 bytes info/guide-latex-fr/Images/compilation_rapide.xcf | Bin 0 -> 629848 bytes info/guide-latex-fr/Images/compilation_schema.tex | 55 + info/guide-latex-fr/Images/dknuth.jpg | Bin 0 -> 44880 bytes .../Images/eclair-eps-converted-to.pdf | Bin 0 -> 2976 bytes info/guide-latex-fr/Images/eclair.eps | 90 + .../Images/eclair_image-matricielle.png | Bin 0 -> 2407 bytes info/guide-latex-fr/Images/fond.jpg | Bin 0 -> 25182 bytes info/guide-latex-fr/Images/fond_TikZ.pdf | Bin 0 -> 78445 bytes .../Images/latex-project-logo-eps-converted-to.pdf | Bin 0 -> 14183 bytes info/guide-latex-fr/Images/latex-project-logo.eps | 551 ++++ info/guide-latex-fr/Images/latex-project-logo.svg | 116 + .../Images/licence-eps-converted-to.pdf | Bin 0 -> 7575 bytes info/guide-latex-fr/Images/licence.eps | 2727 ++++++++++++++++++++ info/guide-latex-fr/Images/llamport.jpg | Bin 0 -> 86054 bytes info/guide-latex-fr/Images/miktex.png | Bin 0 -> 15052 bytes info/guide-latex-fr/Images/ol_plus_sl.png | Bin 0 -> 62033 bytes .../Images/ornament-eps-converted-to.pdf | Bin 0 -> 2944 bytes info/guide-latex-fr/Images/ornament.eps | 117 + info/guide-latex-fr/Images/ornament.svg | 62 + info/guide-latex-fr/Images/overleaf.png | Bin 0 -> 25305 bytes info/guide-latex-fr/Images/sharelatex.png | Bin 0 -> 28491 bytes info/guide-latex-fr/Images/texmaker.png | Bin 0 -> 13762 bytes info/guide-latex-fr/README.md | 90 + info/guide-latex-fr/guide-latex-fr.pdf | Bin 0 -> 4470242 bytes info/guide-latex-fr/guide-latex-fr.tex | 68 + 76 files changed, 11396 insertions(+) create mode 100644 info/guide-latex-fr/Chapitres/annexes.tex create mode 100644 info/guide-latex-fr/Chapitres/code-base.tex create mode 100644 info/guide-latex-fr/Chapitres/commandes.tex create mode 100644 info/guide-latex-fr/Chapitres/intro.tex create mode 100644 info/guide-latex-fr/Chapitres/p1-compilation.tex create mode 100644 info/guide-latex-fr/Chapitres/p1-historique.tex create mode 100644 info/guide-latex-fr/Chapitres/p1-installation.tex create mode 100644 info/guide-latex-fr/Chapitres/p2-erreurs.tex create mode 100644 info/guide-latex-fr/Chapitres/p2-images.tex create mode 100644 info/guide-latex-fr/Chapitres/p2-maths.tex create mode 100644 info/guide-latex-fr/Chapitres/p2-regles.tex create mode 100644 info/guide-latex-fr/Chapitres/p2-tableaux.tex create mode 100644 info/guide-latex-fr/Chapitres/p2-texte.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-beamer.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-images.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-intro.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-maths.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-moteurs.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-pstricks.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-structuration.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-tableaux.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-texte.tex create mode 100644 info/guide-latex-fr/Chapitres/p3-tikz.tex create mode 100644 info/guide-latex-fr/Chapitres/packages.tex create mode 100644 info/guide-latex-fr/Chapitres/page-fin.tex create mode 100644 info/guide-latex-fr/Chapitres/page-garde.tex create mode 100644 info/guide-latex-fr/Images/Aide_LaTeX1.png create mode 100644 info/guide-latex-fr/Images/Aide_LaTeX1.xcf create mode 100644 info/guide-latex-fr/Images/Aide_LaTeX2.png create mode 100644 info/guide-latex-fr/Images/Aide_LaTeX3.png create mode 100644 info/guide-latex-fr/Images/Aide_LaTeX4.png create mode 100644 info/guide-latex-fr/Images/Aide_LaTeX5.png create mode 100644 info/guide-latex-fr/Images/Aide_LaTeX6.png create mode 100644 info/guide-latex-fr/Images/Aide_LaTeX7.png create mode 100644 info/guide-latex-fr/Images/aide_LaTeX1_original.png create mode 100644 info/guide-latex-fr/Images/apercu_pdf.png create mode 100644 info/guide-latex-fr/Images/apercu_pdf.xcf create mode 100644 info/guide-latex-fr/Images/apercu_pdf_menu.png create mode 100644 info/guide-latex-fr/Images/apercu_pdf_original.png create mode 100644 info/guide-latex-fr/Images/buque_auteur-eps-converted-to.pdf create mode 100644 info/guide-latex-fr/Images/buque_auteur.eps create mode 100644 info/guide-latex-fr/Images/buque_auteur.svg create mode 100644 info/guide-latex-fr/Images/compilation_clavier.png create mode 100644 info/guide-latex-fr/Images/compilation_clavier.xcf create mode 100644 info/guide-latex-fr/Images/compilation_clics.png create mode 100644 info/guide-latex-fr/Images/compilation_clics.xcf create mode 100644 info/guide-latex-fr/Images/compilation_diagramme.tex create mode 100644 info/guide-latex-fr/Images/compilation_menu1.png create mode 100644 info/guide-latex-fr/Images/compilation_menu2.png create mode 100644 info/guide-latex-fr/Images/compilation_original.png create mode 100644 info/guide-latex-fr/Images/compilation_rapide.png create mode 100644 info/guide-latex-fr/Images/compilation_rapide.xcf create mode 100644 info/guide-latex-fr/Images/compilation_schema.tex create mode 100644 info/guide-latex-fr/Images/dknuth.jpg create mode 100644 info/guide-latex-fr/Images/eclair-eps-converted-to.pdf create mode 100644 info/guide-latex-fr/Images/eclair.eps create mode 100644 info/guide-latex-fr/Images/eclair_image-matricielle.png create mode 100644 info/guide-latex-fr/Images/fond.jpg create mode 100644 info/guide-latex-fr/Images/fond_TikZ.pdf create mode 100644 info/guide-latex-fr/Images/latex-project-logo-eps-converted-to.pdf create mode 100644 info/guide-latex-fr/Images/latex-project-logo.eps create mode 100644 info/guide-latex-fr/Images/latex-project-logo.svg create mode 100644 info/guide-latex-fr/Images/licence-eps-converted-to.pdf create mode 100644 info/guide-latex-fr/Images/licence.eps create mode 100644 info/guide-latex-fr/Images/llamport.jpg create mode 100644 info/guide-latex-fr/Images/miktex.png create mode 100644 info/guide-latex-fr/Images/ol_plus_sl.png create mode 100644 info/guide-latex-fr/Images/ornament-eps-converted-to.pdf create mode 100644 info/guide-latex-fr/Images/ornament.eps create mode 100644 info/guide-latex-fr/Images/ornament.svg create mode 100644 info/guide-latex-fr/Images/overleaf.png create mode 100644 info/guide-latex-fr/Images/sharelatex.png create mode 100644 info/guide-latex-fr/Images/texmaker.png create mode 100644 info/guide-latex-fr/README.md create mode 100644 info/guide-latex-fr/guide-latex-fr.pdf create mode 100644 info/guide-latex-fr/guide-latex-fr.tex (limited to 'info/guide-latex-fr') diff --git a/info/guide-latex-fr/Chapitres/annexes.tex b/info/guide-latex-fr/Chapitres/annexes.tex new file mode 100644 index 0000000000..0d5d9232eb --- /dev/null +++ b/info/guide-latex-fr/Chapitres/annexes.tex @@ -0,0 +1,381 @@ +% Changement de la numérotation (annexes) +\renewcommand{\thefigure}{A.\arabic{figure}} +\setcounter{figure}{0} +\renewcommand{\thetable}{A.\arabic{table}} +\setcounter{table}{0} + + +% Page 1 -- Rappel de mise en forme + +\vspace*{\fill} + +\begin{table}[H] +\centering +\caption{Les différentes possibilités de mise en forme du texte} +\label{annexes-mise-en-forme} +\begin{tabular}{lll} \toprule +Texte & Rendu & Environnement \\ \midrule +\verb?\textbf{gras}? & \textbf{gras} & \verb?bfseries? \\ +\verb?\textit{italique}? & \textit{italique} & \verb?itshape? \\ +\verb?\emph{emphase}? & \emph{emphase} & \verb?em? \\ +\verb?\textsl{penché}? & \textsl{penché} & \verb?slshape? \\ +\verb?\textsc{Petites Capitales}? & \textsc{Petites Capitales} & \verb?scshape? \\ +\verb?\textsf{sans empattement}? & \textsf{sans empattement} & \verb?sffamily? \\ +\verb?\texttt{machine}? & \texttt{machine (à écrire)} & \verb?ttfamily? \\ \bottomrule +\end{tabular} +\end{table} + +\vspace*{\fill}\clearpage + + +% Page 2 -- Symboles courants sous LaTeX + +\vspace*{\fill} + +\begin{table}[H] +\centering +\caption{Liste non exhaustive des symboles disponibles sous \LaTeX{}} +\label{annexes-liste-symboles} +\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}lll} \toprule +\textbf{Code} & \textbf{Rendu} & \textbf{Description} \\ \midrule +\verb?\&? & \& & Esperluette \\ +\verb?\oe? et \verb?\OE? & \oe{} et \OE & Ligature \oe \\ +\verb?\ae? et \verb?\AE? & \ae{} et \AE & Ligature \ae \\ +\verb?\ss? & \ss & Eszett \\ +\verb?\no? & \no & Numéro \\ \\ + +\verb?-? & - & Tiret court \\ +\verb?--? & -- & Tiret moyen \\ +\verb?---? & --- & Tiret long \\ +\verb?\dots? & \dots & Points de suspension \\ +\verb?\og? et \verb?fg? & \og et \fg & Guillemets français ouvrants \\ +\verb?``? {\footnotesize{}(accents graves)} & `` & Guillemets anglais ouvrants \\ +\verb?''? {\footnotesize{}(apostrophes)} & '' & Guillemets anglais fermants \\ +\verb?\%? & \% & Pourcent \\ +\verb?\euro? & \euro{} & Euro (package \verb?marvosym?) \\ +\verb?\$? & \$ & Dollar \\ +\verb?\textcopyright? & \textcopyright & Copyright \\ +\verb?\textregistered? & \textregistered & Marque déposée \\ +\verb?\texttrademark? & \texttrademark & Trademark \\ \\ + +\verb?\#? & \# & Dièse \\ +\verb?\{? & \{ & Accolade ouvrante \\ +\verb?\}? & \} & Accolade fermante \\ +\verb?\_? & \_ & \textit{Underscore} \\ +\verb?\textbackslash? & \textbackslash & \textit{Backslash} \\ +\verb?\textasciitilde? & \textasciitilde & Tilde \\ \bottomrule +\end{tabular*} +\end{table} + +\vspace*{\fill}\clearpage + + +% Page 3 -- Symboles du package pifont + +\vspace*{\fill} + +\begin{table}[H] +\centering +\caption{Liste des symboles du package \texttt{pifont}} +\resizebox{\linewidth}{!}{\begin{tabular}{*{7}{cc|}cc} +32 & \ding{32} & 33 & \ding{33} & 34 & \ding{34} & 35 & \ding{35} & 36 & \ding{36} & 37 & \ding{37} & 38 & \ding{38} & 39 & \ding{39} \\ +40 & \ding{40} & 41 & \ding{41} & 42 & \ding{42} & 43 & \ding{43} & 44 & \ding{44} & 45 & \ding{45} & 46 & \ding{46} & 47 & \ding{47} \\ +48 & \ding{48} & 49 & \ding{49} & 50 & \ding{50} & 51 & \ding{51} & 52 & \ding{52} & 53 & \ding{53} & 54 & \ding{54} & 55 & \ding{55} \\ +56 & \ding{56} & 57 & \ding{57} & 58 & \ding{58} & 59 & \ding{59} & 60 & \ding{60} & 61 & \ding{61} & 62 & \ding{62} & 63 & \ding{63} \\ +64 & \ding{64} & 65 & \ding{65} & 66 & \ding{66} & 67 & \ding{67} & 68 & \ding{68} & 69 & \ding{69} & 70 & \ding{70} & 71 & \ding{71} \\ +72 & \ding{72} & 73 & \ding{73} & 74 & \ding{74} & 75 & \ding{75} & 76 & \ding{76} & 77 & \ding{77} & 78 & \ding{78} & 79 & \ding{79} \\ +80 & \ding{80} & 81 & \ding{81} & 82 & \ding{82} & 83 & \ding{83} & 84 & \ding{84} & 85 & \ding{85} & 86 & \ding{86} & 87 & \ding{87} \\ +88 & \ding{88} & 89 & \ding{89} & 90 & \ding{90} & 91 & \ding{91} & 92 & \ding{92} & 93 & \ding{93} & 94 & \ding{94} & 95 & \ding{95} \\ +96 & \ding{96} & 97 & \ding{97} & 98 & \ding{98} & 99 & \ding{99} & 100 & \ding{100} & 101 & \ding{101} & 102 & \ding{102} & 103 & \ding{103} \\ +104 & \ding{104} & 105 & \ding{105} & 106 & \ding{106} & 107 & \ding{107} & 108 & \ding{108} & 109 & \ding{109} & 110 & \ding{110} & 111 & \ding{111} \\ +112 & \ding{112} & 113 & \ding{113} & 114 & \ding{114} & 115 & \ding{115} & 116 & \ding{116} & 117 & \ding{117} & 118 & \ding{118} & 119 & \ding{119} \\ +120 & \ding{120} & 121 & \ding{121} & 122 & \ding{122} & 123 & \ding{123} & 124 & \ding{124} & 125 & \ding{125} & 126 & \ding{126} \\ + & & 161 & \ding{161} & 162 & \ding{162} & 163 & \ding{163} & 164 & \ding{164} & 165 & \ding{165} & 166 & \ding{166} & 167 & \ding{167} \\ +168 & \ding{168} & 169 & \ding{169} & 170 & \ding{170} & 171 & \ding{171} & 172 & \ding{172} & 173 & \ding{173} & 174 & \ding{174} & 175 & \ding{175} \\ +176 & \ding{176} & 177 & \ding{177} & 178 & \ding{178} & 179 & \ding{179} & 180 & \ding{180} & 181 & \ding{181} & 182 & \ding{182} & 183 & \ding{183} \\ +184 & \ding{184} & 185 & \ding{185} & 186 & \ding{186} & 187 & \ding{187} & 188 & \ding{188} & 189 & \ding{189} & 190 & \ding{190} & 191 & \ding{191} \\ +192 & \ding{192} & 193 & \ding{193} & 194 & \ding{194} & 195 & \ding{195} & 196 & \ding{196} & 197 & \ding{197} & 198 & \ding{198} & 199 & \ding{199} \\ +200 & \ding{200} & 201 & \ding{201} & 202 & \ding{202} & 203 & \ding{203} & 204 & \ding{204} & 205 & \ding{205} & 206 & \ding{206} & 207 & \ding{207} \\ +208 & \ding{208} & 209 & \ding{209} & 210 & \ding{210} & 211 & \ding{211} & 212 & \ding{212} & 213 & \ding{213} & 214 & \ding{214} & 215 & \ding{215} \\ +216 & \ding{216} & 217 & \ding{217} & 218 & \ding{218} & 219 & \ding{219} & 220 & \ding{220} & 221 & \ding{221} & 222 & \ding{222} & 223 & \ding{223} \\ +224 & \ding{224} & 225 & \ding{225} & 226 & \ding{226} & 227 & \ding{227} & 228 & \ding{228} & 229 & \ding{229} & 230 & \ding{230} & 231 & \ding{231} \\ +232 & \ding{232} & 233 & \ding{233} & 234 & \ding{234} & 235 & \ding{235} & 236 & \ding{236} & 237 & \ding{237} & 238 & \ding{238} & 239 & \ding{239} \\ + & & 241 & \ding{241} & 242 & \ding{242} & 243 & \ding{243} & 244 & \ding{244} & 245 & \ding{245} & 246 & \ding{246} & 247 & \ding{247} \\ +248 & \ding{248} & 249 & \ding{249} & 250 & \ding{250} & 251 & \ding{251} & 252 & \ding{252} & 253 & \ding{253} & 254 & \ding{254} +\end{tabular}} +\end{table} + +\vspace*{\fill}\clearpage + +% Page 4 -- Changement de police sous LaTeX + +\vspace*{\fill} + +\begin{table}[H] +\centering +\caption{Liste non exhaustive des polices sous \LaTeX{}} +\label{annexes-code-police} +\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}lll} \toprule +\textbf{Police} & \textbf{Package} & \textbf{\verb??} \\ \midrule +Bookman & \verb?bookman? & \verb?pbk? \\ +Charter & \verb?charter? & \verb?bch? \\ +Computer Modern Roman & (défaut) & \verb?cmr? \\ +Computer Modern Sans Serif & (défaut) & \verb?cmss? \\ +Computer Modern Typewriter & (défaut) & \verb?cmtt? \\ +Courier & \verb?courier? & \verb?pcr? \\ +Fourier & \verb?fourier? & \verb?put? \\ +Garamond & \verb?ebgaramond? & \\ +& \verb?ebgaramond-maths? & \\ +Helvetica & \verb?helvet? & \verb?phv? \\ +Latin Modern Roman & \verb?lmodern? & \verb?lmr? \\ +Latin Modern Sans Serif & \verb?lmodern? & \verb?lmss? \\ +Latin Modern Typewriter & \verb?lmodern? & \verb?lmtt? \\ +New Century Schoolbook & \verb?newcent? & \\ +Palatino & \verb?mathpazo? & \\ +\TeX{} Gyre Bonum & \verb?tgbonum? & \verb?qbk? \\ +Times & \verb?mathptmx? & \verb?ptm? \\ +Zapf Chancery & \verb?chancery? & \\ \bottomrule +\end{tabular*} +\end{table} + +\vspace*{\fill}\clearpage + + +% Page 5 -- Symboles mathématiques courants + +\begin{table}[H] +\centering +\caption{Liste non exhaustive des symboles mathématiques disponibles sous \LaTeX{}} +\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}lll} \toprule +\textbf{Code} & \textbf{Rendu} & \textbf{Description} \\ \midrule +\verb?$i_2$? & $i_2$ & Indice \\ +\verb?$i^3$? & $i^3$ & Exposant \\ +\verb?$\frac{a}{b}$? & $\frac{a}{b}$ & Fraction \\ +\verb?$\cfrac{a}{b + \cfrac{c}{d}}$? & $\cfrac{a}{b + \cfrac{c}{d}}$ & Fraction (étages) \\ \\ + +\verb?$\times$? & $\times$ & Multiplication \\ +\verb?$\pm$? & $\pm$ & Plus ou moins \\ +\verb?$\leq$? et \verb?$\geq$? & $\leq$ et $\geq$ & Inégalités larges \\ +\verb?$\leqslant$? et \verb?$\geqslant$? & $\leqslant$ et $\geqslant$ & Inégalités larges (bis) \\ +\verb?$\equiv$? & $\equiv$ & Congruence \\ +\verb?$\neq$? & $\neq$ & Non égal \\ +\verb?$\simeq$? & $\simeq$ & Environ égal \\ +\verb?$\approx$? & $\approx$ & Environ égal (bis) \\ +\verb?$\sim$? & $\sim$ & \'Equivalence \\ \\ + +\verb?$\forall$? & $\forall$ & Pour tout élément \\ +\verb?$\exists$? & $\exists$ & Existence \\ +\verb?$\Rightarrow$? & $\Rightarrow$ & Implication \\ +\verb?$\infty$? & $\infty$ & Infini \\ +\verb?$\int$? & $\int$ & Intégrale simple \\ +\verb?$\iint$? & $\iint$ & Intégrale double \\ +\verb?$iiint$? & $\iiint$ & Intégrale triple \\ +\verb?$\oint$? & $\oint$ & Intégrale curviligne \\ +\verb?$\int_0^{+\infty} f(x)\,dx$? & $\int_0^{+\infty} f(x)\,dx$ & Intégration \\ +\verb?$\sum$? & $\sum$ & Somme \\ +\verb?$\partial$? & $\partial$ & Dérivée partielle \\ \bottomrule +\end{tabular*} +\end{table} + +\clearpage + + +% Page 6 -- Lettres grecques + +\vspace*{\fill} + +\begin{table}[H] +\caption{La liste complète des lettres grecques sous \LaTeX{}} +\begin{tabular}{*{8}l} +$\alpha$ & \verb?\alpha? & $\eta$ & \verb?\eta? & $\xi$ & \verb?\xi? & $\tau$ & \verb?\tau? \\ +$\beta$ & \verb?\beta? & $\theta$ & \verb?\theta? & $\pi$ & \verb?\pi? & $\upsilon$ & \verb?\upsilon? \\ +$\gamma$ & \verb?\gamma? & $\vartheta$ & \verb?\vartheta? & $\varpi$ & \verb?\varpi? & $\phi$ & \verb?\phi? \\ +$\delta$ & \verb?\delta? & $\kappa$ & \verb?\kappa? & $\rho$ & \verb?\rho? & $\varphi$ & \verb?\varphi? \\ +$\epsilon$ & \verb?\epsilon? & $\lambda$ & \verb?\lambda? & $\varrho$ & \verb?\varrho? & $\chi$ & \verb?\chi? \\ +$\varepsilon$ & \verb?\varepsilon? & $\mu$ & \verb?\mu? & $\sigma$ & \verb?\sigma? & $\psi$ & \verb?\psi? \\ +$\zeta$ & \verb?\zeta? & $\nu$ & \verb?\nu? & $\varsigma$ & \verb?\varsigma? & $\omega$ & \verb?\omega? \\ \\ +$\Gamma$ & \verb?\Gamma? & $\Lambda$ & \verb?\Lambda? & $\Sigma$ & \verb?\Sigma? & $\Psi$ & \verb?\Psi? \\ +$\Delta$ & \verb?\Delta? & $\Xi$ & \verb?\Xi? & $\Upsilon$ & \verb?\Upsilon? & $\Omega$ & \verb?\Omega? \\ +$\Theta$ & \verb?\Theta? & $\Pi$ & \verb?\Pi? & $\Phi$ & \verb?\Phi? +\end{tabular} +\end{table} + +\vspace*{\fill}\clearpage + + +% Page 7 -- TikZ & possibilités (commandes, options) + +\begin{table}[H] +\centering +\caption{Liste non exhaustive des commandes et options disponibles avec \TikZ{}} +% Passage à p (colonne 2) pour pouvoir utiliser \newline +\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}lp{\linewidth}} \toprule +\textbf{Commandes / Options} & \textbf{Description} \\ \midrule +\verb?--? & Pour tracer un trait droit \\ +\verb?|-? ou \verb?-|? & Pour tracer un trait vertical \newline puis horizontal (ou l'inverse) \\ +\verb?||? & \textbf{Indisponible !} \\ +\verb?rectangle? & \multirow{2}{*}{\parbox{\linewidth}{Choix de forme \newline (contour fermé)}} \\ +\verb?circle? & \\ +\verb?cycle? & Pour fermer un chemin \\ +\verb?plot? & Pour tracer une fonction (maths) \\ \\ + +\verb?\draw[] (A) -- (B);? & Tracer un trait entre \verb?A? et \verb?B? \\ +\verb?\fill[] (A) -- (B);? & Remplir la zone entre \verb?A? et \verb?B? \\ +\verb?\filldraw[] (A) -- (B);? & Tracer et remplir la zone entre \verb?A? et \verb?B? \\ +\verb?draw = ? & Définir la couleur du tracé \\ +\verb?fill = ? & Définir la couleur du remplissage \\ +\verb?line width = ? & Définir l'épaisseur du trait \\ +\verb?dotted? ou \verb?dashed? & Changer la forme du trait \\ +\verb?rounded corners? & \multirow{2}{*}{Changer les jointures} \\ +\verb?sharp corners? & \\ +\verb?line join = ? & Autres jointures \newline (\verb?round?, \verb?bevel? \& \verb?miter?) \\ +\verb?shift = {()}? & Décalage \\ +\verb?xshift = ? & Décalage horizontal \\ +\verb?yshift = ? & Décalage vertical \\ \\ + +\verb?\path[] (A) -- (B);? & Définir un chemin entre \verb?A? et \verb?B? \\ +\verb?\coordinate () at ();? & Définir une coordonnée \verb?? \newline au point \verb?()? \\ + +\verb?node? & cf. \autoref{annexes-tikz-node} \\ \bottomrule +\end{tabular*} +\end{table} + +\clearpage + + +% Page 8 -- TikZ & possibilités (node) + +\begin{table}[H] +\caption{Liste non exhaustive des options disponibles avec \TikZ{} (\texttt{node})} +\label{annexes-tikz-node} + +\begin{code}{} +\node[] () at () {}; +\end{code} + +\begin{quote} +Placer \verb?? à l'emplacement \verb?()? (autre \verb?node? ou coordonnées) et lui attribuer le nom \verb?? (optionnel) +\end{quote} + +\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}lp{\linewidth}} \toprule +\textbf{Options} & \textbf{Description} \\ \midrule +\verb?draw = ? & Afficher le contour du \verb?node? \\ +\verb?fill = ? & Remplir l'intérieur du \verb?node? \\ +\verb?text = ? & Colorer le texte à l'intérieur du \verb?node? \\ +\verb?font = ? & Mettre en forme le texte du \verb?node? \newline (\verb?\bfseries?, \verb?itshape?, \verb?\small?, etc.) \\ +\verb?align = ? & Alignement horizontal du texte \newline à l'intérieur du \verb?node? \newline (\verb?left?, \verb?center? ou \verb?right?) \\ \\ + +\verb?inner sep = ? & Espacement entre le texte et \newline le bord du \verb?node? \\ +\verb?outer sep = ? & Espacement entre le bord du \verb?node? \newline et les autres éléments \\ \\ + +\verb?text width = ? & Largeur du bloc de texte du \verb?node? \\ +\verb?minimum width = ? & Largeur minimale du \verb?node? \\ +\verb?minimum height = ? & Hauteur minimale du \verb?node? \\ \\ + +\verb?? & Indiquer la position du \verb?node? \newline par rapport à \verb?()? \newline (\verb?above?, \verb?below?, \verb?left? ou \verb?right?) \\ +\verb?anchor = ? & Indiquer le point d'ancrage de \verb?()? \\ +\verb?rotate = ? & Faire pivoter le \verb?node? \\ \bottomrule +\end{tabular*} +\end{table} + +Autres solutions de positionnement : cf. la bibliothèque \verb?positioning?. + +\clearpage + + +% Page 9 -- TikZ & librairies + +% Longtable incompatible avec table +% Table nécessaire pour caption +\begin{table}[H] +\caption{Liste des librairies disponibles avec \TikZ{}} +\label{annexes-tikz-bibliotheques} + +\begin{code}{} +\usetikzlibrary{} +\end{code} +\end{table} + +\begin{tableaubilan}{0.45\linewidth}{0.45\linewidth}{Bibliothèque \TikZ{}}{Description} +\verb?3d? & Dessiner des formes en 3D \\ +\verb?angles? & Dessiner des angles \\ +\verb?animations? & Créer des animations \\ +\verb?arrows.meta? & Obtenir plus de flèches et pouvoir en créer \\ +\verb?automata? & Dessiner des automates finis (diagrammes d'état) et des machines de Turing \\ +\verb?babel? & Interagir avec le package éponyme et éviter les conflits \\ +\verb?backgrounds? & Créer des arrières-plans colorés et afficher un quadrillage \\ +\verb?bending? & Courber les flèches \\ +\verb?calc? & Calculer des coordonnées \\ +\verb?calendar? & Créer des calendriers \\ +\verb?chains? & Créer des chaînes \\ +\verb?circuits? & \multirow{7}{*}{\parbox{\linewidth}{Dessiner des circuits électriques (package \verb?circuitikz? si besoin)}} \\ +\verb?circuits.ee? \\ +\verb?circuits.logic? \\ +\verb?circuits.logic.CDH? \\ +\verb?circuits.logic.IEC? \\ +\verb?circuits.logic.US? \\ +\verb?circuit.ee.IEC? \\ +\verb?circular? & Créer des dessins algorithmiques circulaires \\ +\verb?curvilinear? & Dessiner des transformations non linéaires (comme des courbes de Bézier) \\ +\verb?datavisualization? & \multirow{3}{*}{\parbox{\linewidth}{Définir les styles nécessaires à la visualisation de données}} \\ +\verb?datavisualization.formats.functions? \\ +\verb?datavisualization.polar? \\ +\verb?decorations? & \multirow{8}{*}{\parbox{\linewidth}{Appliquer des transformations à des chemins (\verb?path?) et les décorer}} \\ +\verb?decorations.footprints? \\ +\verb?decorations.fractals? \\ +\verb?decorations.markings? \\ +\verb?decorations.pathmorphing? \\ +\verb?decorations.pathreplacing? \\ +\verb?decorations.shapes? \\ +\verb?decorations.text? \\ +\verb?er? (\textit{entity-relationship}) & Dessiner des diagrammes entité-association \\ +\verb?external? & Exporter des dessins \TikZ{} \\ +\verb?fadings? & Estomper les couleurs \\ +\verb?fit? & Créer un \verb?node? qui contient un jeu de coordonnées \\ +\verb?fixedpointarithmetic? & Augmenter la limite de calcul de \TikZ{} (package \verb?fp? obligatoire, temps de calcul plus longs) \\ +\verb?folding? & Créer des patrons ou des objets à plier \\ +\verb?force? & Dessiner avec des ``efforts'' (\verb?node? tirés ou comprimés) \\ +\verb?fpu? (\textit{floating point unit}) & Permettre le calcul scientifique avec des nombres réels \\ +\verb?graphdrawing? (Lua\LaTeX{}) & Automatiser le dessin de graphes \\ +\verb?graphs? et \verb?graphs.standard? & Dessiner des graphes avec la commande \verb?graph? \\ +\verb?intersections? & Calculer la (les) intersection(s) de 2 chemins \\ +\verb?layered? & Tracer des graphes avec des couches horizontales \\ +\verb?lindenmayersystems? & Créer des ``\textit{L-systems}'' \\ +\verb?math? & Définir des fonctions mathématiques et exécuter des opérations mathématiques \\ +\verb?matrix? & Définir des options et styles supplémentaires pour les matrices de \verb?node? \\ +\verb?mindmap? & Créer des cartes heuristiques \\ +\verb?patterns? & Définir de nouveaux motifs de remplissage \\ +\verb?perspective? & Dessiner des objets en perspective avec 1, 2 ou 3 points de fuite \\ +\verb?petri? & Dessiner des réseaux de Petri \\ +\verb?phylogenetics? & Tracer des arbres phylogénétiques \\ +\verb?plothandlers? & Définir des \og \textit{plot handlers} \fg{} supplémentaires \\ +\verb?plotmarks? & Définir des marqueurs (sommets d'un tracé) \\ +\verb?positioning? & Définir des options supplémentaires pour placer les \verb?node? \\ +\verb?profiler? & Simplifier l'optimisation de la compilation \\ +\verb?quotes? & Placer des commentaires facilement à côté d'un \verb?node? \\ +\verb?rdf? (\textit{resource description framework}) & Ajouter des ``annotations'' à un fichier généré par \TikZ{} \\ +\verb?routing? & Connecter les extrémités d'un graphe \\ +\verb?scopes? & Simplifier l'appel de l'environnement \verb?scope? \\ +\verb?shadings? & Créer des dégradés de couleurs \\ +\verb?shadows? & Créer des ombrages \\ +\verb?shapes.arrows? & \multirow{11}{*}{\parbox{\linewidth}{Définir de nouveaux formats de \verb?node? et plus encore}} \\ +\verb?shapes.callout? \\ +\verb?shapes.gates.ee? \\ +\verb?shapes.gates.ee.IEC? \\ +\verb?shapes.gates.logic? \\ +\verb?shapes.gates.logic.IEC? \\ +\verb?shapes.gates.logic.US? \\ +\verb?shapes.geometric? \\ +\verb?shapes.misc? \\ +\verb?shapes.multipart? \\ +\verb?shapes.symbols? \\ +\verb?spy? & Faire des grossissements \\ +\verb?svg.path? & Définir des chemins avec la syntaxe \verb?SVG? \\ +\verb?through? & Créer des formes qui passent par un point précis \\ +\verb?topaths? (chargé automatiquement) & Définir l'opérateur \verb?to? \\ +\verb?trees? & Dessiner des arbres \\ +\verb?turtle? & Créer des ``\textit{turtle graphics}'' (langage \verb?Logo?) \\ +\verb?views? & Créer des ``vues'' (transformations d'une partie d'un dessin) +\end{tableaubilan} + +\clearpage \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/code-base.tex b/info/guide-latex-fr/Chapitres/code-base.tex new file mode 100644 index 0000000000..aac7623de4 --- /dev/null +++ b/info/guide-latex-fr/Chapitres/code-base.tex @@ -0,0 +1,18 @@ +Par la suite, pour alléger les exemples, le préambule ne sera plus renseigné dans les codes \LaTeX{} mis à disposition. Ces derniers seront basés sur l'architecture du code minimal fourni ci-après. L'ajout de nouveaux packages sera signalé au début du code par un commentaire. + +\begin{code}{Le code minimal} +\documentclass[a4paper, 12pt]{report} + +% PDFLaTeX +\usepackage{lmodern} +\usepackage[french]{babel} +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} + + +\begin{document} + +% Ecrire le code ici ! + +\end{document} +\end{code} \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/commandes.tex b/info/guide-latex-fr/Chapitres/commandes.tex new file mode 100644 index 0000000000..ec62918fe5 --- /dev/null +++ b/info/guide-latex-fr/Chapitres/commandes.tex @@ -0,0 +1,139 @@ +% Commandes créées + +% Page de garde et mind map +\definecolor{BlueFR}{RGB}{0,35,149} +\definecolor{RedFR}{RGB}{237,41,57} +\definecolor{NewOrange}{RGB}{247,111,43} +\definecolor{Gold}{RGB}{255,215,0} + +% Aperçu Texmaker (Aide_LaTeX1.png) -- Hred = Red - Hyellow = Gold +\definecolor{Horange}{RGB}{255,156,0} +\definecolor{Hgreen}{RGB}{0,167,0} +\definecolor{Hblue}{RGB}{0,234,255} +\definecolor{Hpurple}{RGB}{169,15,219} + +% Signature +\definecolor{lightningcyan}{RGB}{59,195,235} + + +% Raccourcis +\newcommand{\Windows}{\texttt{Windows}} +\newcommand{\Linux}{\texttt{Linux}} +\newcommand{\Apple}{\texttt{Apple}} +\newcommand{\LinkedIn}{\texttt{LinkedIn}} +\newcommand{\MiKTeX}{\texttt{MiKTeX}} +\newcommand{\Texmaker}{\texttt{Texmaker}} +\newcommand{\TikZ}{Ti\textit{k}Z} +\newcommand{\Beamer}{\texttt{Beamer}} +\newcommand{\Paint}{\texttt{Paint}} +\newcommand{\GIMP}{\texttt{GIMP}} +\newcommand{\Inkscape}{\texttt{Inkscape}} + +\newcommand{\folder}{\textcolor[RGB]{255,231,157}{\faFolder}} + + +% Tableau bilan +\newenvironment{tableaubilan}[4]{ + \begin{longtable}{p{#1}p{#2}} + % Définition des headers & footers du longtable + {\hspace*{\fill}\textsc{#3}\hspace*{\fill}} & {\hspace*{\fill}\textsc{#4}\hspace*{\fill}} \\ \midrule + \endhead + \multicolumn{2}{r}{\textit{(suite sur la page suivante)}} \\ + \endfoot + \multicolumn{2}{@{\hrulefill}c@{\hrulefill}}{\raisebox{-3pt}{~~\textsc{Fin du tableau}~~}} + \endlastfoot +}{\end{longtable}} + + +% "Boîtes" -- Package tcolorbox +% Boîtes types +\newtcolorbox{boitetype}[4][]{enhanced, breakable, before upper = {\parindent17.6pt}, beforeafter skip = \baselineskip, colframe = #3, colback = #4, boxrule = 2pt, arc = 4mm, fonttitle = \bfseries, title = {#2}, coltitle = black, #1} % before upper = alinéa dans boîte + +\newtcolorbox{boitecointype}[7][]{% +cornerrulewidth/.store in = {\tcbcornerrulewidth}, +cornerrulewidth = #7, +topcornercolor/.store in = {\tcbtopcornercolor}, +topcornercolor = #3, +bottomcornercolor/.store in = {\tcbbottomcornercolor}, +bottomcornercolor = #4, +enhanced, breakable, before upper = {\parindent17.6pt}, beforeafter skip = \baselineskip, sharp corners, boxrule = 0pt, colback = #5, title = {#2}, fonttitle = \bfseries, coltitle = black, colbacktitle = #6, underlay unbroken = { + \draw[\tcbtopcornercolor, line width = \tcbcornerrulewidth] ([xshift = -\tcbcornerrulewidth/2]frame.west) -- ([shift = {(-\tcbcornerrulewidth/2,\tcbcornerrulewidth/2)}]frame.north west) -- ([yshift = \tcbcornerrulewidth/2]frame.north); + \draw[\tcbtopcornercolor, line width = \tcbcornerrulewidth] ([xshift = \tcbcornerrulewidth/2]frame.east) -- ([shift = {(\tcbcornerrulewidth/2,-\tcbcornerrulewidth/2)}]frame.south east) -- ([yshift = -\tcbcornerrulewidth/2]frame.south); +}, underlay first = { + \draw[\tcbtopcornercolor, line width = \tcbcornerrulewidth] ([xshift = -\tcbcornerrulewidth/2]frame.west) -- ([shift = {(-\tcbcornerrulewidth/2,\tcbcornerrulewidth/2)}]frame.north west) -- ([yshift = \tcbcornerrulewidth/2]frame.north); +}, underlay last = { + \draw[\tcbtopcornercolor, line width = \tcbcornerrulewidth] ([xshift = \tcbcornerrulewidth/2]frame.east) -- ([shift = {(\tcbcornerrulewidth/2,-\tcbcornerrulewidth/2)}]frame.south east) -- ([yshift = -\tcbcornerrulewidth/2]frame.south); +}, #1} + + +% Construction des autres boîtes en fonction d'une boîte type +\newenvironment{boite}[3][]{\begin{boitetype}[#1]{#2}{#3}{white}}{\end{boitetype}} +\newenvironment{boitecoin}[3][]{\begin{boitecointype}[#1]{#2}{#3}{#3}{#3!5!white}{#3!50}{2pt}}{\end{boitecointype}} + +\newenvironment{regles}[2][]{\begin{boitetype}[sharp corners, boxrule = 3pt, coltitle = white, #1]{#2}{BrickRed}{Goldenrod}}{\end{boitetype}} +\newenvironment{definition}[2][]{\begin{boitecoin}[#1]{#2}{Green}}{\end{boitecoin}} +\newenvironment{conseil}[2][]{\begin{boitetype}[#1]{#2}{cyan}{cyan!40}}{\end{boitetype}} +\newenvironment{attention}[2][]{\begin{boitetype}[left = 6mm, coltitle = white, sharp corners = west, underlay = {% + \path[fill = yellow!50!black] (frame.south west) rectangle node[white] {\huge\bfseries{}!} ([xshift = 4mm]frame.north west); +}, drop fuzzy shadow, #1]{#2}{yellow!20!black}{yellow!50}}{\end{boitetype}} % Nouvelle boîte "attention" -- Inspiration : boîte "marker" (code source guide tcolorbox) + + +%%% --- Explications --- %%% + +% Ne fonctionne pas : \newenvironment{code}[2][]{\begin{boitecodetype}[#1]{#2}{LimeGreen}{LimeGreen!5!white}{LimeGreen!50}{2pt}{TeX}}{\end{boitecodetype}} + +% Boite type avec listings impossible --> problème lors de l'appel du nouvel environnement +% (en gros, avec une couche supplémentaire \newenvironment, listings n'arrive pas à bien détecter le début et la fin de l'environnement donc erreur) + +% Solution : +% Utilisation de styles (commandes propres à tcolorbox & listings) pour recenser les options à utiliser +% Création ensuite de 3 environnements (distincts et non imbriqués) mais avec appel de ces commandes +% ==> gain de lignes et généralisation possible + +%%% --- FIN Explications --- %%% + +% Stockage de 2 variables principales (plus propre) +% Autre solution : utiliser le code source tcolorbox (tcbcol@frame : couleur définie par colback) +% Attention : breakable non appliqué si "listing side text" (pas de coupure) +% ==> faire des "petits" bouts de code +\tcbset{ +codemainoptions/.style = { + maincolor/.store in = {\tcbmaincol}, + maincolor = LimeGreen, + rulewidth/.store in = {\tcbrulewidth}, + rulewidth = 2pt, + enhanced, breakable, beforeafter skip = \baselineskip, sharp corners, boxrule = \tcbrulewidth, colframe = \tcbmaincol, colback = \tcbmaincol!15, drop fuzzy shadow, colbacktitle = \tcbmaincol!50, coltitle = black, fonttitle = \bfseries, title = {#1}, + attach boxed title to top center = {yshift = -\tcbrulewidth/2-\tcboxedtitleheight/2, yshifttext = -\tcboxedtitleheight/2}, boxed title style = {boxrule = \tcbrulewidth, frame code = { + \path[tcb fill frame] ([xshift = -3mm]frame.west) -- (frame.north west) -- (frame.north east) -- ([xshift = 3mm]frame.east) -- (frame.south east) -- (frame.south west) -- cycle;}, interior code = { + \path[tcb fill interior] ([xshift = -2mm]interior.west) -- (interior.north west) -- (interior.north east) -- ([xshift = 2mm]interior.east) -- (interior.south east) -- (interior.south west) -- cycle;}} +} +} + +\lstdefinestyle{mainlststyle}{ +language = {[LaTeX]TeX}, +style = tcblatex, +texcsstyle = *\color{cyan!65!black}, +commentstyle = \color{gray}, +tabsize = 4, +keepspaces = true, +breaklines = true, +breakatwhitespace = false, +inputencoding = utf8, +numbers = none, +showspaces = false, +showtabs = false, +showstringspaces = false +} + +% N.B. : #2 = titre de la boite +\newtcblisting{code}[2][]{codemainoptions = {#2}, listing options = {style = mainlststyle}, listing only, #1} + +\newtcblisting{codedisplay}[2][]{codemainoptions = {#2}, listing options = {style = mainlststyle}, listing side text, righthand ratio = 0.4, sidebyside gap = 13mm, bicolor, colbacklower = white, #1} + +% compilable listing ==> compiler "main.tex" avec "-shell-escape" +\newtcblisting{coderesult}[2][]{codemainoptions = {#2}, listing options = {style = mainlststyle}, listing and comment, bicolor, colbacklower = white, compilable listing, run pdflatex, pdf comment, freeze pdf, comment style = {raster columns = 2, drop lifted shadow}, #1} + +% Boîte spéciale code TikZ +% 1ère idée : nouvelle boîte brute avec listing and comment (comment = {\resizebox{\linewidth}{!}{\tcbuselistingtext}} -- \tcbuse... = contenu de la boîte soit code TikZ) +% 2nde idée : se contenter d'un "listing and text" avec structure boîte "codedisplay" +\newtcblisting{codetikz}[2][]{codemainoptions = {#2}, listing options = {style = mainlststyle}, listing and text, bicolor, colbacklower = white, #1} \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/intro.tex b/info/guide-latex-fr/Chapitres/intro.tex new file mode 100644 index 0000000000..94ba55555e --- /dev/null +++ b/info/guide-latex-fr/Chapitres/intro.tex @@ -0,0 +1,162 @@ +% Licence Creative Commons +\vspace*{\stretch{1}} + +\begin{center} +\begin{tikzpicture} +% Paramétrage +\def\poly{13} +\pgfmathtruncatemacro\polyg{\poly - 1} +\def\R{0.43\linewidth} +\def\ornament{87} +\def\ecart{13pt} + +% Tracé du polygone avec des "fioritures" +\draw[NewOrange] (90:\R) node[shift = (90:\ecart)] {\poly} \foreach \i in {1,...,\polyg} {to[ornament = \ornament] (90-\i*360/\poly:\R) node[shift = (90-\i*360/\poly:\ecart)] {\i}} to[ornament = \ornament] cycle; % Usage de \polyg pour bien fermer avec un cycle + +% Image au centre - Décalage possible (ajuster à la main) +\node[text width = 0.55\linewidth, align = left] at (0,0) {\vspace{\baselineskip} + +Cette \oe{}uvre, création, site ou texte est sous licence Creative Commons Attribution - Pas d'Utilisation Commerciale - Pas de Modification 4.0 International. \\[\baselineskip] + +Pour accéder à une copie de cette licence, merci de vous rendre à l'adresse suivante \url{http://creativecommons.org/licenses/by-nc-nd/4.0/} ou d'envoyer un courrier à : \\[\baselineskip] + +\begin{center} Creative Commons \\ +444 Castro Street, Suite 900 \\ +Mountain View, California, 94041 \\ +USA \end{center} +}; +\end{tikzpicture} +\end{center} + +\begin{figure}[H] +\centering +\includegraphics[width = 0.7\linewidth]{licence.eps} +\end{figure} + +\vspace*{\stretch{1}} + +\begin{Large} +\color{red}\textbf{Toutes les versions de ce guide sont soumises à cette licence Creative Commons, y compris les plus anciennes qui peuvent circuler et qui n'y font pas explicitement mention.} +\end{Large} + +\vspace*{\stretch{1}} + +\newpage + +% Mind Map +\vspace*{\stretch{1}} + +\resizebox{\linewidth}{!}{% +\begin{tikzpicture}[mindmap, grow cyclic, every node/.style = {concept, align = center}, concept color = gray!75, level 1/.append style = {level distance = 5cm, sibling angle = 72}, level 2/.append style = {level distance = 3cm, sibling angle = 72}] +\node{\huge\textbf{\LaTeX{}}} + child [concept color = violet!50] { node {Texte \\ (\pageref{chap-texte} \& \pageref{chap-texte-details})} + child { node {Mise en forme}} + child { node {Organiser}} + child { node {Page de garde}} + child { node {Sommaire}} + child { node {En-têtes et pieds}} + } + child [concept color = orange!50] { node {Tableaux \\ (\pageref{chap-table} \& \pageref{chap-table-details})} + child { node {Tableaux}} + child { node {Boîtes}} + child { node {\texttt{tcolorbox}}} + } + child [concept color = brown!50] { node {Dessiner \\ (\pageref{chap-pstricks} \& \pageref{chap-tikz})} + child { node {PSTricks}} + child { node {\TikZ{}}} + } + child [concept color = green!80!black] { node {Maths \\ (\pageref{chap-maths} \& \pageref{chap-maths-details})} + child { node {Formules}} + child { node {Ali\-gne\-ment}} % Pour indiquer à LaTeX où faire la césure -- Sinon, c'est moche + child { node {Déli\-mi\-teurs}} % Idem + child { node {Matrices}} + } + child [concept color = yellow!70!red] { node {Images \\ (\pageref{chap-img} \& \pageref{chap-img-details})} + child { node {Formats}} + child { node {Insertion}} + child { node {Montage}} + }; +\end{tikzpicture} +} + +\vspace*{\stretch{1}} + +\newpage + +% Sommaire +{ +\hypersetup{hidelinks} % Sommaire en "noir" +\renewcommand{\contentsname}{Sommaire} +\tableofcontents % Penser à compiler deux fois +} + +\clearpage % Mieux qu'un \newpage ou des erreurs dans le sommaire sinon + +\chapter*{Préambule} + +\phantomsection % Lien hyperref cohérent +\addcontentsline{toc}{part}{Préambule} % Ajout table des matières + +\lettrine{C}{e} guide a tout d'abord été construit pour mon usage personnel afin de regrouper toutes mes connaissances en \LaTeX{}. Il sert aussi à mes camarades de promotion qui désirent se mettre à \LaTeX{}. + +Accessoirement, dans l'éventualité où un parfait inconnu viendrait à lire ce guide, j'espère qu'il pourra l'aider à son tour dans son initiation à \LaTeX{}. \\ + +D'autre part, mes connaissances en \LaTeX{} restent limitées. Je n'ai pas la science infuse et ce guide est loin d'être exhaustif. \textbf{Je propose juste des solutions qui fonctionnent.} N'hésite donc pas à aller te documenter ailleurs si un point ne te semble pas clair ou si tu cherches d'autres informations. + +S'ils ne sont pas légion, il existe d'autres guides en français pour apprendre le \LaTeX{}. Pour ma part, je recommande l'excellent \textit{\LaTeX{}\dots{} pour le prof de maths !} d'Arnaud \textsc{Gazagnes}\footnote{Disponible sur : \url{http://math.univ-lyon1.fr/irem/spip.php?article340}.}, très complet et bien expliqué. Je suis aussi tombé plus récemment sur \textit{Rédaction avec \LaTeX{}} de Vincent \textsc{Goulet}\footnote{Disponible sur : \url{https://ctan.org/pkg/formation-latex-ul}.}, très agréable à lire et bien détaillé lui aussi. \\ + +Et si jamais tu désires retrouver mon guide à jour ainsi que les fichiers d'aide que j'ai récoltés, ils sont disponibles à l'adresse suivante : \begin{center} \url{http://drive.google.com/drive/folders/0BzU2BdcGjfU5Tk1XaXhxbk5JcEE?usp=sharing} \end{center} + +N'hésite pas à laisser des commentaires ou à signaler des fautes dans le GForm mis à disposition. Sur ce, bonne lecture ! \\ + +\begin{flushright} +Adrien \textsc{Bouzigues} \\ +I13 Cl215 +\end{flushright} + +\newpage + +% QR Code - Dessin final +\vspace*{\fill} + +\begin{figure}[H] +\centering +\qrcode[height = 0.45\linewidth]{http://drive.google.com/drive/folders/0BzU2BdcGjfU5Tk1XaXhxbk5JcEE?usp=sharing} +\caption*{\large\textcolor{BrickRed}{Lien de mon \texttt{Drive} \LaTeX{}\dots{} sous la forme d'un code QR !}} +\end{figure} + +\vspace*{\fill} + +\begin{center} +\begin{tikzpicture} +% Symbole au centre +\tikzset{pgfornamentstyle/.style = {fill opacity = 0.5, line width = 1.3pt}} +\node[anchor = east] at (\linewidth,-0.17\linewidth) +{\pgfornament[width = 0.2\linewidth, color = Green]{24}}; + +% Texte arrondi +\draw[White, postaction = {decorate}, decoration = {text along path, text = {|\fontsize{35pt}{15pt}\selectfont\color{Gold!90!black}\scshape|TikZ Seal Of Quality}, text align = center}] +(0.5\linewidth,0) arc [start angle = -180, end angle = 0, radius = 0.4\linewidth]; +\end{tikzpicture} +\end{center} + +\vspace*{\fill} + +\newpage + +\vspace*{0.1\paperheight} + +% Dédicace +\begin{flushright} +\itshape{}\^O Capitaine ! Mon Capitaine ! + +Pendant chaque traversée, + +Tu restes à mes côtés + +Et soutiens mon avancée. +\end{flushright} + +\hfill \hrulefill + +\newpage \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p1-compilation.tex b/info/guide-latex-fr/Chapitres/p1-compilation.tex new file mode 100644 index 0000000000..4ea43fef9a --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p1-compilation.tex @@ -0,0 +1,160 @@ +\chapter{Compiler avec \LaTeX{}} + +\label{compilation_intro}\lettrine{P}{our} faire du \LaTeX{}, il faut déjà connaître le point suivant : \LaTeX{} est un langage et un système de composition de documents. Généralement, en informatique, un langage requiert une étape obligatoire : la compilation. Et \LaTeX{} n'échappe pas à cette règle. + +\section{Principe de la compilation} + +Quand tu vas rédiger un document sous \LaTeX{}, tu vas devoir procéder en 3 temps : + +\begin{figure}[H] +\centering +\resizebox{0.95\linewidth}{!}{\input{./Images/compilation_schema}} +\caption{Les 3 étapes pour rédiger un document sous \LaTeX{}} +\end{figure} + +Pour entrer un peu plus dans les détails, tu dois donc : \begin{enumerate} +\item écrire ton document en \LaTeX{} (respect de ses conventions et utilisation de commandes spécifiques) ; + +\item demander à un moteur \LaTeX{} de transformer ton document et ses commandes en un fichier lisible et utilisable : c'est la compilation ; + +\item profiter du résultat fourni (format PDF) ou l'évaluer pour ensuite apporter des modifications au document, et ainsi de suite. \\ +\end{enumerate} + +Quant au moteur \LaTeX{} utilisé, il en existe plusieurs. Pour débuter, je recommande d'utiliser plutôt pdf\TeX{} (intitulé apparemment PDF\LaTeX{} sous \Texmaker{}), qui permet de passer d'un coup du document \LaTeX{} au fichier PDF final. + +Quant aux autres moteurs, je les aborde bien plus loin dans ce guide, en page \pageref{compilation-details}. Je recommande plutôt de t'y rendre une fois que tu as un peu d'expérience sous \LaTeX{}, pour ne pas perdre du temps et acquérir des bases solides. \\ + +Nous savons désormais que nous devons compiler avec le moteur pdf\TeX{}\dots{} mais nous ne savons toujours pas comment faire ! Pas de panique : les logiciels que je t'ai fait installer prennent tout en charge. + +\section{Démarrer avec \Texmaker{}} + +Pour gérer et éditer ses fichiers \LaTeX{}, \Texmaker{} est un excellent logiciel. Et je sais de quoi je parle car, avant de m'y mettre, j'utilisais un autre logiciel, tellement exécrable que j'ai fini par oublier son nom. Aujourd'hui, je ne fais rien sans \Texmaker{}. Voyons un aperçu de ce dernier : + +\begin{figure}[H] +\includegraphics[width = \linewidth]{Aide_LaTeX1.png} +\caption{Aperçu de \Texmaker{}} +\end{figure} + +Revenons sur chaque point : + +\begin{itemize}[label = \ding{213}] +\item \textcolor{red}{barre de menus et d'outils :} plein de commandes \LaTeX{} préremplies. Personnellement, je l'utilise très rarement (y compris le bouton de sauvegarde). Je préfère utiliser les raccourcis clavier (en l'occurrence, \keys{\ctrl + S}) ; + +\item \textcolor{Horange}{structure du document :} très pratique pour naviguer dans le code du document ouvert ; + +\item \textcolor{Hgreen}{raccourcis de commandes :} encore des commandes. Il peut être intéressant d'y jeter un coup d'{\oe}il une fois ce guide bien avancé. Il y a principalement des commandes pour les formules mathématiques et quelques unes pour la mise en forme du texte ; + +\item \textcolor{Gold}{code \LaTeX{} :} c'est ici que tu tapes le texte de ton document et les commandes \LaTeX{} nécessaires pour le mettre en forme ; + +\item \textcolor{Hpurple}{informations du compilateur :} le résultat lors de la génération du PDF. Très utile, s'il y a des erreurs, pour pouvoir se corriger ; + +\item \textcolor{Hblue}{aperçu du PDF :} une fenêtre avec l'aperçu du fichier PDF généré. \\ +\end{itemize} + +Si jamais cet aperçu n'est pas disponible (fenêtre d'affichage inexistante comme sur mon image), il faut procéder de la manière suivante : \begin{enumerate} +\item Aller dans \verb?Options? puis dans \verb?Configurer Texmaker?. + +\item Dans l'onglet \verb?Afficheur Pdf?, choisir les options \verb?Afficheur Pdf interne? et \verb?Intégré à la fenêtre?. Valider. + +\item Un bouton \verb?Pdf Viewer? est alors disponible en bas à gauche et te permet d'activer ou non cette fenêtre d'aperçu. +\end{enumerate} + +Si jamais ce n'est pas clair, j'espère que cette capture d'écran permettra de lever le moindre doute : + +\begin{figure}[H] +\includegraphics[width = \linewidth]{apercu_pdf.png} +\caption{Procédure pour obtenir l'aperçu du PDF} +\end{figure} + +\begin{conseil}{L'aide en ligne} +Si jamais tu as d'autres questions sur \Texmaker{}, son site officiel (\url{http://www.xm1math.net/texmaker/index_fr.html}) est le meilleur endroit pour avoir des réponses et fournit aussi un tutoriel pour débuter avec \LaTeX{}. + +Si certains points de ce guide te semblent obscures, tu peux donc t'y rendre, ainsi que sur \url{http://fr.wikibooks.org/wiki/LaTeX}. \\ + +N'hésite pas quand tu débutes. Les deux sites sont en français et répondent à beaucoup de questions assez facilement (\textit{i.e.} avec un code simple). +\end{conseil} + +\section{Compiler avec \Texmaker{}} + +Maintenant que l'environnement propre à \Texmaker{} a été présenté, voyons un peu plus dans le détail un dernier point : la compilation. Pour commencer, reprenons le code \og Bonjour monde ! \fg{} utilisé en page \pageref{hello-world} : + +\begin{code}{Bonjour monde !} +\documentclass[]{report} + + +\begin{document} + +Bonjour monde ! + +\end{document} +\end{code} + +Je suppose que tu as suivi les premières indications fournies, soit ouvrir \Texmaker{}, recopier le code \og Bonjour monde ! \fg{} donné et enregistrer ton document. + +Si tu n'as pas précisé d'extension, tu remarqueras au passage que ton fichier a été sauvegardé avec l'extension \verb?.tex?, qui correspond à l'extension pour des fichiers \LaTeX{}. \\ + +Il existe ensuite 3 façons de lancer la compilation de ton document \LaTeX{} : \begin{itemize}[label = \ding{213}] +\item via l'invite de commandes de ton système d'exploitation (le CMD pour les utilisateurs de \Windows{})\dots{} mais je n'en parlerai pas pendant ce guide. + +Sache cependant que c'est possible mais ne présente aucun intérêt comme \Texmaker{} propose des solutions plus pratiques ; + +\item via \Texmaker{} avec des clics souris ; + +\item via \Texmaker{} avec des raccourcis clavier (le plus rapide à mon sens). +\end{itemize} + +Revenons sur les 2 derniers points plus dans le détail, pour que tu comprennes bien les actions à effectuer. \\ + +Pour une compilation via \Texmaker{} avec des clics souris, il faut procéder en 3 temps (cf. \figurename{} \ref{compilation_clics} si besoin) : \begin{enumerate} +\item Choisir le moteur de compilation, PDF\LaTeX{} dans notre cas, en haut dans la barre d'outils. + +\item Lancer la compilation en cliquant sur la flèche à gauche du choix du moteur de compilation. Attendre que la compilation soit terminée. + +\item Juste à droite du choix du moteur de compilation, bien choisir l'option \verb?Voir PDF? et cliquer sur la flèche associée pour afficher le résultat. +\end{enumerate} + +\begin{figure}[H] +\centering +\includegraphics[width = 0.85\linewidth]{compilation_clics.png} +\caption{Lancer la compilation avec des clics souris (\Texmaker{})} +\label{compilation_clics} +\end{figure} + +Pour une compilation via \Texmaker{} avec des raccourcis clavier, il faut procéder en 2 temps (cf. \figurename{} \ref{compilation_clavier} si besoin) : \begin{enumerate} +\item Lancer la compilation avec le moteur PDF\LaTeX{} avec la touche \keys{F6}. + +\item Afficher le résultat avec la touche \keys{F7}. +\end{enumerate} + +Ces raccourcis sont personnalisables dans les options de \Texmaker{}, comme décrit ci-après (\figurename{} \ref{compilation_clavier}). + +\begin{figure}[H] +\centering +\includegraphics[width = 0.85\linewidth]{compilation_clavier.png} +\caption{Configuration des raccourcis clavier pour lancer la compilation (\Texmaker{})} +\label{compilation_clavier} +\end{figure} + +Mais il y a encore plus rapide : lancer la compilation ET avoir l'aperçu du PDF actualisé en un seul raccourci clavier. C'est ce que \Texmaker{} appelle la \og compilation rapide \fg{}\footnote{Il s'agit du nom attribué par le concepteur de \Texmaker{}. Le temps nécessaire pour compiler le document n'est en rien diminué.}. + +Tout d'abord, il faut s'assurer que la compilation rapide est bien programmée. Pour ce faire, il faut configurer \Texmaker{} de la manière suivante : + +\begin{figure}[H] +\centering +\includegraphics[width = 0.85\linewidth]{compilation_rapide.png} +\caption{Configuration de la compilation rapide (\Texmaker{})} +\end{figure} + +Ensuite, il suffit d'appuyer sur la touche \keys{F1} pour lancer la compilation rapide. Il s'agit de la touche par défaut, paramétrable dans les options \Texmaker{} comme indiqué en \figurename{} \ref{compilation_clavier}. \\ + +Enfin, pour terminer les explications, il faut savoir que les compilations réalisées sous \Texmaker{} sont équivalentes à l'utilisation de l'invite de commandes. Grâce à \Texmaker{}, cette utilisation est transparente et grandement simplifiée\dots{} pour les non-initiés nous dirons ! + +\begin{attention}{La compilation : le conseil personnel} +Peu importe le moteur utilisé pour la compilation, tu peux remarquer qu'un fichier \verb?.tex? entraîne toujours la génération d'autres fichiers. \textbf{\color{orange}C'est pourquoi je recommande toujours de travailler avec le fichier \verb?.tex? placé dans un dossier,} pour éviter de submerger tes autres dossiers et de te perdre parmi les fichiers. \\ + +Enfin, ces fichiers secondaires n'ont besoin d'être conservés que le temps de travailler sur un document \LaTeX{}. \textbf{\color{Green}Le seul fichier qui compte est celui avec l'extension \verb?.tex?.} C'est lui qui contient tout le code nécessaire à la compilation et à l'obtention du PDF final. +\end{attention} + +\vspace{\baselineskip} + +Attaquons désormais la raison première de ce guide : faire du \LaTeX{}. \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p1-historique.tex b/info/guide-latex-fr/Chapitres/p1-historique.tex new file mode 100644 index 0000000000..9121cb9bad --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p1-historique.tex @@ -0,0 +1,123 @@ +\chapter{Pourquoi (utiliser) \LaTeX{} ?} + +\lettrine{C}{omme} toute chose, \LaTeX{} possède une histoire qui lui est propre, des avantages mais aussi des inconvénients -- rien n'est parfait en ce monde. Toutefois, \LaTeX{} est aussi un langage qui continue d'exister à l'heure actuelle et qui reste une référence dans le milieu scientifique. + +C'est pourquoi je te propose un petit interlude culturel avant d'entrer dans le vif du sujet\dots{} et peut-être aussi pour finir de te convaincre de son utilité ! + +\section{Historique : de \TeX{} à \LaTeX{}} + +\subsection*{La (petite) histoire} + +Donald \textsc{Knuth} est un mathématicien et informaticien américain, professeur émérite à l'université de Stanford. Il est l'auteur d'une bible de la programmation intitulée \textit{The Art of Computer Programming} (TAOCP).\footnote{Cet historique est extrait des \og Fiches à Bébert \fg{}, dont le texte complet est disponible sur : \url{http://lesfichesabebert.fr/divers/tex.html}.} \\ + +Le premier volume paru en 1965, a été publié à l'ancienne avec des caractères en plomb. Quand en 1976 Donald \textsc{Knuth} décide de publier la seconde édition du volume 2 de TAOCP, les caractères en plomb ont été abandonné au profit de la photocomposition. + +Donald \textsc{Knuth} trouve alors la qualité d'impression de ces machines, médiocre (notamment pour l'écriture des formules mathématiques) et décide de créer deux logiciels pour pouvoir produire ses publications avec une qualité typographique professionnelle. \\ + +Le premier, \TeX{}, sert à la composition de documents ; le second, METAFONT, à produire des polices vectorielles. Donald \textsc{Knuth} va mettre plusieurs années avant de sortir en 1983 la version définitive de \TeX{} qui utilise la police Computer Modern qu'il a créé à l'aide de METAFONT. + +En effet, Donald \textsc{Knuth} s'était fixé comme but d'arriver à un produit qui devrait être parfait et qui devrait le rester au cours du temps. C'est cette version qui est toujours utilisée et qui fonctionne depuis 30 ans. + +Donald \textsc{Knuth} est quand même intervenu sur \TeX{} à plusieurs reprise, notamment en 1989 pour l'adapter aux caractères nécessaires pour la composition de texte avec d'autres langues que l'anglais (version 2.991). La version actuel de \TeX{} est la 3.14159265 (janvier 2014). \\ + +L'autre trait de génie de Donald \textsc{Knuth} est de confier \TeX{} à l'American Mathematical Society et d'en faire un logiciel libre. + +\`A partir de là, d'autres informaticiens vont s'emparer de \TeX pour l'adapter (sortie de document au format PDF, utilisation de format d'image inconnue en 1983, adaptation à d'autres langues que l'anglais\dots{}) et l'enrichir (module permettant la création de formule chimique, de partition musicale, de diagrammes électrique ou physique\dots{}). \\ + +En 1982, Leslie \textsc{Lamport}, un chercheur en informatique américain, écrit \LaTeX{} (Lamport \TeX{}) un nouveau jeu de macros beaucoup plus simple à utiliser que \TeX{}. + +C'est un succès et pratiquement plus personne n'utilise \TeX{}. L'apparition des packages, qui permettent facilement d'augmenter les fonctionnalités, ont rendu \LaTeX{} incontournable (édition d'ouvrages scientifiques ou article de recherches, notamment). + +La version actuelle de \LaTeX{} est \LaTeX{}$2\varepsilon$, qui date de 1994. Elle est maintenue par le \LaTeX{}3 Project team qui nous prépare la version 3 de \LaTeX{} depuis 20 ans ! \\ + +\`A la fin des années 90, Hàn Thê Thành crée le moteur pdf\TeX{} qui permet de sortir les documents au format PDF, plus convivial que le format d'origine de \TeX{} le DVI. + +La dernière version la 1.40.11 date de 2011. pdf\TeX{} n'est plus développé, seules des corrections de bug y sont apportées. + +\textbf{C'est ce moteur que nous allons utiliser par la suite,} qui permet de passer directement du fichier \LaTeX{} au fichier PDF final désiré. + +\subsection*{\'Etymologie et prononciation} + +Si je remercie encore une fois Bébert pour ce magnifique historique, je me dois désormais d'intervenir sur un point qu'il ne traite pas sur cette page : l'étymologie et la prononciation de \LaTeX{}. + +C'est un point extrêmement crucial qui peut te permettre de briller lors de soirées mondaines et d'éviter de passer pour un blaireau lors de conversations avec d'autres utilisateurs de \LaTeX{}. \\ + +De ce que j'ai lu un jour quelque part sur Internet, Donald \textsc{Knuth} a nommé son logiciel \TeX{} comme pour \og technologie \fg{}. + +Mais, il s'avère qu'il est aussi féru de grec. Et \og technologie \fg{}, en grec, s'écrit \og $\tau\varepsilon\chi\nu{\rm o}\lambda{\rm o}\gamma\iota\alpha$ \fg{}, le $\chi$ correspondant au \og chi \fg{} mais que l'on prononce \og khi \fg{}. + +Et c'est donc pourquoi \TeX{} se prononce \og tech \fg{} mais s'écrit avec un ``X''. \\ + +Quant à \LaTeX{}, il s'agit juste d'ajouter les premières lettres du nom de son créateur, Leslie \textsc{Lamport}. \TeX{} est donc devenu \LaTeX{}\dots{} et se prononce \textit{a priori} de la même façon. + +Toutefois, Leslie \textsc{Lamport} indique explicitement dans son livre \textit{LaTeX: A Document Preparation System} qu'il n'encourage aucune prononciation particulière pour \LaTeX{}\dots{} mais là encore, si tu ne veux pas passer pour un blaireau, je t'encourage vivement à t'en tenir à la prononciation usuelle, soit \og latech \fg{} ! \\ + +Bien, maintenant que ce point a été abordé, venons-en aux avantages à utiliser \LaTeX{} avec, pour commencer, des témoignages ! + +\section{Pourquoi utiliser \LaTeX{} ?} + +Durant l'été 2017, j'ai posé la question suivante sur le groupe \og TeX / LaTeX User Group \fg{} de \LinkedIn{} : + +\begin{boite}[before upper = {}]{La question posée}{yellow!70!orange} +{\Large\textbf{LaTeX professional experience}} \\ + +Hello everybody, \\ + +I'm actually an engineering student and one of my main hobbies is writing stuffs in LaTeX (scientifical reports, lessons' synthesis, letter\dots{}, even a LaTeX manual user for beginners (in French) !). I was wondering if LaTeX is really helpful, in daily life, at work. \\ + +So, if anyone would like to share his opinion/experience, about how he uses LaTeX at work (or not), feel free to answer my message. \\ + +Thanks a lot and have a good summer, +\end{boite} + +J'espère pour toi que l'anglais n'est pas une contrainte car c'est loin d'être fini. Si toutes les réponses sont intéressantes, je trouve mon guide un peu terni par 6 pages de commentaires\dots{} Je vais donc faire un petit résumé : + +\begin{itemize}[label = \ding{213}] +\item certains pensent qu'utiliser \LaTeX{} est pertinent uniquement dans un milieu académique ou scientifique (recherche, surtout pour les mathématiques) ; + +\item beaucoup travaillent avec des gens qui fonctionnent exclusivement sous Word. Toutefois, pour la diffusion de notes internes, l'utilisation de \LaTeX{} est appréciée (clarté du message, mise en page propre, simplicité\dots{}) ; + +\item beaucoup reconnaissent que \LaTeX{} possède une forte courbe d'apprentissage, surtout au début\footnote{Mais je te rassure, ce guide est justement conçu pour t'aider à passer ce cap difficile}. Toutefois, ils utilisent aussi \LaTeX{} dans leur quotidien (lettres, CV, rendus\dots{}) car ils préfèrent sa facilité d'utilisation par rapport à Word une fois l'apprentissage bien avancé ; + +\item quasiment tous considèrent qu'apprendre à utiliser \LaTeX{} n'est pas une perte de temps et peut se révéler utile. \\ +\end{itemize} + +Si tu n'es pas convaincu ou si tu crains que j'ai truqué les réponses, laisse-moi au moins en partager deux, que tu puisses te faire une idée : + +\begin{boite}{Les 2 réponses les plus pertinentes à mon sens}{cyan!60!green} +\begin{itemize}[label = \ding{118}, leftmargin = *] +\item \textcolor{orange}{\textbf{Ed Blackburne :}} I use LaTeX everyday at work. My responsibilities include the production of Model Validation on reports per SR11-7. These are (generally) very technical and must be compliant with our Enterprise standards as well as regulatory guidance. Although many of my colleagues use MS Word, my team enjoys increased productivity from LaTeX. + +Additionally, for the econometric models, my team utilizes R/knitR/LaTeX to create dynamic reports (using methods borrowed from reproducible research techniques). + +I have created company-specific memo templates that I use on a daily basis, as well. + +If you write technical documents and/or need references (that work) I highly encourage investing the minimal effort to become a competent LaTeX user. + +\item \textcolor{orange}{\textbf{Brian Dunn :}} While LaTeX has a learning curve to use it well, so does MS Word or LibreOffice Writer, many people never use a word processor's formatting ``styles'', for example, and instead manually format everything. + +In talking with people at industrial trade shows, I occasionally come across a company which uses LaTeX for their documentation. Usually they are small engineering operations, and often European. Most places use poorly-formatted MS-Word generated documentation, or else InDesign when they want a professional image. I also found that companies which are suffering are not interested in improving their documentation, sales literature, or websites, even though their competitors which are doing well have very nice public-facing literature. +\end{itemize} +\end{boite} + +Toujours pas convaincu ? Voici alors une ribambelle d'arguments qui devraient, j'espère, finir de te convaincre d'utiliser \LaTeX{}. + +\section{Autres arguments} + +Utiliser \LaTeX{} au lieu d'un autre logiciel de traitement de texte plus\dots{} conventionnel présente un certain nombre d'avantages, dont voici la liste (non exhaustive) : \begin{itemize}[label = \ding{213}] +\item \LaTeX{} est entièrement gratuit et utilisable sur n'importe quel système d'exploitation ; + +\item un fichier \LaTeX{} est utilisable par n'importe qui (à condition d'avoir les logiciels adaptés à \LaTeX{}) et sous n'importe quelle version de \LaTeX{} ; + +\item \LaTeX{} génère un fichier PDF prêt à l'impression et lisible par n'importe qui ; + +\item \LaTeX{} propose une mise en page professionnelle et déjà paramétrée. La gestion de la numérotation des pages, des en-têtes et des pieds de page est relativement simple ; + +\item écrire des formules mathématiques devient assez facile (avec un peu de pratique) ; + +\item \LaTeX{} gère intégralement les notes de bas de pages, les renvois, le sommaire, les images, les tableaux, les légendes et la numérotation, les références bibliographiques ou la mise en place d'un index ; + +\item \LaTeX{} réalise aussi les césures les plus appropriées et prend en compte les ligatures. \\ +\end{itemize} + +Convaincu cette fois ? Pas vraiment ? Tu hésites encore ? Dans ce cas, continuons sur notre lancée et installons \LaTeX{} sur notre ordinateur. Tu ne peux pas savoir avant d'essayer, n'est-ce pas ? \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p1-installation.tex b/info/guide-latex-fr/Chapitres/p1-installation.tex new file mode 100644 index 0000000000..8113893fdb --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p1-installation.tex @@ -0,0 +1,95 @@ +\chapter{Installation de \LaTeX{}} + +\lettrine{A}{vant} de commencer, je suppose que tu utilises un système d'exploitation \Windows{}. Dans le cas contraire, un utilisateur \Linux{} devrait savoir se débrouiller pour tout installer. + +Si tu es un utilisateur d'\Apple{}, je considère déjà ta cause perdue d'avance et tu trouveras des équivalents grâce à Google\dots{} enfin, c'est ce que je disais initialement. Désormais, les programmes que je présente par la suite te sont aussi accessibles. + +\section{Installation de \MiKTeX{}} + +\MiKTeX{} est une distribution \LaTeX{}. Bon, je dois t'avouer que je ne sais pas moi-même ce qu'est une distribution\dots{} Ce qui m'intéresse, c'est d'arriver à faire fonctionner l'outil en question. Je vais donc sortir mon joker Wikipédia pour cette fois : + +\begin{definition}{Définition d'une distribution (informatique)} +{\noindent\huge\bfseries\color{gray!75}\og} + +On parle souvent de distribution pour désigner un ensemble de logiciels formant un tout cohérent et prêt à installer, incluant des jeux de paquetages, le noyau du système d'exploitation, en particulier le noyau Linux pour les distributions GNU/Linux (comme Debian, Mandriva, Red Hat, Ubuntu, etc.), un système d'installation et des utilitaires de configuration. \\ + +Cela désigne aussi un ensemble de paquets et d'outils utiles à la création d'un document au format LaTeX et pour en faciliter l'utilisation. Parmi les distributions LaTeX courantes, on trouve MiKTeX, TeXLive, MacTeX2. \\ + +Par ailleurs, une base de données distribuées est répartie sur plusieurs n{\oe}uds, généralement sur différents serveurs. + +{\hfill\huge\bfseries\color{gray!75}\fg} \\ + +\begin{flushright} +Wikipédia -- Disponible sur : + +\url{http://fr.wikipedia.org/wiki/Distribution#Informatique} +\end{flushright} +\end{definition} + +Je ne sais pas si c'est plus clair ainsi\dots{} Ce qui est certain, c'est que le seul élément intéressant à retenir est le suivant : \MiKTeX{} est l'outil qui te permet de transformer tes futures lignes de code \LaTeX{} en un PDF propre et lisible par tous. \\ + +Pour installer \MiKTeX{}, il faut procéder de la manière suivante\footnote{Si besoin, un descriptif encore plus détaillé et imagé est disponible à l'adresse suivante : \url{http://miktex.org/howto/install-miktex}.} : \begin{enumerate} +\item aller sur : \url{http://miktex.org/download} et télécharger l'exécutable ; + +\item lancer l'exécutable et suivre les instructions d'installation ; + +\item \textbf{laisser les options par défaut} \textcolor{red}{\textbf{DONT}} le ``choix de poste'' \og \texttt{Install MiKTeX only for me} \fg{}. + +Pour débuter, elles conviennent parfaitement et le choix \og \texttt{only for me} \fg{} permet d'éviter tout problème par la suite. \\ +\end{enumerate} + +\begin{attention}{\textit{Nota Bene}} +Je tiens à préciser que je n'ai aucun revenu financier grâce à \texttt{MiKTeX}. Je conseille cette distribution car c'est celle que j'utilise et qui fonctionne parfaitement pour ma part. + +Elle a aussi l'avantage de proposer un gestionnaire de packages, via \texttt{MiKTeX Console} ou l'interface de \MiKTeX{}. Nous aurons l'occasion d'y revenir plus tard dans ce guide, une fois que la notion de packages aura été introduite. \\ + +En revanche, tu es libre de choisir la distribution de ton choix et d'en prendre une autre. \`A toi d'en trouver une sur Internet : il y a un peu de choix. +\end{attention} + +\section{Installation de \Texmaker{}} + +Techniquement, cette étape n'est pas nécessaire car tu pourrais écrire ton fichier \LaTeX{} dans un fichier \texttt{.txt} (bloc-note) si le c{\oe}ur t'en dit. Cependant, le code sera plus compliqué à relire, il faut taper toutes les commandes à la main et il faut indiquer à \texttt{Windows} -- via des commandes dans le \texttt{CMD} -- de transformer ton code en PDF grâce à \MiKTeX{}. + +Avec \Texmaker{}, tous ces tracas sont épargnés : tu as à disposition un éditeur de fichiers \LaTeX{} performant, de la coloration syntaxique, un système d'auto-complétion des formules fort pratique et agréable, et toutes les commandes pour utiliser \MiKTeX{} sont intégrées et faciles à utiliser. \\ + +Pour cela, il faut aller sur le site de \Texmaker{} : \url{http://www.xm1math.net/texmaker/download.html}. Là encore, il suffit de télécharger l'exécutable, le lancer, suivre les instructions et laisser les options par défaut (comme pour \MiKTeX{}). + +\begin{attention}{\textit{Nota Bene}} +Même remarque pour \Texmaker{} que pour \MiKTeX{} : tu peux choisir un autre éditeur \LaTeX{}, même si celui-ci est vraiment très pratique selon moi. + +Il est aussi intégralement en français, avantage non négligeable quand tu débutes. +\end{attention} + +\section{Vérification finale} + +Si tu tiens à t'assurer que tout fonctionne, tu peux d'ores et déjà procéder à une vérification finale comme décrit ci-après. + +\textbf{Si jamais tu rencontres le moindre problème, ne t'attarde pas sur cette partie et poursuis au chapitre suivant,} qui détaille l'utilisation des logiciels récemment installés. \\ + +\begin{enumerate} +\item Ouvrir \Texmaker{}. + +\item En haut à gauche : \verb?Fichier? puis \verb?Nouveau? (ou \keys{\ctrl + N} pour les connaisseurs). + +\item Recopier le code \og Bonjour monde ! \fg{}, fourni en-dessous, et sauvegarder \textbf{dans un dossier} (le nom importe peu). + +\item Appuyer sur \keys{F6}, attendre un peu, puis aller dans le dossier où tu as sauvegardé le fichier : tu devrais y trouver un PDF avec la ligne \og Bonjour monde ! \fg{} écrite. +\end{enumerate} + +\label{hello-world} +\begin{code}{Bonjour monde !} +\documentclass[]{report} + + +\begin{document} + +Bonjour monde ! + +\end{document} +\end{code} + +Tout fonctionne donc parfaitement ! Tu peux poursuivre sereinement la suite du guide. + +\textbf{Dans le cas contraire,} ne perds pas ton temps et passe directement à la suite. Nous allons rapidement aborder le fonctionnement de \Texmaker{}. \\ + +\textcolor{red}{Si jamais des problèmes persistent par la suite,} je ne peux que te conseiller de tout désinstaller et de bien tout réinstaller comme indiqué précédemment. \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p2-erreurs.tex b/info/guide-latex-fr/Chapitres/p2-erreurs.tex new file mode 100644 index 0000000000..7b963ea382 --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p2-erreurs.tex @@ -0,0 +1,82 @@ +\chapter{Traitement des erreurs} + +\label{chap-erreurs}Les erreurs peuvent être nombreuses sous \LaTeX{} et pas toujours évidentes à corriger. Tout d'abord, nous appelons \og erreur \fg{} en \LaTeX{} tout bout de code qui nuit à la compilation du document et l'empêche de se poursuivre. Une erreur ne permet donc pas au compilateur de produire le fichier PDF espéré. + +Ensuite, il est important de savoir que toutes les erreurs qui vont être abordées sont retournées par \LaTeX{}, suite à la compilation. Ces erreurs sont affichées par \Texmaker{}, dans une fenêtre spécifique tout en bas (bouton \og \verb?Messages/Log? \fg{} en bas à gauche pour faire apparaître la fenêtre \og Informations du compilateur \fg{} si inexistante). + +\begin{figure}[H] +\includegraphics[width = \linewidth]{aide_LaTeX1.png} +\caption{Rappel de l'organisation de l'interface de \Texmaker{}} +\end{figure} + +\textbf{Quand il y a une erreur, cette fenêtre t'indique aussi la ligne de code qui pose problème à \LaTeX{} pour compiler} (colonne \verb?Line?). 90 \% du temps, c'est sur cette ligne ou dans ses environs qu'il faut relire son code et chercher l'erreur. + +Voyons maintenant la liste des erreurs couramment rencontrées quand tu débutes avec \LaTeX{}, et mes conseils personnels pour les éviter, synthétisée sous forme d'un tableau. \\ + +\begin{tableaubilan}{0.45\linewidth}{0.45\linewidth}{Les erreurs courantes}{Comment les corriger} +\verb?Missing $ inserted? & 2 cas fréquents : \begin{itemize}[label = \ding{213}, leftmargin = *] +\item oubli de fermer un mode mathématiques $\Rightarrow$ le fermer avec le symbole \verb?$? manquant ; +\item emploi d'un symbole propre au mode mathématiques (\verb?^? ou \verb?_? par exemple) $\Rightarrow$ supprimer le \verb?^? inutile ou utiliser la commande \verb?\_? pour afficher un \textit{underscore} en mode texte. +\end{itemize} \\ + +\verb?Missing } inserted? \par ou \par \verb?I suspect you have? \par \verb?forgotten a `}'? & Très probablement, oubli de fermer une commande par une accolade \verb?}? $\Rightarrow$ Commencer par chercher les erreurs parmi les lignes de codes écrites ou modifiées depuis la dernière compilation. \par Au début, \textbf{compiler régulièrement son code} permet de simplifier la correction de cette erreur.\footnote{C'est plus pratique de corriger plein de petites erreurs que de s'arracher les cheveux sur un très grand nombre.} \\ \\ + +\verb?! Too many }'s.? & Plus rare : oubli d'une accolade ouvrante. Mêmes conseils que ci-dessus. \\ \\ + +\verb?There's no line to end here? & Saut de ligne incompris par \LaTeX{} (après un environnement \verb?center? par exemple). \par $\Rightarrow$ Commencer par regarder le résultat sans saut de ligne : certains environnements laissent un peu de blanc avant et après (comme \verb?center? justement). Autrement, utiliser la commande \verb?\vspace?. \\ \\ + +\verb?undefined control sequence? & 2 cas possibles : \begin{itemize}[label = \ding{213}, leftmargin = *] +\item oubli d'un élément à un endroit, comme une virgule lors d'un espace insécable (\verb?\13? \textit{vs} \verb?\,13?) ; + +\item appel d'une commande inexistante ou appel d'une nouvelle commande bien définie mais faute de frappe lors de son écriture. +\end{itemize} \par $\Rightarrow$ Vérifier le code et le corriger. \\ \\ + +\verb?Package inputenc Error:? \par \verb?Unicode char?, suivi éventuellement d'un caractère et de son code UTF-8 & Utilisation d'un caractère du clavier interdit avec ce moteur de compilation. \par L'exemple le plus courant : symbole \degres{} (commande \verb?\degres{}? sous PDF\LaTeX{} ; appel ``normal'' au clavier sous Xe\LaTeX{}).\footnote{Les moteurs de compilation sont abordés dans la partie suivante si tu es intéressé.} \par ~ \par Erreur fréquente si texte copier-collé d'un autre document (Word, PDF, page Internet) \par $\Rightarrow$ Dans un 1\up{er} temps, reprendre tous les accents et les apostrophes.\footnote{Dans ce cas, la fonction \verb?Remplacer? de \Texmaker{} peut se révéler très utile.} \\ \\ + +\verb?Option clash for package? \par \verb?? & Conflit entre certains packages. \par $\Rightarrow$ Charger les packages dans un ordre bien précis. (exemple : package \verb?xcolor? avanr \verb?wallpaper?). \\ \\ + +\verb?Extra alignment tab has? \par \verb?been changed to \cr? & Erreur dans un tableau : oubli hautement probable d'indiquer un changement de ligne (\verb?\\?). \par $\Rightarrow$ Ajouter le \verb?\\? manquant. \\ \\ + +\verb?! [...] \begin{document}? \par \verb?ended by \end{}? \par ou \par \verb?! [...] \begin{}? \par \verb?[...] ended by \end{document}? & Environnement mal ouvert ou fermé. Très fréquent à cause de l'auto-complétion. \par $\Rightarrow$ Aller à la ligne indiquée par l'erreur, regarder l'environnement concerné, corriger selon le besoin. +\end{tableaubilan} + +Voilà dans les grandes lignes les principales erreurs que j'ai recensées jusqu'à présent. Avec l'expérience, tu verras que tu en feras de moins en moins ou que tu les corrigeras très rapidement. + +Sache aussi que tu peux te rendre sur \url{http://fr.wikibooks.org/wiki/LaTeX/\%C3\%80_l\%27aide_!} si tu veux des informations complémentaires. + +\begin{conseil}{Mon conseil le plus important} +Dès que tu ouvres un \verb?$? ou un \verb?\[? ou un \verb?{? ou un délimiteur, ferme-le en suivant. Puis, tu reviens en arrière et tu écris ton code. Le nombre d'erreurs devrait diminuer. + +L'auto-complétion de \texttt{Texmaker} est aussi très pratique pour éviter ce genre de désagréments. +\end{conseil} + +Par ailleurs, je souhaite revenir sur l'erreur \verb?Option clash for package?. Si jamais tu veux tester un nouveau package pour ton rapport ou adapter un code trouvé sur Internet, \textbf{\color{orange!65!red}ne jamais le faire sur ton document final !} C'est le meilleur moyen de perdre du temps (compilation et adaptation du code). Il vaut mieux procéder par étapes : \begin{enumerate} +\item Copie du code à adapter sur un nouveau fichier \verb?.tex? de test, avec juste les packages absolument nécessaires. + +\item 1\up{ère} compilation pour s'assurer que le code copié fonctionne. Suppression des éléments inutiles et/ou gênants pour la compilation (commandes définies par l'utilisateur et non fournies par exemple). + +\item Adaptation du code jusqu'à obtention du résultat souhaité. + +\item Copie du code final dans ton rapport, ajout du/des package(s) requis, compilation et gestions des dernières potentielles erreurs. +\end{enumerate} + +Tu verras que tu perdras moins de temps à compiler, à étudier le résultat dans l'affichage \Texmaker{} et tu travailles sur un fichier de test, sans pollué ton rapport. + +\begin{regles}{La règle absolue avec les packages} +Par défaut, \emph{toujours} charger le package \verb?hyperref? \emph{en dernier} ! (sauf indication contraire : cf. la documentation du package \verb?menukeys? par exemple). +\end{regles} + +\vspace{\baselineskip} + +Et voilà, la première partie de ce guide est (enfin) terminée. Toutes mes félicitations si tu es arrivé jusqu'ici ! J'espère avoir pu t'être d'une aide quelconque et que mes explications étaient assez claires. + +Ce n'est pas absolument pas évident de débuter en \LaTeX{}. Et si je commence à avoir pas mal de repères et d'expériences, la route est encore longue avant de pouvoir maîtriser les innombrables facettes de ce langage. \\ + +Tu trouveras dans la partie suivante mes notes personnelles sur du code \LaTeX{} plus poussé, pour arriver à produire des résultats de plus en plus complexes. Je tenais initialement à les regrouper dans ce guide pour mon usage personnel mais je me suis rendu compte qu'elles peuvent aussi aider mes lecteurs. \\ + +\begin{center} +\begin{LARGE} +\bfseries{}Bon courage pour la suite et, surtout, n'oublie pas : \\[\baselineskip] +\LaTeX{}, c'est la vie ! +\end{LARGE} +\end{center} \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p2-images.tex b/info/guide-latex-fr/Chapitres/p2-images.tex new file mode 100644 index 0000000000..123ef36b85 --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p2-images.tex @@ -0,0 +1,398 @@ +\chapter{Insérer des images} + +\label{chap-img}\lettrine{U}{ne} bonne image suffit des fois à remplacer 13 lignes de texte. Découvrons quelques spécificités à leur sujet et comment en insérer sous \LaTeX{}. \\ + +\input{./Chapitres/code-base} + +\section{Les formats d'images} + +Il existe deux sortes d'images : les images matricielles et les images vectorielles. Les premières sont les plus courantes et portent généralement les extensions \verb?.jpg? (\textit{Joint Photographic Group}) ou \verb?.png? (\textit{Portable Network Graphics}). Les secondes sont les plus propres et utilisent des extensions comme \verb?.svg? (\textit{Scalable Vector Graphics}) ou \verb?.eps? (\textit{Encapsulated PostScript}).\footnote{La création, édition et visualisation des fichiers \verb?.svg? sont possibles grâce à des logiciels spécialisés, comme \Inkscape{}. Le format \verb?.eps?, moins connu et un peu délaissé de nos jours, peut être visualisé simplement grâce à des logiciels comme \texttt{EPS Viewer}.} \\ + +La base d'une image matricielle est le pixel, d'une couleur donnée et figée. Si tu zoomes sur l'image à la page précédente, tu devrais tomber sur ces fameux pixels. \textit{A priori}, rien de méchant : dès lors que ton image contient ``suffisamment'' de pixels par rapport à la taille affichée, elle ne devrait pas apparaître trop floutée. + +Une image vectorielle est définie par l'intermédiaire d'outils géométriques (arcs de cercle, traits, courbes de Bézier, \dots{}). Je ne vais pas faire un cours dessus : d'abord parce que je n'en sais pas plus et ensuite parce que ce n'est pas le but de guide. + +Ce qu'il faut retenir c'est que, peu importe à quel point tu zoomes, tu ne tomberas jamais sur un pixel et l'image vectorielle reste lisse et belle\footnote{J'ai l'impression de faire de la pub' pour l'Oréal\dots{}}. Et inversement, si l'image est grande de base, aucun pixel ne sera donc visible. + +\begin{figure}[H] +\begin{minipage}{0.45\linewidth} +\includegraphics[angle = 90, width = \linewidth]{eclair_image-matricielle.png} +\end{minipage} +\hfill +\begin{minipage}{0.45\linewidth} +\includegraphics[angle = 90, width = \linewidth]{eclair.eps} +\end{minipage} +\caption*{\bfseries{}Cachez cette image matricielle (à gauche) que je ne saurais voir !} +\end{figure} + +%\begin{conseil}{Un exemple d'images vectorielles} +%Si tu veux un exemple, retourne sur la page de garde et regarde les deux images que j'ai insérées. Tu auras beau zoomer, aucun pixel à la ronde. \\ +% +%Un exemple encore plus simple est le texte. En effet, peu importe le texte que tu lis et le niveau de zoom, là encore, pas de pixel. C'est normal : les polices d'écriture sont définies comme une image vectorielle. +% +%Et heureusement ! Imagine un peu le résultat : conçois (mentalement) une ``police matricielle'' et augmente sa taille. Le résultat n'est pas terrible, n'est-ce pas ? +%\end{conseil} + +\begin{definition}{Un exemple plus courant d'images vectorielles} +Dans un fichier PDF, tu trouves en réalité des images vectorielles partout. En effet, le texte affiché utilise une police spécifique, définie vectoriellement. + +Et heureusement ! Quel enfer serait sinon la lecture si tout le texte était flou voire illisible faute d'avoir suffisamment de pixels. +\end{definition} + +Le format \verb?.eps? fait un peu vieux jeu et reste surtout utilisé dans le domaine scientifique. Cependant, même s'il difficile à modifier avec des outils standards (comme \Paint{}), il est plus facile à implanter sous \LaTeX{} que le format \verb?.svg?, pour un résultat identique. + +\begin{attention}{Conversion au format \texttt{.eps}} +Une image au format \verb?.eps? n'est pas automatiquement vectorielle. Supposons que tu ouvres sous \GIMP{} une image matricielle et que tu l'enregistres au format \verb?.eps?. Le rendu final reste une image matricielle. + +Le format \verb?.eps? ne garantit pas automatiquement une image vectorielle derrière. Il n'y a pas non plus de transformation miraculeuse en arrière-plan. C'est bel et bien un format qui peut gérer ce type d'image mais il ne faut pas s'attendre à ce qu'il fasse de lui-même une belle conversion. \\ + +Pour conserver une véritable image vectorielle au format \verb?.eps?, il faut vectoriser l'image matricielle (passage du matriciel au vectoriel), sous \Inkscape{} par exemple\footnote{Cette méthode fonctionne parfaitement pour des formes simples, avec peu de variations de couleur. Le résultat est à travailler pour des images plus complexes, voire à créer directement au format vectoriel.}, sauvegarder le résultat au format \verb?.svg? (sécurité) puis enregistrer cette image vectorielle au format \verb?.eps?. +\end{attention} + +\section{Les longueurs} + +\label{longueurs}Après cette première introduction, nous allons continuer par un petit passage barbare, mais qui va se révéler utile pour la suite. J'en ai déjà brièvement parlé plus tôt\dots{} mais c'est l'occasion parfaite pour proprement présenter la notion de \og longueur \fg{} sous \LaTeX{}. \\ + +Sous \LaTeX{}, il est possible de travailler avec toutes sortes d'unités : \verb?mm?, \verb?cm? pour citer les plus courantes ; \verb?pt?, \verb?in? pour citer quelques cas moins usités ; \verb?ex? pour citer l'unité de distance la plus amusante que j'ai découverte à ce jour en informatique\footnote{Hauteur d'un \og \verb?x? \fg{} : cette unité de longueur dépend donc de la police utilisée.}. + +Dès lors qu'une commande requiert une longueur en paramètre d'entrée, nous l'indiquons très clairement. Par exemple, \verb?\vspace{13mm}?. Cependant, \LaTeX{} permet d'aller plus loin, beaucoup plus loin en mettant des longueurs prédéfinies sous forme de commande. + +\begin{conseil}{Quelques longueurs sous \LaTeX{}} +\LaTeX{} utilise des longueurs nativement, dans chaque nouveau document. Par exemple, à chaque nouveau paragraphe, \LaTeX{} met un alinéa. La taille de cet alinéa est une longueur définie par défaut et \LaTeX{} utilise sa valeur. \\ + +Il en va par exemple de même pour les marges ou les sauts de ligne. Naturellement, toutes ces longueurs peuvent être modifiables, même si ce n'est pas vraiment recommandé. C'est aussi ce qui garanti l'homogénéité (ou la cohérence, si tu préfères) d'un document réalisé avec \LaTeX{}. +\end{conseil} + +Du coup, sans entrer plus dans les détails, voici deux longueurs fondamentales qui sont plutôt utiles : + +\begin{itemize}[label = \ding{213}] +\item \verb?\linewidth? : longueur qui correspond à la largeur ``locale'' du texte (vis-à-vis de la page, dans un tableau, dans une boîte, etc.) ; + +\item \verb?\baselineskip? : longueur qui correspond à un saut de ligne sous \LaTeX{}. \\ +\end{itemize} + +\begin{attention}{\texttt{\textbackslash{}linewidth} \textit{vs} \texttt{\textbackslash{}textwidth}} +Tu trouveras des fois dans la littérature ou dans des exemples sur Internet des gens qui emploie la longueur \verb?\textwidth?. \`A première vue, lors de son utilisation, elle présente peu de différences avec \verb?\linewidth?. Et pourtant, il y a bel et bien une différence !\footnote{Les points à venir ont été extraits et traduits de la page suivante : \url{https://tex.stackexchange.com/questions/16942/difference-between-textwidth-linewidth-and-hsize}.} \begin{itemize}[label = \ding{118}] +\item \verb?\textwidth? représente la largeur d'un bloc de texte (valeur constante, globale) ; + +\item \verb?\linewidth? représente la largeur locale du texte, que ce dernier soit présent dans une colonne, un tableau, une liste ou une \verb?minipage?. \\ +\end{itemize} + +En règle générale, il vaut mieux utiliser \verb?\linewidth? pour spécifier la taille relative d'une image ou d'une boîte. Cette longueur s'adapte mieux à la situation et aux potentiels montages que tu peux réaliser (avec des \verb?minipage?, par exemple). +\end{attention} + +Enfin, il peut être intéressant de savoir qu'un coefficient est toléré devant les longueurs. Par exemple, \verb?\vspace{2\baselineskip}? correspond à un double saut de ligne. \verb?0.5\linewidth? correspond à une longueur égale à la moitié de la page (marges exclues). + +Voilà, je ne vais pas aller plus loin. Si tu veux en savoir plus sur les longueurs (création de longueurs, longueurs définies par défaut, etc.), je te recommande d'aller lire la page suivante : \url{http://en.wikibooks.org/wiki/LaTeX/Lengths}. \\ + +Bien, allons maintenant insérer des images. Retiens surtout la longueur suivante : \verb?\linewidth?. C'est celle qui va beaucoup nous servir ici. + +\section{Insérer une image} + +\subsection*{La commande de base} + +\label{insertion_images}Je pense que tu devais attendre ce point depuis pas mal de temps. Ne traînons pas plus dans ce cas : place aux insertions d'images ! \\ + +Travailler avec des images sous \LaTeX{} est possible. Il faut au préalable charger le package \verb?graphicx?\footnote{Ne pas confondre avec le package de base \verb?graphics? dont \verb?graphicx? (avec un \og x \fg{} donc) est une version améliorée !}. Pour insérer une image, c'est très simple. Il faut utiliser la commande suivante, à l'endroit où tu souhaites afficher ton image : \begin{center}\verb?\includegraphics[options]{nom_img.format}?\end{center} + +Mais je crois qu'un exemple sera plus parlant. Pour ce faire, prends une image plutôt grande de préférence, soit au format \verb?.jpg? ou \verb?.png?\footnote{Si tu ne connais pas le format de ton image, \verb?clic droit? puis \verb?Propriétés?.}, puis renomme-là \verb?fond?. De cette manière, tu auras moins de souci avec le code qui suit. Place cette image dans le même dossier que le fichier \verb?.tex? avec lequel tu travailles. + +Si jamais tu te trompes de format d'images ou que l'image n'est pas dans le dossier, \LaTeX{} va te renvoyer un message d'erreur, du genre \og File \verb?nom_img.format? not found \fg{}. + +\begin{codedisplay}{Première insertion d'images} +% Ajout dans le préambule !!! +%\usepackage{graphicx} + + +\includegraphics{fond.jpg} +\end{codedisplay} + +Bon, si l'utilisation de la commande de base est aussi simple, tu conviendras que ce n'est pas très pratique avec une image très grande et qui déborde pas mal du document ! Voyons donc maintenant comment judicieusement utiliser les longueurs pour avoir un affichage convenable. + +\subsection*{Utilisation des longueurs} + +Pour ajuster la taille d'une image, \textbf{2 options \emph{utiles}} sont disponibles avec la commande \verb?\includegraphics? : \begin{enumerate} +\item \verb?width = ? : forcer la largeur de l'image à \verb??. Cette option se révèle salvatrice combinée avec la longueur \verb?linewidth?. + +\item \verb?height = ? : forcer la hauteur de l'image à \verb??. Essentiellement utile pour des images dont le format \og portrait \fg{} est très prononcé, ou si tu veux remplir intégralement la page. +\end{enumerate} + +Et c'est tout ce qu'il faut savoir ! Il existe bien une autre option comme \verb?scale? mais sans intérêt car la valeur à utiliser dépend de la taille de l'image. + +Avec l'option \verb?width?, peu importe la taille de ton image, elle sera toujours bien insérée dans ton document. Bien entendu, si ton image reste petite et matricielle, elle risque d'être floue à l'affichage. Autrement, tu n'as plus à te soucier de retraiter tes images pour les avoir à une taille appropriée. + +\begin{codedisplay}{Une image bien taillée} +% Ajout dans le préambule +%\usepackage{graphicx} + + +\includegraphics[width = \linewidth]{fond.jpg} + +\begin{center} +\includegraphics[height = 0.25\linewidth]{fond.jpg} +\end{center} +\end{codedisplay} + +Comme afficher ci-dessus, tu peux centrer ton image avec un environnement \verb?center?. La commande \verb?\centering? fonctionne aussi et va se révéler utile par la suite. + +C'est déjà mieux, non ? Pardon ? Tu voudrais aussi une magnifique légende pour accompagner ton image ? Ta demande est légitime ! + +\subsection*{Légende et environnement flottant} + +\textbf{Tout comme pour les tableaux,} l'insertion d'une légende à une image demande de placer celle-ci dans un \emph{environnement flottant}. Il s'agit d'une obligation sous \LaTeX{} pour garantir la qualité du document. Tu conviendras que le rendu ne serait pas très esthétique si l'image était en bas de page et la légende à la page suivante faute de place. + +Visuellement, nous pouvons considérer l'environnement flottant comme une boîte qui va englober ton image et ta légende et dont la position est variable, selon la place restante sur ta page : + +\begin{figure}[H] +\centering +\begin{tikzpicture}[every node/.style = {anchor = south west}] +\draw[red, very thick] (0,0) node {Environnement flottant} rectangle (\linewidth,-5.5); +\draw[Green] (1,-1) node {Image} rectangle (\linewidth-1cm,-3); +\draw[cyan] (2,-4) node {Légende} rectangle (\linewidth-2cm,-5); + +\draw[<->, > = Stealth, red, line width = 5pt] (0.5,-2) -- (0.5,-4); +\end{tikzpicture} +\caption{Schématisation d'un environnement flottant} +\end{figure} + +L'environnement flottant pour les images s'appelle \verb?figure?. Et comme \LaTeX{} fait bien les choses, il met à ta disposition différentes options pour positionner correctement cet environnement : \begin{itemize}[label = \ding{213}] +\item \verb?t? pour \verb?top? : l'image se retrouve en haut de page ; + +\item \verb?b? pour \verb?bottom? : l'image se retrouve en bas de page ; + +\item \verb?p? pour \verb?page? : l'image se retrouve sur une page particulière réservée aux éléments flottants ; + +\item \verb?h? pour \verb?here? \textbf{(le plus pratique)} : l'image se retrouve là où elle est positionnée dans le code. \\ +\end{itemize} + +Cependant, il arrive à \LaTeX{} d'être un peu capricieux et l'option ``\verb?!?'' devant la lettre lui indique que l'utilisateur a raison. Si tu utilises donc l'option \verb?!h?, \LaTeX{} fait tout son possible pour placer l'environnement flottant là où il est placé dans le code. + +Ainsi, si le code de l'image est écrit entre une zone de texte A et une autre zone de texte B, elle le sera aussi sur le document final\dots{} à condition qu'il y ait suffisamment de place, naturellement. Dans le cas contraire, l'image se retrouve à la page suivante et le texte est remonté en conséquence pour combler les blancs. + +Enfin, pour placer une légende, la commande \verb?\caption{légende}? est toujours d'actualité pour les images et se place donc à l'intérieur de l'environnement flottant \verb?figure?. + +% Comme pour les tableaux, hormis \begin{figure}[H], codedisplay impossible +\begin{code}{Environnement flottant (\texttt{figure}) \& légende (\texttt{\textbackslash{}caption})} +% Ajout dans le préambule +%\usepackage{graphicx} + + +% La base +\begin{figure} +\includegraphics[width = 0.5\linewidth]{fond.jpg} +\caption{Une première légende} +\end{figure} + +% !h + centrage +\begin{figure}[!h] +\centering +\includegraphics[width = 0.5\linewidth]{fond.jpg} +\caption{Une autre légende} +\end{figure} +\end{code} + +Si je rencontre quelques soucis pour afficher le résultat du code dans cette exemple, tu dois constater que la numérotation de la légende est automatisée par \LaTeX{}. Parfait, une tâche à laquelle nous n'aurons pas à nous soucier ! \\ + +Toutefois, certaines complications peuvent parfois se produire avec cette option \verb?!h?. C'est pourquoi la \textbf{solution ultime} -- que j'utilise constamment -- consiste en l'utilisation du package \verb?float? et de renseigner un \verb?H? à la place de \verb?!h?. L'image est \textit{vraiment} contrainte d'être à cet endroit. + +Et s'il n'y a pas la place, \LaTeX{} laisse un blanc, ce qui laisse parfois un gros trou dans ton document\dots{} Difficile d'arriver à tout concilier ! + +\begin{codedisplay}{La meilleure solution (selon moi)} +% Ajout dans le préambule +%\usepackage{graphicx, float} + + +% Package float +\begin{figure}[H] +\centering +\includegraphics[width = 0.5\linewidth]{fond.jpg} +\caption{Avec une légende !} +\end{figure} +\end{codedisplay} + +\begin{attention}{Disposition des images \& marges} +Quand une image ne rentre pas en bas d'une page, il peut être tentant dans un premier temps d'augmenter les marges du document pour laisser plus de place à l'image. \textbf{\color{red}C'est exactement ce qu'il \emph{ne faut pas} faire !} + +Tout d'abord, augmenter les marges permet en effet de gagner quelques lignes de texte et donc de gagner la place attendue pour placer l'image. Mais la longueur \verb?\linewidth? est aussi augmentée en conséquence donc ton image est plus grande ! Ce n'est donc pas une solution. + +De plus, changer les marges bouscule toute la structure et l'agencement de ton document, les blancs laissés par les images qui ne rentrent pas en bas de page (si choix de l'option \verb?H? avec le package \verb?float?). Tu risques donc de perdre un temps considérable à tout réajuster à chaque fois. \\ + +Je recommande donc de procéder de la manière suivante : \begin{enumerate} +\item Régler les marges à la création du document (marges natives inchangées, choix personnel ou consigne de mise en page du rapport). + +\item Rédiger ton document, inclure les images. + +\item Revenir sur ton document, réagencer les images, les réduire, faire des montages, etc. pour limiter les blancs et avoir le meilleur rendu (subjectif). + +Tu peux aussi t'occuper de cette dernière étape chapitre par chapitre par exemple (changement de page par défaut entre deux chapitres). +\end{enumerate} +\end{attention} + +Bien abordons désormais un dernier point capital : la gestion des images. + +\subsection*{Bien ranger ses images} + +Si jamais tu as beaucoup d'images dans ton rapport, tu peux vite noyer le dossier de travail où se trouve ton fichier \verb?.tex?. + +Dans ce cas, tu peux placer tes images dans un dossier, \textbf{situé au même endroit que ton fichier \verb?.tex?}, puis utiliser la commande suivante dans le préambule : \begin{center}\verb?\graphicspath{{./nom_du_dossier/}}?\end{center} + +Fais attention à bien placer cette commande \textbf{après} le package \verb?graphicx?, car il s'agit d'une commande de ce même package. \\ + +Grâce à cette commande au nom assez explicite, tu indiques à \LaTeX{} le répertoire/dossier où tu as rangé tes images.\footnote{En informatique, la ``commande'' \verb?./? fait référence au dossier où se trouve le fichier avec lequel tu travailles. Pour revenir au dossier parent, il faut utiliser \verb?../?.} Tu n'es pas limité à un seul chemin, tu peux en indiquer autant que nécessaire si besoin. + +Si le dossier est placé à un autre endroit, la commande s'applique toujours mais, dans ce cas, il faut renseigner le chemin complet pour accéder jusqu'au dossier. + +\begin{attention}{Nom des images et des dossiers} +\textcolor{BrickRed}{Le nom de tes images ou des dossiers où tu places tes images ne doit contenir \textbf{ni accent ni espace.}} Autrement, tu risques de ne pas pouvoir compiler ton document et tu ne vas pas comprendre l'erreur. \\ + +Le nom \verb?texte mathématiques? est donc à bannir. Tu peux par contre appeler ton image \verb?texte_maths?, \verb?textemathematiques?, \verb?texte-maths?, etc. +\end{attention} + +Bien, voyons maintenant comment faire référence à une image. + +\section{Les références} + +Une image, une équation, un tableau, une partie\dots{} tous ces outils sont bien pratiques mais que valent-ils si tu ne peux y faire référence ? Par exemple, comment écrire \textbf{automatiquement} \og cf. l'image \no{}$x$ page $y$ \fg{} ? + +Le but est bel et bien d'avoir une numérotation automatique : c'est bien plus pratique et moins fatiguant que de devoir corriger tout ton document à la main (et même impossible et impensable sur un rapport de plusieurs centaines de pages). + +Naturellement, \LaTeX{} propose nativement une solution, ou je n'aborderais pas le sujet. Donc pas de nouveaux packages pour cette fois ! \\ + +Si tu veux créer une référence, il faut procéder en 2 étapes : \begin{enumerate} +\item Création de la référence avec la commande \verb?\?\verb?label{nom-ref}?. Cette commande est à placer \textbf{après} une légende par exemple (\verb?\caption? pour rappel). + +Tu peux aussi l'utiliser dans un environnement mathématiques (si tu veux faire référence à une équation ou dans un paragraphe (pour renvoyer à un bout de texte en particulier). + +\item Appel de la référence avec la commande \verb?\?\verb?ref{nom-ref}? (numéro de la légende, de l'équation ou section dans lequel se situe le texte). \\ +\end{enumerate} + +La commande \verb?\?\verb?pageref{nom-ref}? est disponible nativement (appel du numéro de page où se situe la référence et donc l'objet référence), tandis que les commandes \verb?\nameref? et \verb?\autoref? sont présentes avec le package \verb?hyperref?. + +Et si tu veux encore d'autres fonctionnalités, il paraît que le package \verb?cleveref? est LA solution. Je dois encore le tester donc je ne vais pas m'épancher sur le sujet. \\ + +Voici un petit exemple pour mieux comprendre le fonctionnement des références : + +\begin{codedisplay}{Faire référence à une image} +% Ajout dans le préambule +%\usepackage{graphicx, float} + + +\begin{figure}[H] +\centering +\includegraphics[width = 0.5\linewidth]{fond.jpg} +\caption{Légende} +\label{exemple-ref-img} +\end{figure} + +Mon image est la \figurename{} \ref{exemple-ref-img}, située en page \pageref{exemple-ref-img}. \\ + +Avec le package \verb?hyperref? : \nameref{exemple-ref-img} \& \autoref{exemple-ref-img}. +\end{codedisplay} + +Comme tu peux le constater, les références se mettent à jour automatiquement. Cette fonctionnalité est très puissante et extrêmement pratique : tu n'as plus à te soucier de devoir tout mettre à jour manuellement à chaque ajout d'une image. \LaTeX{} a tout en mémoire et l'adapte si besoin. + +Pour information, le fonctionnement est similaire pour les formules mais l'appel de la référence se fait avec la commande \verb?\?\verb?eqref{nom-ref}?. + +\begin{attention}{Une question ?} +\og Je ne comprends pas. J'ai compilé et j'ai \verb!??! à la place de mes références. Pourquoi ? \fg{} \\ + +Ce n'est rien de grave. C'est le même problème que pour le sommaire. \LaTeX{} stocke les références dans un fichier à part à la première compilation et ne s'en sert que lors de la seconde. + +\textbf{Il faut donc juste compiler deux fois} pour afficher correctement les références ou les mettre à jour.. +\end{attention} + +Allez, un peu de courage. Tu touches presque à la fin de ce guide. Tu pourras alors être autonome sous \LaTeX{}, et taper de magnifiques rapports. + +Et la suite n'est pas compliquée : c'est du code pour faire des montages d'images et t'éviter de chercher pendant des heures comme j'ai eu à le faire ! + +\section{Un peu de montage} + +Je suis sûr que, si tu n'y penses pas maintenant, tu souhaiteras à l'avenir faire quelques montages avec des images. Par exemple, placer 2-3 images l'une à côté de l'autre ou une image avec du texte autour. \\ + +Pour ce dernier cas (image avec du texte autour), il existe des solutions, comme le package \verb?wrapfigure? qui fonctionne plutôt bien mais qui doit être utilisé avec des pincettes. Il est fortement recommandé d'aller jeter un coup d'\oe{}il à l'aide en ligne. + +Concrètement, pour expliquer le fonctionnement de ce package, il permet de positionner une image sur la droite ou sur la gauche, dans un bloc de taille fixée par l'utilisateur. Le texte qui suit la commande épouse alors le contour de l'image avant de reprendre son cours initial. + +Je m'arrache toujours les cheveux à chaque fois que je l'utilise car je trouve que le rendu n'est jamais à la hauteur et beaucoup de problèmes se posent dès qu'une légende est ajoutée à l'image. Je ne fournirai donc pas un exemple ici. \\ + +Heureusement, il existe d'autres solutions plus simples comme les \verb?minipage?. Si jamais tu as besoin de te remémorer le fonctionnement des \verb?minipage?, je te renvoie à la page \pageref{minipage-explications}. Sinon, pour aligner côte à côte deux images, il y a déjà une règle absolument primordiale, ou la compilation ne donnera pas le résultat espéré : \begin{center} +\large\bfseries\color{red!60!orange}NE PAS laisser une seule ligne blanche ! +\end{center} + +Ensuite, la petite recette de cuisine avec les \verb?minipage? fonctionne de la manière suivante : \begin{enumerate} +\item Création d'une 1\up{ère} \verb?minipage? de largeur $X_1$\verb?\linewidth?, avec $X_1 \in ]0\,;\,1[$. + +\item Insertion classique de l'image avec la commande \verb?\includegraphics? et l'option \verb?width?. Utiliser la longueur \verb?\linewidth? (ou une valeur réduite) devient très pratique dans cette situation. + +Par exemple, une image de largeur \verb?0.6\linewidth? dans une \verb?minipage? de largeur \verb?0.45\linewidth? (par rapport à la page ici) sera de largeur totale \verb?0.27\linewidth?, par rapport à la page du coup. + +\item Séparation (espace blanc) avec la commande \verb?\hfill? : remplissage de l'espace horizontal restant après la création de la 2\up{nde} \verb?minipage?. + +Cette séparation permet d'avoir l'image à gauche collée sur la marge de gauche, celle de droite sur la marge de droite, et d'avoir un beau séparateur (espace blanc) entre les deux. + +\item Création de la 2\up{nde} \verb?minipage? de largeur $X_2$\verb?\linewidth?, avec $X_2 \in ]0\,;\,1[$ \textbf{et}. $X_1 + X_2 < 1$ (ou le \verb?\hfill? n'a aucun intérêt). + +\item Si insertion de légende(s), encadrement de toutes les étapes précédentes par un environnement \verb?figure? et placement des légendes respectives au sein de chaque \verb?minipage?. \\ +\end{enumerate} + +Un exemple ici et maintenant et tout sera plus clair : + +\begin{codedisplay}{\texttt{minipage} \& montage d'images} +% Ajout dans le préambule +%\usepackage{graphicx, float} + + +\begin{figure}[H] +\begin{minipage}[t]{0.45\linewidth} +\centering +\includegraphics[width = 0.6\linewidth]{fond.jpg} +\caption{Lég. 1} +\end{minipage} +\hfill +\begin{minipage}[t]{0.45\linewidth} +\includegraphics[width = \linewidth]{fond.jpg} +\caption{Lég. 2} +\end{minipage} +\end{figure} +\end{codedisplay} + +Une fois que tu as saisi le principe pour 2 images, rien ne t'empêche d'en aligner autant que tu le souhaites, à condition d'avoir la place (ou tes images risquent d'être très petites). + +Tu peux aussi moduler à ta guise la largeur des différentes \verb?minipage? : rien ne t'oblige à toutes les avoir de la même largeur, par exemple. \`A toi d'adapter cet exemple en fonction de ton besoin ! \\ + +Il est aussi possible de mettre du texte dans une \verb?minipage?, pour insérer une \textbf{courte} explication à côté de l'image. \textbf{\color{red}Attention toutefois si le texte est trop grand :} ta \verb?minipage? va prendre trop de hauteur, le rendu ne sera plus aussi esthétique et la place risque de manquer. + +Dans ces cas-là, il faut soit être synthétique, soit utiliser le package \verb?wrapfig?, soit revoir le rendu souhaité. + +\begin{codedisplay}{\texttt{minipage} \& texte} +% Ajout dans le préambule +%\usepackage{graphicx, float} + + +\begin{figure}[H] +\begin{minipage}{0.55\linewidth} +J'aime le chocolat ! +\end{minipage} +\hfill +\begin{minipage}{0.4\linewidth} +\centering +\includegraphics[width = 0.86\linewidth]{fond.jpg} +\caption{Légende} +\end{minipage} +\end{figure} +\end{codedisplay} + +Pour terminer, si tu veux t'amuser un peu, voici un premier aperçu d'une autre option sympathique intégrée avec le package \verb?graphicx? : + +\begin{codedisplay}{\textit{Yolo} !} +% Ajout dans le préambule +%\usepackage{graphicx, float} + +\begin{center} +\includegraphics[width = 0.5\linewidth, angle = 13]{fond.jpg} +\end{center} +\end{codedisplay} + +Il existe pas mal d'autres options, ainsi que la très pratique commande \verb?\resizebox?, que nous aurons la chance de recroiser plus tard dans ce guide. Mais je te laisse aller lire la documentation officielle\footnote{Disponible sur \url{https://ctan.org/pkg/graphicx}.}. Les explications de base sont sur ce guide et c'est ce qui m'importe. \\ + +Et voilà, tu approches de la fin de ce guide. Tu peux clairement t'arrêter après le \autoref{chap-erreurs} \nameref{chap-erreurs} et revenir à ce guide beaucoup plus tard selon tes besoins. \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p2-maths.tex b/info/guide-latex-fr/Chapitres/p2-maths.tex new file mode 100644 index 0000000000..b0f7870476 --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p2-maths.tex @@ -0,0 +1,451 @@ +\chapter{Les mathématiques sous \LaTeX{}} + +\label{chap-maths}\lettrine{C}{omme} tu peux le constater, il y a fort à faire sous \LaTeX{}. Les combinaisons sont déjà impressionnantes. Je te laisse maintenant découvrir la raison d'être de \LaTeX{}, ce pourquoi il a été créé : écrire proprement des formules mathématiques ! \\ + +\input{./Chapitres/code-base} + +\section{Le mode mathématiques} + +Bon, c'est bien beau de vouloir faire écrire des maths à \LaTeX{}, encore faut-il lui indiquer qu'il s'agit justement de maths ! C'est le principe du \og mode mathématiques \fg{}. + +Celui-ci est défini soit par le symbole \$ \textbf{(un ouvrant et un fermant)}, soit par des ``backslash-crochets'' \verb?\[? et \verb?\]?, soit par l'environnement \verb?equation? : + +\begin{codedisplay}{Le mode mathématiques} +\'Ecrire x = 2 ! et $x = 2 !$ ne donnent pas le même résultat ! \\ + +De même si j'écris \[x = 2 !\] % Pas de \\ car déjà un saut de ligne + +On obtient la même chose avec : + +\begin{equation} +x = 2 ! +\end{equation} + +mais l'équation est numérotée ! \\ + +Que donne $a b c d$ ? +\end{codedisplay} + +\begin{conseil}{Repérer le mode mathématiques sous \Texmaker{}} +Il est très aisé de voir si du texte est en mode mathématiques : \Texmaker{} affiche ce texte en vert ! +\end{conseil} + +\begin{conseil}{Le conseil personnel} +J'utilise très peu l'environnement \verb?equation?, sauf quand j'ai besoin de numéroter des formules. Si je n'ai pas besoin de numérotation, l'environnement \verb?equation*? donne le même résultat que \verb?\[? et \verb?\]?. +\end{conseil} + +De ce que tu as pu observer dans l'exemple, le mode mathématiques met le texte en italique et supprime les espaces. En effet, dans ce mode, \LaTeX{} considère que tout ce qui est écrit n'est que produit (comme pour l'exemple \verb?$a b c d$?). + +L'utilisation de \verb?\[? et \verb?\]? permet d'aller à la ligne et de centrer la formule. Cette option est très pratique pour présenter un résultat ou une longue équation. + +\begin{attention}{Une question ?} +\og Si le mode mathématiques revient à mettre du texte en italique, pourquoi ne pas écrire du texte et utiliser la commande \verb?\textit? ? \fg{} \\ + +Outre l'aspect esthétique de la formule, le mode mathématiques est le seul mode qui tolère et permette d'appeler les commandes que nous verrons par la suite, pour écrire des formules mathématiques (fraction, somme, intégrale, dérivée partielle\dots{}). +\end{attention} + +S'il est possible de mélanger le mode mathématiques avec du texte grâce au \$, c'est plus délicat avec les autres commandes, tant pour l'écriture en italique que pour l'absence d'espace. Mais il existe une solution. + +\section{Vers les espaces insécables} + +\label{espaces_insecables}Pour pouvoir librement écrire du texte dans le mode mathématiques, la commande \verb?\text{texte_à_écrire}? est très utile. \textbf{\color{BrickRed}C'est vraiment la commande la plus simple qui existe : à utiliser en priorité pour ce genre de situation !} \\ + +Mais, tu peux aussi avoir envie de jouer un peu sur l'espacement entre les différents symboles, si tu trouves qu'ils sont trop rapprochés. Il existe alors des commandes bien plus efficaces et pratiques que \verb?\hspace{}? pour le mode mathématiques. + +Ces commandes portent le nom d'\textbf{espaces insécables} -- insécables car \LaTeX{} ne peut y toucher et se plie à la volonté de l'utilisateur. \textbf{Ces espaces sont utilisables aussi bien dans le mode mathématiques que sur du texte normal.} + +Ils permettent aussi de bien imposer l'espace souhaité et évite d'avoir un symbole ou un signe de ponctuation qui se balade seul en début de phrase. Nous pouvons relever : + +\begin{itemize}[label = \ding{118}] +\begin{multicols}{2} \raggedcolumns +\item \verb?\!? : espace\!très\!petit, + +\item \verb?\,? : espace\,fin, + +\item \verb?\:? : espace\:moyen, + +\item \verb?~? (tilde) : espace~normal, \columnbreak + +\item \verb?\;? : espace\;large, + +\item \verb?\quad? : espace\quad très \quad large, + +\item \verb?\qquad? : espace \qquad encore \qquad plus \qquad large. +\end{multicols} +\end{itemize} + +\vspace{\baselineskip} + +Toutefois, si j'utilisais initialement les espaces insécables à outrance, ils peuvent vite se révéler pénibles à écrire. Il faut donc généralement faire confiance à \LaTeX{} pour la mise en forme et \textbf{les utiliser avec parcimonie.} + +Personnellement, je les utilise surtout, par exemple, après le symbole $\forall$ (\verb?\forall?) car l'espacement est très faible. \`A toi de choisir ta préférence : + +\begin{table}[H] +\centering +\begin{tabular}{rcl} +$\forall x$ & \textit{vs} & $\forall\,x$ \\ +\verb?$\forall x$? & \textit{vs} & \verb?$\forall\,x$? +\end{tabular} +\end{table} + +\begin{codedisplay}{Commande \texttt{\text} et espaces insécables} +Nous obtenons donc $x + y = 3$ et $y = 2$ donc : \[x = 1 \text{ (obvious)}\] +% Présence d'un espace au début dans \text : séparation du texte de l'équation + +% Utiliser \quad aussi possible : exemple d'utilisation assez fréquent +Nous obtenons alors : \[x = 1 \quad \text{et} \quad y = 2\] +\end{codedisplay} + +Si jamais tu veux appliquer un espace insécable de manière définitive sur une commande \LaTeX{}, il existe des moyens de remplacer la définition initiale de la commande par la même avec l'espace insécable. + +Ainsi, tu continuerais à écrire \verb?$\forall x$? mais le résultat serait identique à \verb?$\forall\,x$?. Il faut procéder de la manière suivante dans le préambule : + +\begin{code}{Changement de la définition d'une commande} +% Renommer la commande initiale (sinon bug : boucle infinie) +\let\oldforall\forall +% Modification de la commande +\renewcommand{\forall}{\oldforall\,} +\end{code} + +Bref, après cette brève initiation aux mathématiques, allons \emph{vraiment} écrire des formules mathématiques. + +\section{Des exemples de formules} + +Avant de se lancer, les mathématiques n'échappent pas à la règle : il faut charger des packages avant de commencer. + +Après plusieurs recherches, je recommande \verb?amsmath?, \verb?amsfonts? et \verb?amssymb?. Il semblerait que ces trois packages suffisent pour traiter 95 \% des formules mathématiques. Commençons donc par un premier exemple : + +\begin{codedisplay}{Les premiers symboles mathématiques} +% Ajout au préambule ! +%\usepackage{amsmath, amsfonts, amssymb} + + +Indice : $i_2$ \\ +% Encadrement avec des {} +$i_{13}$ différent de $i_13$ \\ + +Exposant : $i^3$ ou $i^{13}$ \\ + +Fraction : $\frac{x}{y}$ \\ + +Racine carrée : $\sqrt{13}$ \\ +Racine énième : $\sqrt[n]{13}$ \\ + +Mix de formules (exemple) : $\sqrt{\frac{a}{b}}$ +\end{codedisplay} + +Pardon ? Il n'y en a pas assez ? Ok, navré, poursuivons : + +\begin{codedisplay}{D'autres symboles mathématiques} +Intégrale : $\int_0^{13} f(x)\,dx$ \\ +% Attention aux bornes : les {} sont vite oubliées +Somme : $\sum_{i = 13}^n x^i$ \\ + +\'Equation : $x + y - z = 3 \times t + f$ \\ +% Symbole +, - et = au clavier ; \times pour un produit + +$x < y$, $y \leq z$, $z \geqslant c$, $c > d$ mais $d \neq f$ alors que $f \simeq g$ ! \\ +% D'autres symboles - A toi de voir si tu préfères \leq à \leqslant (idem pour \geq) +\end{codedisplay} + +Ok pour toi ? Comment ? J'ai oublié de mentionner les lettres grecques ? Toutes mes excuses. Les voici : + +\begin{codedisplay}{Les lettres grecques} +Les lettres grecques ? Facile : $\alpha$, $\beta$, $\mu$, etc. \\ + +En majuscules ? $\Omega$, $\Delta$, $\Lambda$, etc. +% Ne fonctionne pas pour toutes les majuscules : \Alpha entraîne une erreur +\end{codedisplay} + +Si jamais tu souhaites connaître la liste exacte des commandes pour écrire les lettres grecques, la voici : + +\begin{table}[H] +\caption{La liste complète des lettres grecques sous \LaTeX{}} +\begin{tabular}{*{8}l} +$\alpha$ & \verb?\alpha? & $\eta$ & \verb?\eta? & $\xi$ & \verb?\xi? & $\tau$ & \verb?\tau? \\ +$\beta$ & \verb?\beta? & $\theta$ & \verb?\theta? & $\pi$ & \verb?\pi? & $\upsilon$ & \verb?\upsilon? \\ +$\gamma$ & \verb?\gamma? & $\vartheta$ & \verb?\vartheta? & $\varpi$ & \verb?\varpi? & $\phi$ & \verb?\phi? \\ +$\delta$ & \verb?\delta? & $\kappa$ & \verb?\kappa? & $\rho$ & \verb?\rho? & $\varphi$ & \verb?\varphi? \\ +$\epsilon$ & \verb?\epsilon? & $\lambda$ & \verb?\lambda? & $\varrho$ & \verb?\varrho? & $\chi$ & \verb?\chi? \\ +$\varepsilon$ & \verb?\varepsilon? & $\mu$ & \verb?\mu? & $\sigma$ & \verb?\sigma? & $\psi$ & \verb?\psi? \\ +$\zeta$ & \verb?\zeta? & $\nu$ & \verb?\nu? & $\varsigma$ & \verb?\varsigma? & $\omega$ & \verb?\omega? \\ \\ +$\Gamma$ & \verb?\Gamma? & $\Lambda$ & \verb?\Lambda? & $\Sigma$ & \verb?\Sigma? & $\Psi$ & \verb?\Psi? \\ +$\Delta$ & \verb?\Delta? & $\Xi$ & \verb?\Xi? & $\Upsilon$ & \verb?\Upsilon? & $\Omega$ & \verb?\Omega? \\ +$\Theta$ & \verb?\Theta? & $\Pi$ & \verb?\Pi? & $\Phi$ & \verb?\Phi? +\end{tabular} +\end{table} + +\begin{conseil}{Utiliser \Texmaker{}} +Que ce soit pour les lettres grecques ou plein d'autres éléments mathématiques, \Texmaker{} offre des raccourcis sur le côté gauche de la fenêtre. \\ + +N'hésite pas à aller jeter un coup d'\oe{}il au début. Je trouve que c'est mieux de taper les commandes mais il faut bien les avoir vues une ou deux fois avant pour savoir qu'elles existent. +\end{conseil} + +\begin{attention}{Une question ?} +\og J'ai tenté un \verb?mathrm? sur une lettre grecque pour enlever son ``caractère italique'' mais ça n'a pas fonctionné\dots \fg{} \\ + +Ah, j'ai affaire à un petit malin (qui a le mérite d'être allé fouiner une nouvelle commande). Tout d'abord, \verb?\mathrm? est une commande qui ne fonctionne qu'en mode mathématiques et qui permet de redresser le texte (enlever l'italique). Il faut donc bien écrire : \begin{center} \verb?$\mathrm{\mu}$? \end{center} + +Cependant, \verb?mathrm? ne fonctionne pas dans le cas des lettres grecques. C'est pourquoi tu peux ajouter le package suivant : \verb?upgreek?. Il permet d'écrire les lettres grecques droites. La commande \verb?$\upmu$? est censée fonctionner. \\ + +\textbf{Attention,} ce package ne concerne pas toutes les lettres grecques ! \verb?\upOmega? ne fonctionne pas car $\Omega$ est déjà considérée comme droite. Cette commande est donc à manier avec prudence et qu'en cas de nécessité absolue : les lettres grecques en italique rendent déjà très bien. +\end{attention} + +Bon, je crois que nous avons déjà pas mal fait le tour. J'ai bâillonné l'élève curieux qui voulait savoir comment améliorer l'affichage de la fraction, de la somme et de l'intégrale : nous allons traiter ce point immédiatement. + +\section{L'affichage et les délimiteurs} + +Tu l'as peut-être remarqué : écrire une somme doit donner un résultat un peu différent de ce que tu peux lire sur cette page. Il doit en aller de même si tu écris une intégrale ou un empilement de fraction : \[\sum_k x^k \quad \int_0^x (ft)\,dt \quad \frac{\cfrac{a}{b}}{\cfrac{c}{d}}\] + +Pour avoir un affichage ``normal'', il faut indiquer à \LaTeX{} de forcer toutes les équations en mode mathématiques avec l'affichage \verb?displaystyle?. + +La commande \verb?\everymath{\displaystyle}? \textit{juste après} \verb?\begin{document}? suffit donc pour avoir le même rendu que moi\dots{} sauf pour les fractions. Pour ces dernières, il faut utiliser la commande \verb?\cfrac{x}{y}? ou \verb?\dfrac{a}{b}? Dès lors, l'affichage de tes équations devrait être meilleur : + +\begin{code}{Forcer l'affichage} +% Toujours dans le préambule +%\usepackage{amsmath, amsfonts, amssymb} + + +\everymath{\displaystyle} % Commande indispensable ! + +Somme : $\sum_k x^k$ \\ + +Intégrale : $\int_0^x (ft)\,dt$ \\ + +Fractions : $\frac{\frac{a}{b}}{\frac{c}{d}} \neq +\cfrac{\cfrac{a}{b}}{\cfrac{c}{d}}$ +\end{code} + +Bien, maintenant que les choses sont correctement posées, tu peux avoir le meilleur rendu au monde mais \LaTeX{} reste toujours extrêmement puissant, à condition de le lui dire. + +En effet, écrire $(\cfrac{a}{b})$ et $\left( \cfrac{a}{b} \right)$ sont deux choses totalement différentes. \LaTeX{} est donc capable d'adapter la taille des parenthèses, crochets, accolades et autres, en mode mathématiques, et toujours à condition de le lui signaler. Cette particularité est appelé un \textit{délimiteur}. + +\begin{regles}{Les règles élémentaires des délimiteurs} +\begin{enumerate}[label = \textbf{\color{BrickRed}Règle \no\arabic*{} :}, leftmargin = *] +\item Un délimiteur n'existe qu'en mode mathématiques. + +\item \textbf{Un délimiteur entrant implique un délimiteur sortant.} + +\item Un délimiteur entrant est défini par la commande \verb?\left? suivi du nom du délimiteur ; pour le sortant, de même avec \verb?\right?. + +\item Si tu ne veux pas afficher un délimiteur, il faut utiliser la commande \verb?\left.? ou \verb?\right.? (il y a un point à la fin). +\end{enumerate} +\end{regles} + +Voyons de suite les noms des délimiteurs et leur fonctionnement avec un exemple : + +\begin{codedisplay}{Les délimiteurs en action} +% Toujours dans le préambule +%\usepackage{amsmath, amsfonts, amssymb} + + +Parenthèses : $\left( \cfrac{a}{b} \right)$ \\ +Crochets : $\left[ \cfrac{a}{b} \right]$ \\ +Mix possible : $\left( \cfrac{a}{b} \right]$ \\ +% Aucun problème tant que la règle 2 est respectée + +Accolade à gauche : $\left\{ \cfrac{a}{b} \right.$ \\ +Accolade à droite : $\left. \cfrac{a}{b} \right\}$ \\ + +Bonus $\left\langle \left\lbrace \cfrac{a}{b} \right\rbrace \right\rangle$ \\ +% \lbrace ou \rbrace équivalent à \{ ou \} +% Selon moi : \{ plus logique +\end{codedisplay} + +Il faut aussi savoir que les délimiteurs sont parfois inutiles : + +\begin{table}[H] +\centering +\begin{tabular}{rcl} +$(a \times b)$ & \textit{vs} & $\left( a \times b \right)$ \\ +\verb?$(a \times b)$? & \textit{vs} & \verb?$\left( a \times b \right)$? +\end{tabular} +\end{table} + +Les délimiteurs sont donc pratiques et intéressants à utiliser dès lors qu'il y a un ``étage'' dans l'équation. Autrement, mieux vaut les éviter, pour simplifier l'écriture des équations et réduire les erreurs. \\ + +C'est bon ? Pas de questions ? Ouah, je dois commencer à bien expliquer les choses pour une fois ! La suite ? Une petite escale dans le monde des matrices\dots{} + +\section{Les matrices} + +Je préfère le répéter au cas où mais il faut naturellement employer le mode mathématiques. En revanche, pas besoin de nouveaux packages. Tout est déjà inclus avec les trois de base (\verb?amsmath?, \verb?amsfonts? et \verb?amssymb?). + +Ce n'est pas compliqué mais c'est aussi soumis à quelques règles. Je préfère donc bien les poser maintenant car nous en aurons besoin un peu plus loin dans ce guide : + +\begin{regles}{Règles de base pour les matrices -- Introduction aux tableaux} +\begin{enumerate}[label = \textbf{\color{BrickRed}Règle \no\arabic*{} :}, leftmargin = *] +\item Il faut considérer une matrice $n \times m$ comme un tableau vide à $n \times m$ cases. + +\item Une matrice est générée par l'environnement \verb?pmatrix?. + +\item Les colonnes sont séparées par une esperluette ``\&'' (touche \keys{1} sous \Windows{}). + +\item Le passage à la ligne suivante se fait grâce à \verb?\\?. +\end{enumerate} +\end{regles} + +De même, ne nous privons pas d'un petit exemple pour comprendre et digérer le tout : + +\begin{codedisplay}{Les matrices -- 1\up{ers} exemples} +% Toujours dans le préambule +%\usepackage{amsmath, amsfonts, amssymb} + + +Matrice 2 x 2 : $\begin{pmatrix} +a & b \\ c & d +\end{pmatrix}$ \\ + +Matrice 2 x 4 : \[\begin{pmatrix} +a & b & c & d \\ +e & f & g & h +\end{pmatrix}\] +\end{codedisplay} + +Il restera toujours des cas un peu plus délicats à traiter : + +\begin{codedisplay}{Les matrices -- Cas plus technique} +% Toujours dans le préambule +%\usepackage{amsmath, amsfonts, amssymb} + + +Matrice à trou : \[\begin{pmatrix} +1 & 1 & \cdots & 1 \\ +1 & 2 & \cdots & 2 \\ +\vdots & \vdots & \ddots & \vdots \\ +1 & 2 & \cdots & n +\end{pmatrix}\] +\end{codedisplay} + +Comme indiqué dans les règles, il faut donc utiliser le symbole \verb?&? pour changer de colonne et la commande \verb?\\? pour passer à la ligne suivante. Si l'espace entre les \verb?&? est optionnel, il est quand même recommandé pour faciliter la relecture de ton code. + +Surtout au début, pour des matrices plus complexes comme des matrices à trou, il ne faut pas hésiter à faire un dessin pour bien visualiser l'agencement des différents éléments de la matrice. \\ + +Il n'existe pas qu'un seul environnement pour écrire des matrices. Nous pouvons relever : + +\begin{itemize}[label = \ding{118}] +\begin{multicols}{2} +\item \verb?matrix? : aucun délimiteurs ; + +\item \verb?pmatrix? : parenthèses ; + +\item \verb?vmatrix? : barres verticales ; + +\item \verb?Vmatrix? : doubles barres verticales ; + +\item \verb?bmatrix? : crochets ; + +\item \verb?Bmatrix? : accolades. +\end{multicols} +\end{itemize} + +\vspace{\baselineskip} + +Un bon exemple de création de commande avec plusieurs arguments intervient ici. J'ai eu un jour à rédiger un corrigé d'exercices de physique. Ce corrigé contient énormément de vecteurs. J'ai donc inventé la commande \verb?vcol? de la manière suivante : \begin{center}\verb?\newcommand{\vcol}[3]? \\ +\verb?{\begin{pmatrix} #1 \\ #2 \\ #3 \end{pmatrix}}?\end{center} + +\noindent{}qui s'appelle de cette façon : \verb?$\vcol{a}{b}{c}$?. Plus pratique, n'est-ce pas ? Je te garantis que c'est vrai, surtout que tu dois écrire un très grand nombre de fois un vecteur colonne sur la même page ! \\ + +Bon, finissons-en avec les mathématiques sous \LaTeX{} par la présentation et l'alignement des équations. + +\section{Aligner des équations} + +Comme une image sera plus parlante que des mots, j'aimerais obtenir ce résultat : \\ + +\label{alignement-maths}\og Nous cherchons $a$ tel que : \begin{align*} +P(\mu \in I) & = 1 - \alpha \\ + & = 0,9 \intertext{car l'énoncé indique que $1 - \alpha = 0,9$} + & = P \left( \cfrac{\bar{X} - \mu}{S} \sqrt{n - 1} \in \left[ -\cfrac{a}{S} \sqrt{n - 1}\,;\,\cfrac{a}{S} \sqrt{n - 1} \right] \right) \\ + & = 2 \mathcal{S}_{n - 1} \left( \cfrac{a}{S} \sqrt{n - 1} \right) - 1 +\end{align*} + +Nous pouvons donc conclure par\footnote{Si c'est du chinois pour toi, je te rassure, ce sont des statistiques !} : \[\left\{ \begin{array}{rcl} +I & = & [74,98 - 0,0428\,;\,74,98 + 0,0428] \\ +n & = & 20 \\ +1 - \alpha & = & 0,9 +\end{array} \right. \quad \text{. \fg{}}\] + +\vspace{\baselineskip} + +Pour obtenir ce résultat avec des équations bien alignées, tu dois utiliser l'environnement \verb?align? (ou \verb?align*? pour éviter la numérotation de chaque ligne). + +\begin{attention}{\textbf{Ne pas utiliser \verb?eqnarray? !!!}} +Après avoir vagabondé sur Internet et essayé différents rendus, je préfère utiliser \verb?align?. Après d'autres recherches, Lars \textsc{Madsen} préconise lui aussi très fortement l'usage de \verb?align? et recommande de bannir toute utilisation de \verb?eqnarray? (un autre environnement pour aligner des équations)\footnote{Article disponible sur : \url{http://www.tug.org/pracjourn/2006-4/madsen/madsen.pdf}.}. \\ + +S'il y a donc un point à retenir : \textbf{\og Avoid \verb?eqnarray? ! \fg{}} et utilise bien l'environnement \verb?align?. +\end{attention} + +Pour le second résultat avec des accolades, il faut utiliser les délimiteurs et un tableau avec l'environnement \verb?array?. + +Si \verb?array? fonctionne en mode mathématiques, \textbf{fais attention :} \verb?align? s'emploie sans ! C'est parti pour un exemple. Reproduisons le cas présent en page \pageref{alignement-maths} : + +\begin{codedisplay}{Aligner des équations -- 1\up{ère} partie} +% Toujours dans le préambule +%\usepackage{amsmath, amsfonts, amssymb} + + +Nous cherchons $a$ tel que : \begin{align*} +P\,(\mu \in I) & = 1 - \alpha \\ + & = 0,9 \intertext{car l'énoncé indique que $1 - \alpha = 0,9$} + & = P \left( \cfrac{\bar{X} - \mu}{S} \dots{} \right) \\ + & = 2 \mathcal{S}_{n - 1} \left( \cfrac{a}{S} \dots{} \right) +\end{align*} +\end{codedisplay} + +Que relevons-nous de concret sur ce premier cas de figure ? \begin{itemize}[label = \ding{118}] +\item l'environnement \verb?align? (ou \verb?align*?) utilise un \verb?&? \textbf{-- et un seul --} comme point de repère pour l'alignement. C'est pourquoi il est plutôt recommandé de le placer avant le signe \verb?=? ; + +\item une nouvelle ligne est annoncée par un saut de ligne \verb?\\?, comme pour une matrice ; + +\item la commande \verb?\intertext{texte}? permet d'ajouter une remarque entre 2 équations. Notons au passage l'absence (volontaire) de saut de ligne (\verb?\\?) : \verb?\intertext? entraîne déjà un espacement suffisant ; + +\item plus anecdotique : la commande \verb?\mathcal{texte}? permet de ``transformer'' les caractères (utilisation d'une autre police adaptée aux symboles mathématiques). \\ +\end{itemize} + +\begin{codedisplay}{Aligner des équations -- 2\up{nde} partie} +% Toujours dans le préambule +%\usepackage{amsmath, amsfonts, amssymb} + + +Nous pouvons donc conclure par : \[\left\{\begin{array}{rcl} +I & = & [74,98 \dots{} ] \\ +n & = & 20 \\ +1 - \alpha & = & 0,9 +\end{array} \right.\] +\end{codedisplay} + +Nous constatons que l'environnement \verb?array? fonctionne de manière très similaire aux matrices. Il faut indiquer le nombre de colonnes via des lettres (\verb?l?, \verb?c? ou \verb?r?). + +Le nombre de lettres correspond au nombre de colonnes et le nom parle de lui-même pour positionner le contenu à l'intérieur de la colonne : \verb?left?, \verb?center? ou \verb?right?. + +L'utilisation d'un délimiteur est parfaitement envisageable (et recommandé) pour avoir l'accolade de taille variable à gauche. \textbf{L'usage du mode mathématiques devient dès lors obligatoire et justifie l'emploi de l'environnement \verb?array? au lieu d'\verb?align?.} \\ + +Enfin, si jamais tu désires avoir une résolution d'équations avec un seul numéro global comme référence (ce que ne permet pas l'environnement \verb?align?), tu peux procéder de la façon suivante : + +\begin{codedisplay}{Des équations -- Un numéro} +% Toujours dans le préambule +%\usepackage{amsmath, amsfonts, amssymb} + + +\begin{equation} +\begin{split} +x & = y + z \\ + & = 13 +\end{split} +\end{equation} +\end{codedisplay} + +Il faut donc utiliser l'environnement \verb?equation? pour passer en mode mathématiques avec un numéro pour l'équation, puis utiliser l'environnement \verb?split? pour écrire tes équations bien alignées. + +L'environnement \verb?split? fonctionne de la même manière que l'environnement \verb?align? (ou \verb?align*?). \\ + +Que vais-je bien pouvoir t'expliquer désormais ? Et surtout, comment vais-je bien pouvoir remplir le bas de cette page avant de passer au prochain chapitre\dots{} \\ + +\begin{center} +\begin{minipage}{0.5\linewidth} +\includegraphics[width = \linewidth]{Aide_LaTeX5.png} +\end{minipage} +\hfill +\begin{minipage}{0.45\linewidth} +Tu auras le droit à un gâteau si tu me croises un jour et que tu me donnes l'origine de cette image. Et il y a une référence dans cette référence\dots{} \textit{\#{}The cake is a lie !} +\end{minipage} +\end{center} \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p2-regles.tex b/info/guide-latex-fr/Chapitres/p2-regles.tex new file mode 100644 index 0000000000..18493be0a1 --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p2-regles.tex @@ -0,0 +1,185 @@ +\chapter{Les règles de base} + +\section{Les règles pour faire du \LaTeX{}} + +Ces règles sont officieuses : je les ai élaborées à partir de mon expérience personnelle avec \LaTeX{}. Elles restent donc pragmatiques et peuvent paraître un peu farfelues mais sont importantes à mes yeux : + +\begin{regles}{Les 5 règles pragmatiques} +\begin{enumerate}[label = \textbf{\color{BrickRed}Règle \no\arabic*{} :}, leftmargin = *] +\item Tout est possible en \LaTeX{}\footnote{Y compris écrire des partitions de musique : \url{http://fr.wikibooks.org/wiki/LaTeX/\%C3\%89crire_de_la_musique}}. + +\item La règle \no{}1 est toujours vraie. + +\item \LaTeX{} implique d'écrire des commandes soit des lignes de code. Aérer et ordonner son code en facilite la relecture. + +\item La voie de la perfection en \LaTeX{} passe par une recherche régulière sur Internet. + +\item Si tu rencontres des difficultés, il ne faut pas hésiter à demander des conseils. +\end{enumerate} +\end{regles} + +Passons maintenant sur des règles plus concrètes vis-à-vis de l'écriture d'un code \LaTeX{}. + +\section{Les 3 règles d'or en \LaTeX{}} + +Pour écrire du code \LaTeX{}, il existe 3 règles, suffisamment importantes à mon sens pour être en or : + +\begin{regles}{Les 3 règles d'or en \LaTeX{}} +\begin{enumerate}[label = \textbf{\color{BrickRed}Règle d'or \no\arabic*{} :}, leftmargin = *] +\item Toute commande \LaTeX{} débute par un \textit{backslash} ``\verb?\?''. + +\Windows{} : \keys{\AltGr + 8} + +\Apple{} : \keys{\Alt + \shift + /} + +\item Tout texte concerné par une commande \LaTeX{} est délimité par des accolades ``\{'' et ``\}''. + +\Windows{} : \keys{\AltGr + 4} et \keys{\AltGr + =} + +\Apple{} : \keys{\Alt + (} et \keys{\Alt + )} + +\item Toute commande \LaTeX{} qui comprend un \verb?begin? finit par un \verb?end?. + +Ce genre de structure s'appelle un \textbf{environnement}. +\end{enumerate} +\end{regles} + +Il s'agit donc, selon moi, de la base pour écrire du code \LaTeX{}. Respecter ces règles permet d'éviter un bon nombre d'erreurs, nombreuses quand tu débutes. + +Ces 3 règles prendront leur sens sous peu, quand nous allons mettre en forme notre document et commencer à faire du \LaTeX{} (cf. \ref{mise-forme} \nameref{mise-forme}, p. \pageref{mise-forme}). + +\section{La base d'un document \LaTeX{}} + +\label{documentclass}Pour commencer, démarrons un fichier \LaTeX{} : ouvrons \Texmaker{}, créons un nouveau fichier et enregistrons-le au format \verb?.tex?\footnote{Pour information/rappel, un fichier \LaTeX{} possède toujours l'extension \verb?.tex?}. \\ + +\begin{attention}{Codes \LaTeX{} fournis} +\textbf{Tout au long de ce guide, des exemples de code \LaTeX{} sont fournis dans des encadrés verts clairs. Ils ont été testés par mes soins avec le moteur PDF\LaTeX{} : tout devrait donc fonctionner aussi de ton côté.} + +Toutefois, la copie du code depuis ce guide au format PDF semble encore présenter quelques lacunes : saut de ligne lors d'une coupure (ligne de code trop longue), apostrophe différente de celle présente sous \Texmaker{}\dots{}. Des erreurs lors de la génération du document PDF peuvent alors survenir. \\ + +\`A toi de voir si tu préfères recopier chaque ligne de code -- ce qui facilite la mémorisation et l'apprentissage selon moi -- ou si tu préfères copier-coller et habilement utiliser la fonction \og Remplacer \fg{} de \Texmaker{}. +\end{attention} + +\vspace{\baselineskip} + +La base d'un document \LaTeX{} est la suivante : + +\begin{code}{La base d'un document \LaTeX{}} +\documentclass[options]{classe} + +% Préambule + + +\begin{document} + +% Ici s'écrit notre texte +% Notons que le symbole "%" permet de mettre un commentaire + +\end{document} + +Tout ce que j'écris après \end{document} n'a aucun intérêt et ne sera pas interprété par LaTeX. +\end{code} + +Plusieurs points importants sont à retenir : + +\begin{itemize}[label = \ding{213}] +\item \verb?\documentclass? permet de définir le type de document (appelé \og \textit{classe} \fg{} en \LaTeX{}) sur lequel tu vas travailler ; + +\item la zone entre \verb?\documentclass? et \verb?\begin{document}? s'appelle le préambule. Je décris cette partie en \ref{preambule} \nameref{preambule}, p. \pageref{preambule} ; + +\item un premier exemple d'illustration de la règle d'or \no{}3 : un \verb?begin? implique un \verb?end?. + +Seuls le texte et les commandes \LaTeX{} écrits entre \verb?\begin{document}? et \verb?\end{document}?, hormis les commentaires, sont interprétés par \LaTeX{} lors de sa création du fichier PDF final ; + +\item tout ce qui peut être écrit après \verb?\end{document}? n'est pas pris en compte par \LaTeX{}. \\ +\end{itemize} + +Que mettre maintenant dans la ligne \verb?\documentclass? ? Il s'agit ici de définir le type de document à mettre en forme. En \LaTeX{}, le terme consacré est \og \textit{classe} \fg{}. Définir la classe d'un document \LaTeX{} revient à utiliser un gabarit spécifique pour le document, défini par défaut dans le code source de \LaTeX{}, et entièrement personnalisable par la suite si besoin. \\ + +Il existe plusieurs classes, à renseigner à l'endroit où il y a écrit \verb?classe? dans mon exemple générique : \verb?report? pour taper des rapports ; \verb?article? pour des articles scientifiques ; \verb?book? pour des livres et \verb?letter?, tu as compris je pense, pour des lettres. + +La partie \verb?options? permet ensuite de renseigner toutes les options propres à une classe. Les plus communs sont la taille du papier (A4 : \verb?a4paper?, A5 : \verb?a5paper?) ainsi que la taille de police de base (\verb?10pt?, \verb?11pt? ou \verb?12pt?). Mais il en existe d'autres, en fonction des classes utilisées. \\ + +\textbf{Personnellement, je recommande de commencer un nouveau document} par \verb?\documentclass[a4paper, 12pt]{report}?. Ce choix convient pour 90~\% des cas : ainsi, le risque de problème est moindre. \textcolor{orange}{Toutefois, si tu as un petit rapport d'une vingtaine de pages à rédiger, la classe \verb?article? constitue aussi un choix judicieux.} + +Néanmoins, il faut bien garder à l'esprit que d'autres options de présentation de document existe (\verb?book?, \verb?article? ou \verb?letter?). Ces derniers peuvent toujours servir. + +\begin{conseil}{Pour aller plus loin} +Des explications plus précises et poussées (toutes les options de \verb?report?, \verb?article?, etc.) sont disponibles à \url{http://fr.wikibooks.org/wiki/LaTeX/Les_classes}. \\ + +Ce qu'il faut bien comprendre et surtout retenir, c'est que \textbf{la forme finale de ton document est intrinsèquement liée à sa classe et aux options choisies.} +\end{conseil} + +\begin{attention}{Une question ?} +\og Et si je veux changer la police en 14pt, comment faire ? \fg{} \\ + +Ah, je vois que le fond de la classe suit. J'aborde ce point en \ref{mise-forme} \nameref{mise-forme}, p. \pageref{mise-forme}. +\end{attention} + +C'est bon ? Toujours là ? Tu verras, avec de la pratique, les bases vont rentrer. Plus qu'un dernier point un peu théorique à aborder et nous passerons à la pratique. Promis ! + +\section{Les packages} + +\label{preambule}Si le lecteur curieux ne s'est pas encore empressé de faire des essais, je lui recommande d'essayer le code suivant :\footnote{Les sauts de ligne sont importants pour la lisibilité (règle pragmatique \no{}3).} + +\begin{code}{Un premier essai} +\documentclass[a4paper, 12pt]{report} + + +\begin{document} + +J'aime écrire en \LaTeX{} ! + +\end{document} +\end{code} + +Si jamais tu ne sais pas quoi faire du code, je ne peux que t'inviter à te rendre en page \pageref{compilation_intro}. Tu y trouveras tout un chapitre consacré à la compilation sous \LaTeX{}, soit l'étape pour transformer ton code en un PDF ! \\ \\ + +Normalement, suite à la compilation, tu as dû obtenir : \begin{center} J'aime crire en \LaTeX{} ! \end{center} + +Analysons le résultat. La règle d'or \no{}1 commence à prendre du sens : une commande \LaTeX{} commence par un \textit{backslash} ``\verb?\?'' (ou contre-oblique pour les puristes). Cette commande me permet d'écrire le mot \og LaTeX \fg{} d'une manière plus élégante. + +Par contre, aucune trace du ``é''. C'est bizarre : moi j'arrive à l'écrire sans souci ! C'est parce que tu n'as pas dit à \LaTeX{} d'écrire en \texttt{UTF-8}\footnote{L'\texttt{UTF-8} est un codage de caractères informatiques, qui tolère les accents : \url{http://fr.wikipedia.org/wiki/UTF-8}.} ! \\ + +Pour ce faire, il faut dire à \LaTeX{} de charger des options supplémentaires. Dans le jargon \LaTeX{}, ces options sont appelées des \textit{packages}. Dans la littérature française, le terme de \og paquetages \fg{} est parfois employé. + +\textbf{Les packages sont toujours renseignés dans le préambule,} soit entre les lignes \verb?\documentclass[options]{classe}? et \verb?\begin{document}?. Pour charger un package, il faut utiliser la commande : \begin{center} \verb?\usepackage[options_du_package]{nom_du_package}? \end{center} + +Pour rédiger des documents en français, il est recommandé de remplir le préambule de la manière suivante : + +\begin{code}{Un exemple qui fonctionne bien} +\documentclass[a4paper, 12pt]{report} + +\usepackage{lmodern} % Police standard sous LaTeX : Latin Modern +% (alternative à la police d'origine développée par Donald Knuth : Computer Modern) +\usepackage[french]{babel} % Pour la langue française +\usepackage[utf8]{inputenc} % Pour l'UTF-8 +\usepackage[T1]{fontenc} % Pour les césures des caractères accentués + + +\begin{document} + +J'aime écrire en \LaTeX{} ! + +\end{document} +\end{code} + +Je sens la curiosité briller dans ton regard donc je vais essayer de te donner un peu plus de détails que les commentaires fournis\footnote{Les explications qui suivent proviennent du site \url{http://blog.dorian-depriester.fr/latex/mais-a-quoi-bon-servent-les-packages-fontenc-et-inputenc}} : \begin{itemize}[label = \ding{118}] +\item le package \verb?inputenc?, avec l'option \verb?utf8?, permet de prendre en compte l'utilisation de caractères accentués dans le fichier source (soit ton fichier \verb?.tex?). Concrètement, \verb?inputenc? se contente en fait de faire lui-même la conversion entre les caractères accentués et les commandes d'accentuation propres à \LaTeX{} ; + +\item si \verb?inputenc? gère l'affichage des caractères accentués, la césure reste catastrophique ! Pour indiquer au compilateur les règles de césure pour les mot accentués, il faut donc utiliser le package \verb?fontenc?, avec l'encodage \verb?T1? en option ; + +\item là encore, le résultat est loin d'être parfait. Le fait de charger \verb?fontenc? remplace les polices par défaut par des fontes de type 3, c'est-à-dire non vectorielles. En clair, si tu zoomes sur un caractère accentué de ton PDF, il sera pixélisé. D'où le chargement en amont de la police \textit{Latin Modern}, via le package \verb?lmodern? ; + +\item enfin, pour s'adapter à la langue de Molière, le package \verb?babel? avec l'option \verb?french? est indispensable ! \\ +\end{itemize} + +\begin{attention}{Une question ?} +\og Pourquoi dire à \LaTeX{} d'aller chercher des options alors que rien n'a été précisé pour la commande \verb?\LaTeX{}?, par exemple ? \fg{} \\ + +Tout simplement parce qu'il s'agit d'une commande présente de base dans le code source de \LaTeX{}. Il n'y a donc pas besoin de charger quoi que ce soit au préalable. \\ + +Sache aussi que les packages sont construits par les utilisateurs \LaTeX{}. C'est pourquoi tout est possible avec \LaTeX{} : tout est modifiable ou n'attend qu'à être créé. +\end{attention} + +C'est bon ? Toujours de la partie ? Dis-toi que, désormais, tu vas enfin pouvoir écrire des paragraphes. Passons donc à la pratique ! \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p2-tableaux.tex b/info/guide-latex-fr/Chapitres/p2-tableaux.tex new file mode 100644 index 0000000000..87061e64b5 --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p2-tableaux.tex @@ -0,0 +1,309 @@ +\chapter{Les tableaux et boîtes sous \LaTeX{}} + +\label{chap-table}\lettrine{S}{ynthétiser} l'information n'est pas toujours évident. Et pourtant, un bon tableau suffit parfois à véhiculer un message ou à lister des éléments. Voyons comment en créer sous \LaTeX{}. \\ + +\input{./Chapitres/code-base} + +\section{Conventions} + +C'est le passage un peu rébarbatif du guide mais qu'il faut rappeler si tu t'intéresses un peu à la mise en forme de documents. Les conventions que je vais énoncer ci-après proviennent à l'origine du guide du package \verb?booktabs?\footnote{Disponible sur : \url{https://www.ctan.org/pkg/booktabs}.}, qui permet d'améliorer la qualité des tableaux sous \LaTeX{}. + +\begin{regles}{Les conventions pour rédiger des tableaux} +{\noindent\huge\bfseries\color{gray!75}\og} + +Tu ne feras pas de graves erreurs si tu te rappelles à tout moment de +deux simples commandements : \begin{enumerate} +\item Ne jamais, au grand jamais, utiliser de filets verticaux. + +\item Ne jamais utiliser de filets doubles. \\ +\end{enumerate} + +Ces commandements peuvent sembler extrêmes mais en des années d'expérience je +n'ai jamais trouvé un bon argument pour passer outre. + +Par exemple, si tu estimes que les informations dans la moitié gauche d'une table sont si différentes de celles de la droite qu'il faut les séparer par une ligne verticale, alors tu devrais plutôt utiliser deux tables. + +Le second commandement est très, très occasionnellement violé. [\dots{}] \\ + +Il y a trois autres conseils que je pourrai citer ici car ils sont si peu connus en dehors des cercles des typographes et éditeurs professionnels : \begin{enumerate} +\item Place les unités dans l'en-tête de la colonne (pas dans le corps de la table). + +\item Fais toujours précéder un point décimal (une virgule décimale en français) par un chiffre ; donc 0.1 (ou 0,1) et pas simplement .1 (,1). + +\item N'utilises pas de signes \og ditto \fg{} ou toute convention analogue pour répéter une valeur précédente. Dans la plupart des cas, un blanc fait aussi bien l'affaire. Sinon, répètes la valeur. \\ +\end{enumerate} + +Est-ce que c'est moi qui suis pédant ? Ces derniers conseils sont de plus en plus souvent ignorés dans les travaux publiés. Pour moi, ceci montre simplement que la typographie est celle d'un amateur. + +{\hfill\huge\bfseries\color{gray!75}\fg} \\ + +\begin{flushright} +Guide du package \verb?booktabs? + +\url{https://www.ctan.org/pkg/booktabs} +\end{flushright} +\end{regles} + +Maintenant que les conventions sont posées, voyons désormais comment créer un tableau. + +\section{Création de tableaux} + +Nativement, tous les éléments sont disponibles sous \LaTeX{} pour créer des tableaux extrêmement simples. Pour ce faire, il faut utiliser l'environnement \verb?tabular?. + +Si tu te souviens bien de la construction de l'environnement \verb?array? (tableaux en mode mathématiques), tu vas vite te rendre compte que le fonctionnement de base de l'environnement \verb?tabular? (tableaux en mode texte) est identique. Un petit exemple, comme toujours : + +\begin{codedisplay}{Premiers tableaux} +\begin{tabular}{cc} +Centrage & Ici aussi \\ +Ok ! & $\alpha = 13$ +\end{tabular} \\ \\ + +\begin{tabular}{ll} \hline +Tableau & simple \\ \hline +sous & \LaTeX{} \\ \hline +\end{tabular} +\end{codedisplay} + +Comme tu peux le constater, je ne t'ai pas menti : la construction est rigoureusement identique à celle de l'environnement \verb?array?. La seule différence ? Comme il s'agit d'un tableau en mode texte, il est tout à fait licite d'introduire un mode mathématiques local (avec des \verb?$?) pour écrire des mathématiques dans une cellule du tableau. + +Pour la séparation avec un filet\footnote{Terme consacré apparemment : c'est l'équivalent d'un ``trait''.} horizontal, il faut donc appeler la commande \verb?\hline? \textbf{après} un saut de ligne (hormis au début du tableau). + +\begin{attention}{Une question ?} +\og Par rapport à ton exemple, mes tableaux sont plus resserrés. Pourquoi n'avons-nous pas le même résultat ? \fg{} \\ + +Question très pertinente : j'ai en effet une corde supplémentaire à mon arc. J'ai indiqué dans le \textbf{préambule} de ce guide une commande qui impacte tous mes tableaux et permet de les aérer un peu plus. Cette commande est la suivante : \begin{center} \verb?\renewcommand{\arraystretch}{1.3}? \end{center} + +Elle permet d'agrandir la hauteur minimale d'une ligne, ce qui permet d'aérer les tableaux. Le coefficient de \verb?1.3? est un choix personnel : libre à toi de le modifier à ta convenance. +\end{attention} + +\begin{conseil}{La petite astuce} +Si jamais tu as un ``grand nombre'' de colonnes à déclarer lors de la création de ton tableau, il existe un petit raccourci. + +Au lieu d'écrire \verb?c...c? (\verb?N? fois), tu peux écrire \verb?*{N}{|c}|?. Ainsi, tu crées \verb?N? colonnes centrées. Pratique, non ? +\end{conseil} + +Si tu veux des options plus poussées sur les tableaux (fusion de cellules, remplissage, mise en gras d'une colonne entière\dots{}), je te renvoie à la 3\up{ème} partie de ce guide où tu peux trouver des réponses. Internet peut aussi t'aider si besoin. + +Sache encore que, dès l'instant où tu arpentes le chemin d'une personnalisation très poussée et sophistiquée, tu risques de perdre beaucoup de temps à faire en sorte que le code \LaTeX{} fonctionne. Avec les éléments de base que je viens de te présenter, j'estime que tu peux déjà faire 70 \% des tableaux nécessaires. + +Pour les 30 \% restants, à titre indicatif et si tu es curieux, tu peux te tourner vers les packages suivants : \verb?array?, \verb?booktabs?, \verb?longtable? et \verb?multirow? (fusion de lignes ; fusion de colonnes possible de base avec la commande \verb?\multicolumn?). \\ + +Maintenant que les éléments de base ont été présentés, passons à un autre élément important. + +\section{Insérer une légende} + +Avoir un tableau, c'est bien. Avoir un tableau avec une légende, c'est mieux. Et avoir une légende avec une numérotation automatique, c'est encore mieux ! Fort heureusement, \LaTeX{} propose tous ces éléments nativement. + +Je ne vais pas rentrer dans les détails du concept, que je développe plus amplement dans le prochain chapitre. Sache juste, pour commencer, qu'il te faut procéder de la manière suivante : \begin{enumerate} +\item Insertion du tableau dans un environnement \verb?table?. + +\item Insertion de la légende avant ou après le tableau (au choix) grâce à la commande \verb?\caption{Légende}?. \\ +\end{enumerate} + +Un exemple minimaliste serait alors le suivant : + +% codedisplay impossible ici (ou emploi de \begin{table}[H]) +\begin{code}{Tableau \& légende} +\begin{table} +\centering +\caption{Légende du tableau} +\begin{tabular}{ccc} +Tableau & de & test \\ \hline +sous & \LaTeX{} +\end{tabular} +\end{table} +\end{code} + +Passons maintenant à un autre élément disponible sous \LaTeX{} pour faire un peu de mise en forme sans nécessairement passer par un tableau : les boîtes. + +\section{Les boîtes} + +\subsection*{La théorie} + +Si tu peux tout à fait utiliser un tableau pour encadrer des formules, des images ou du texte, il existe d'autres solutions plutôt complètes et personnalisables sous \LaTeX{}. En l'occurrence, parlons des boîtes. \\ + +Sous \LaTeX{}, tout tient dans une boîte : les lettres, les paragraphes, les tableaux, les images, les équations\dots{} Bref, tout ! Concrètement, une \textit{box} (boîte) est le terme technique en \LaTeX{} pour un contenant invisible qui peut contenir soit un élément visible, soit une autre boîte, soit rien du tout. Ensuite, chaque boîte est connecté grâce à de la \textit{glue} (colle), qui détermine la séparation entre les boîtes. + +Dans un document traditionnel, les ``lettres-boîtes'' sont donc collées à d'autres pour former des mots, eux-mêmes collés élastiquement à d'autres mots pour former des phrases. Ces phrases sont découpées en lignes et placées dans un paragraphe (boîte encore une fois), écarté ou collé à d'autres paragraphes de manière élastique là encore, cette fois pour former des pages suffisamment aérées et remplies. + +C'est donc ainsi que \LaTeX{} construit un document et les pages qui le compose, en collant les boîtes ensembles et grâce aux règles de base (natives) et à celles définies par l'utilisateur. \\ + +Concrètement, une boîte ressemble à : + +\begin{figure}[H] +\begin{tikzpicture}[arrow/.style = {<->, > = Triangle}, legend/.style = {align = center, text width = 2cm}] +\node[draw, font = \fontsize{110pt}{55pt}\selectfont, inner sep = 0pt] (lettre) {p}; + +\def\shift{7pt} +\draw[arrow, Green] ([xshift = -\shift]lettre.north west) -- node[left, legend] {hauteur \textbackslash\texttt{height}} ([shift = {(lettre.west)}, xshift = -\shift]lettre.base); +\draw[arrow, cyan] ([shift = {(lettre.west)}, xshift = -\shift]lettre.base) -- node[left, legend] {profondeur \\ \textbackslash\texttt{depth}} ([xshift = -\shift]lettre.south west); +\draw[arrow, orange] ([yshift = \shift]lettre.north west) -- node[above, legend] {largeur \\ \textbackslash\texttt{width}} ([yshift = \shift]lettre.north east); +\draw[arrow, red, very thick] ([shift = {(lettre.west)}]lettre.base) -- ([shift = {(lettre.east)}]lettre.base) node[right] {ligne de base}; +\end{tikzpicture} +\hfill +\begin{tikzpicture} +\node[draw = Green, very thick] { + \begin{tikzpicture}[every node/.style = {draw = cyan, font = \fontsize{90pt}{45pt}\selectfont, anchor = south west, inner sep = 0pt}] + \node (lettreA) {I}; + \node (lettreB) at (lettreA.south east) {n}; + \node (lettreC) at (lettreB.south east) {d}; + \node (lettreD) at (lettreC.south east) {i}; + \end{tikzpicture} +}; +\end{tikzpicture} +\caption{Schéma d'une boîte et de ses composants} +\end{figure} + +Les différentes dimensions de la boîte sont contenues au sein de 4 variables : \verb?\width? pour la largeur de la boîte ; \verb?\height? pour sa hauteur ; \verb?\depth? pour sa profondeur ; et \verb?\totalheight? pour sa hauteur totale soit \verb?\height? + \verb?\depth?. + +Ces variables ne peuvent être utilisées que pour des boîtes. Passons à un peu de pratique pour voir comment appeler les boîtes en question et se servir de ces dimensions qui leur sont propres. + +\subsection*{La pratique} + +Tout d'abord, les \verb?framebox? constituent la base en \LaTeX{}. La commande est assez simple : \begin{center}\verb?\framebox[largeur][pos]{texte}?\end{center} + +\noindent{}avec les choix suivants pour \verb?pos?\footnote{Par défaut, si rien n'est indiqué pour \verb?pos?, le texte est centré à l'intérieur de la boîte.} : \begin{itemize}[label = \ding{118}] +\item \verb?l? pour aligner \verb?texte? sur la gauche de la boîte ; +\item \verb?r? pour aligner \verb?texte? sur la droite de la boîte ; +\item \verb?s? pour aligner \verb?texte? sur toute la longueur de la boîte. \\ +\end{itemize} + +Si \verb?texte? fait référence à l'objet à encadrer (texte, image, formule\dots{}), \verb?largeur? fait référence à la largeur de la boîte. Tu peux renseigner une unité de distance (\verb?13pt?, \verb?215mm?, etc.). + +Naturellement, si tu renseignes \verb?1cm? alors que le texte en fait 2, le résultat risque de ne pas être satisfaisant. Les dimensions propres aux boîtes peuvent alors être utilisées, comme \verb?\width? : + +\begin{codedisplay}{Utilisation des \texttt{framebox}} +\framebox[1cm]{Texte} \\ +\framebox[13pt][r]{Test} \\ +\framebox[45mm][s]{Plus grande boîte} \\ + +\framebox[\width]{Pile poil !} \\ +\framebox[2\width]{Espacement} \\ +\framebox[\linewidth]{Largeur de la page} +\end{codedisplay} + +Comme démontré avec le dernier cas de figure, la longueur \verb?\linewidth?, présente nativement sous \LaTeX{}, peut être utilisée pour créer une boîte de largeur égale à celle de la page.\footnote{La notion de \og longueur \fg{} sous \LaTeX{} est abordée plus amplement en page \pageref{longueurs}.} \\ + +Il existe un raccourci pour appeler plus simplement une \verb?framebox? avec la commande \verb?\fbox?. Aucune option n'a besoin d'être indiqué, juste la partie \verb?texte?. La taille de la boîte s'adapte alors au contenu : + +\begin{codedisplay}{Le petit raccourci sympathique} +\fbox{Un peu de texte} \\ +\fbox{Un peu plus de texte} \\ + +\fbox{Des maths : $i = \sqrt{169}$} +\end{codedisplay} + +\begin{conseil}{De l'utilisation des \texttt{fbox}} +Les \verb?fbox? sont très pratiques, pour comprendre comment un paragraphe ou une image est agencé, ainsi que la taille qu'il occupe. \\ + +Lors de montages ou de nouvelles créations, il peut se révéler très utile d'encadrer les différents éléments grâce à des \verb?fbox? pour comprendre comment \LaTeX{} les agence et pouvoir apporter les correctifs nécessaires afin d'avoir le résultat souhaité ! +\end{conseil} + +Tu trouveras aussi dans la littérature les \verb?makebox?, dont l'appel est rigoureusement identique à une \verb?framebox?. Il s'agit tout simplement d'une \verb?framebox? sans cadre, ce qui ne présente que peu d'intérêt selon moi. + +Techniquement, la \verb?framebox? est construite à partir d'une \verb?makebox? mais j'ai trouvé plus judicieux de présenter directement la première. Bien, terminons avec une autre boîte bien utile. + +\subsection*{La plus utile} + +La boîte qui se révèle bien utile pour faire quelques montages reste la \verb?parbox? et l'environnement qui lui est associé : la \verb?minipage?. Sa syntaxe est la suivante : \begin{center}\verb?\parbox[ext][hauteur][int]{largeur}{texte}?\end{center} + +\noindent{}avec \verb?hauteur? et \verb?largeur? respectivement la hauteur et la largeur de la boîte (distance manuelle comme \verb?13mm? ou une longueur propre aux boîtes comme \verb?\width? ou une longueur \LaTeX{} comme \verb?\linewidth?). + +\begin{codedisplay}{Fonctionnement de base d'une \texttt{parbox}} +\parbox{13mm}{Texte} \\ + +\fbox{ % Intérêt de la fbox ! +\parbox{\linewidth-2cm}{Partie A \\ Partie B} +} +\end{codedisplay} + +Ensuite, \verb?ext? correspond à l'alignement externe de la \verb?parbox? par rapport à la ligne de base\footnote{Ligne sur laquelle reposent les lettres.}, avec les choix suivants : \begin{itemize}[label = \ding{118}] +\item \textcolor{Green}{\verb?m? (par défaut) ou si aucune option n'est donnée} pour centrer la boîte sur la ligne de base ; +\item \verb?b? pour aligner le bas (\textit{bottom}) de la boîte sur la +ligne de base ; +\item \verb?t? pour aligner le haut (\textit{top}) de la boîte sur la +ligne de base. +\end{itemize} + +\begin{codedisplay}[sidebyside = false, listing and text]{Alignement externe} +A : \parbox[b]{2cm}{Par. 1 \\ Par. 2} \hfill +B : \parbox{2cm}{Par. 3 \\ Par. 4} \hfill +C : \parbox[t]{2cm}{Par. 5 \\ Par. 6} +\end{codedisplay} + +Enfin, \verb?int? désigne l'alignement interne de la boîte, pour pouvoir positionner verticalement le texte dans la boîte, \textbf{sous réserve qu'une hauteur ait été indiquée}. Elle peut prendre quatre valeurs : \begin{itemize}[label = \ding{118}] +\item \verb?b? pour repousser le texte vers le bas de la boîte ; +\item \verb?t? pour situer le texte en haut de la boîte ; +\item \textcolor{Green}{\verb?c? (par défaut) ou si aucune option n'est donnée} pour centrer verticalement le texte ; +\item \verb?s? pour étirer verticalement le texte. \\ +\end{itemize} + +Toutefois, comme tu as pu le constater avec mes exemples, il n'est pas évident de gérer plusieurs paragraphes dans une \verb?parbox?. Il est même impossible d'y introduire d'autres environnements ! + +\label{minipage-explications}Il faut donc inclure le tout dans l'environnement équivalent : \verb?minipage?. L'appel à cet environnement se fait de la manière suivante, avec des paramètres identiques à ceux d'une \verb?parbox?, mais dans un ordre différent : \begin{verbatim} +\begin{minipage}[ext][hauteur][int]{largeur} +texte +\end{minipage} +\end{verbatim} + +Il convient donc de définir correctement une \verb?minipage? si tu veux éviter les erreurs. Dès l'instant où tu renseignes une des options non obligatoires (\verb?ext?, \verb?hauteur? ou \verb?int?), il faut toutes les indiquer ou le rendu ne sera pas conforme : + +\begin{codedisplay}{Appel de \texttt{minipage}} +\begin{minipage}{0.8\linewidth} +Texte avec un \\ +retour à la ligne ! +\end{minipage} \\ \\ + +\fbox{ +\begin{minipage}[m][1cm][b]{2cm} +Lorem +\end{minipage} +} \& ipsum +\end{codedisplay} + +\begin{attention}{De l'utilisation des \texttt{minipage}} +\textcolor{red}{\bfseries{}Il ne faut pas utiliser une \verb?minipage? pour simplement avoir un texte sur 2 colonnes !} + +D'abord, le résultat ne correspondra pas à tes attentes, ne sera pas esthétique et sera difficile à gérer. Ensuite, \LaTeX{} met à disposition l'option \verb?twocolumn? lors de la définition de la classe. \\ + +Une \verb?minipage? sert donc exclusivement pour des montages, par exemple une image à côté d'une autre image ou d'un texte, comme nous aurons l'occasion de le voir par la suite. + +Enfin, il faut savoir qu'il n'y a pas d'alinéa dans une \verb?minipage? : dans sa définition, par défaut, l'indentation est nulle. +\end{attention} + +\subsection*{Le petit bonus} + +Si tu veux continuer à arpenter le chemin des boîtes et avoir encore plus de personnalisation, je te recommande le package \verb?fancybox?. Il permet, entre autres, d'ajouter du surlignage et de l'ombrage aux boîtes. \\ + +Mais il existe un autre package bien plus puissant\dots{} + +\section{Le Saint-Graal des boîtes} + +Découvert lors de la rédaction de la première version de ce guide (été 2016), le package \verb?tcolorbox? est extrêmement complet et permet une personnalisation totale des boîtes. Tous les encadrés que tu as pu rencontrer jusqu'à présent dans ce guide sont générés grâce à ce package ! + +Si tu fouines un peu sur Internet, tu devrais trouver la documentation officielle\dots{} allez, je suis gentil, je te donne le lien : \url{http://fr.lmgtfy.com/?q=tcolorbox+help}. + +C'est actuellement 500 pages complexes mais qui assez illustrées, pour te permettre donc de réaliser des boîtes aussi jolies que celles présentes dans ce guide et bien plus. Beaucoup plus ! \\ + +Pour te donner un premier aperçu, voici un exemple extrêmement simple : + +\begin{codedisplay}{Première utilisation de \texttt{tcolorbox}} +% Ajout dans le préambule +%\usepackage{tcolorbox} + +\begin{tcolorbox}[colframe = orange, colback = orange!50, boxrule = 2pt, arc = 6pt, title = {Un titre}, coltitle = black] +J'adore ce package ! \\ +De toute mon âme ! +\end{tcolorbox} +\end{codedisplay} + +Et il ne s'agit que la partie émergée de l'iceberg ! La documentation officielle décrit toutes les options disponibles, les différentes boîtesmise à disposition, la création d'environnement pour appeler ses propres boîtes\dots{} \\ + +Mais je crois m'être légèrement emporté. Je reviens sur ce package plus en détail dans la partie suivante. Le but de cette partie reste de te présenter les bases sous \LaTeX{}. + +Passons désormais à un point plus sympathique mais que j'avais envie de garder pour la fin. Oh, mais je suis persuadé que tu l'attendais depuis un petit moment : comment insérer une image ! \\ + +\begin{figure}[H] +\centering +\includegraphics[width = 0.75\linewidth]{Aide_LaTeX6.png} +\end{figure} \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p2-texte.tex b/info/guide-latex-fr/Chapitres/p2-texte.tex new file mode 100644 index 0000000000..9cc8be7ebe --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p2-texte.tex @@ -0,0 +1,803 @@ +\chapter{Gestion du texte et mise en forme} + +\label{chap-texte}\lettrine{M}{aintenant} que nous connaissons les règles de base pour faire du \LaTeX{} et que les packages ont été introduits, nous allons pouvoir commencer à écrire du texte sous \LaTeX{}. \\ + +\input{./Chapitres/code-base} + +\section{Notre premier texte} + +Prêt à enfin écrire un roman ? Bon, nous allons attaquer en douceur. Et, petit à petit, tu auras suffisamment d'outils à ta disposition pour profiter des fonctionnalités offertes par \LaTeX{}. Poursuivons avec le code suivant : + +\begin{code}{Un nouvel essai} +J'aime écrire en \LaTeX{} ! Vraiment ! Surtout avec des phrases longues qui prennent de la place. % Saut de ligne + +Et toi ? Qu'en est-il ? \\ % Beaucoup d'espace et un nouveau symbole (\\) + + +Pardon ? Tu débutes ? Tu vas voir, c'est facile. % Double saut de ligne +\end{code} + +Tu devrais normalement obtenir : + +\begin{boite}{Le résultat}{Cerulean} +J'aime écrire en \LaTeX{} ! Vraiment ! Surtout avec des phrases longues qui prennent de la place. + +Et toi ? Qu'en est-il ? \\ + + +Pardon ? Tu débutes ? Tu vas voir, c'est facile. +\end{boite} + +Nous pouvons relever plusieurs points : + +\begin{itemize}[label = \ding{213}] +\item un saut de ligne à l'écran est interprété comme un retour à la ligne ; + +\item la commande \verb?\\? permet un véritable saut de ligne et donc de créer un nouveau paragraphe ; + +\item les espaces et saut de ligne intempestifs ne sont pas pris en compte ; + +\item les alinéas sont automatiques (pas besoin de faire de tabulations). \\ +\end{itemize} + +Contrairement à Word, à première vue, \LaTeX{} possède une façon un peu curieuse d'aller à la ligne ou de faire un saut de ligne (nouveau paragraphe). Mais rappelons que la raison d'être de \LaTeX{} est de séparer le fond de la forme : nous tapons le fond pour laisser \LaTeX{} le mettre en forme lors de la compilation. + +Mais l'utilisateur garde le contrôle et peut influer sur la forme grâce à des commandes \LaTeX{}. C'est bien ce qui se passe ici. Si l'utilisateur veut un retour à la ligne, il doit sauter une ligne dans son code. S'il veut sauter une ligne, il doit utiliser la commande \verb?\\? et sauter une ligne dans son code. \\ + +Nous avons aussi pu remarquer que \LaTeX{} gère tous les problèmes liés à l'espacement entre les mots. Il est donc inutile de faire un grand nombre d'espaces ou de saut de ligne pour aérer son texte. Encore une fois, ce n'est pas la politique de \LaTeX{} et il faut passer par des commandes si besoin. + +Si le saut de ligne est disponible grâce à la commande \verb?\\? -- qui, au passage, est cumulable --, l'utilisateur peut jouer sur l'espacement vertical grâce à la commande \verb?\vspace{longueur}?, avec \verb?v? pour vertical et \verb?space? pour espace. Il en va de même pour un espacement horizontal avec la commande \verb?\hspace{longueur}?. \\ + +La longueur est totalement libre, à condition de renseigner correctement l'unité : \verb?13mm? ou \verb?215pt?, par exemple. Concrètement, nous pouvons procéder de la manière suivante : + +\begin{codedisplay}{Gérer l'espacement} +J'aime toujours écrire en \LaTeX{}. + +\vspace{1cm} + +Surtout \hspace{8mm} quand je laisse du blanc ! +\end{codedisplay} + +Si j'ai rapidement annoncé qu'il était possible de cumuler la commande \verb?\\? pour engendrer la création de plusieurs sauts de ligne, il existe aussi une longueur\footnote{Nous aurons l'occasion de revenir sur ce point en page \pageref{longueurs}.} définie nativement sous \LaTeX{} et qui correspond à un saut de ligne. + +Cette longueur est disponible grâce à la commande \verb?\baselineskip?. Voyons son utilisation sur un cas pratique : + +\begin{codedisplay}{Sauts de ligne et longueur \texttt{baselineskip}} +Il est possible de sauter plusieurs \\ \\ % Double saut de ligne + +lignes \\ \\ \\ % Triple saut de ligne + +ainsi. + +\vspace{2\baselineskip} % Double saut de ligne + +Cette solution est aussi possible, tout comme celle-ci ! \\[\baselineskip] % Double saut de ligne + +Bref, beaucoup de façons de sauter des lignes, de manière plutôt concise. +\end{codedisplay} + +Enfin, sache qu'il est possible de rentrer des valeurs négatives, comme \verb?-13mm? ou \verb?-215pt?. C'est surtout pratique pour remonter du texte lors de montages, voire des images si besoin. Je recommande juste de limiter cette pratique : tu risques de perdre beaucoup de temps à ajuster ton document. + +\begin{attention}{Une question ?} +\og Que se passe-t-il si je vais juste à la ligne dans mon code \LaTeX{} ? \fg{} \\ + +Rien. Seul un saut de ligne à l'écran compte comme un retour à la ligne. + +Cependant, pour obtenir un retour à la ligne sur ton document, tu peux aussi terminer ta phrase par la commande \verb?\\? et faire un simple retour à la ligne dans ton code. +\end{attention} + +Bon, maintenant que nous avons toutes les cartes en main pour écrire des paragraphes, passons à de la mise en forme. + +\section{Un peu de mise en forme} + +\label{mise-forme}Comme je l'ai déjà annoncé, avec \LaTeX{}, tu rédiges le fond et lui laisses le soin de s'occuper de la forme. Si nous en avons eu un premier aperçu, tu vas pouvoir t'en rendre véritablement compte dès à présent. + +Si tu veux mettre un texte en gras ou en italique, il faut donc l'indiquer à \LaTeX{} par le biais de commandes bien spécifiques : + +\begin{codedisplay}{\textbf{Gras} \& \textit{italique}} +\textbf{texte en gras} \\ + +\textit{texte en italique} +\end{codedisplay} + +Comme tu peux le constater, tu écris la commande -- qui débute par un \textit{backslash} -- et tu encadres le texte concerné par des accolades. Fort heureusement, \LaTeX{} ne propose pas uniquement le gras et l'italique : + +\begin{table}[H] +\caption{Les différentes possibilités de mise en forme du texte} +\label{table-mise-forme} +\centering +\begin{tabular}{lll} \toprule +Texte & Rendu & Environnement \\ \midrule +\verb?\textbf{gras}? & \textbf{gras} & \verb?bfseries? \\ +\verb?\textit{italique}? & \textit{italique} & \verb?itshape? \\ +\verb?\emph{emphase}? & \emph{emphase} & \verb?em? \\ +\verb?\textsl{penché}? & \textsl{penché} & \verb?slshape? \\ +\verb?\textsc{Petites Capitales}? & \textsc{Petites Capitales} & \verb?scshape? \\ +\verb?\textsf{sans empattement}? & \textsf{sans empattement} & \verb?sffamily? \\ +\verb?\texttt{machine}? & \texttt{machine (à écrire)} & \verb?ttfamily? \\ \bottomrule +\end{tabular} +\end{table} + +Je vais revenir plus en détail sur l'emphase, avec la commande \verb?\emph{texte}?, qui ne correspond \emph{pas} à de l'italique. + +En typographie, l'emphase permet d'accentuer un mot ou une phrase grâce à un style ou une police différente de celle du reste du texte. Essayons avec un exemple répandu de faux texte : le \textit{lorem ipsum}\footnote{Pour plus de renseignements : \url{http://fr.wikipedia.org/wiki/Faux-texte} et \url{http://fr.lipsum.com/}.}. + +\begin{codedisplay}{L'emphase ou \textit{emphasis}} +\textbf{Lorem ipsum dolor sit amet, consectetur adipiscing elit. \emph{Nunc est leo, facilisis non nisi eget,} auctor eleifend metus.} \\ + +\textit{Vestibulum porttitor, ligula vitae suscipit bibendum, \emph{lorem ligula vestibulum ipsum,} sed ultricies tellus dolor sit amet odio.} +\end{codedisplay} + +Comme tu peux le constater, \LaTeX{} a adapté la mise en forme du texte avec emphase en fonction de la mise en forme du paragraphe ! \\ + +Voyons maintenant sur un exemple comment augmenter ou réduire la taille de la police, ainsi que les notes de bas de page : + +\begin{codedisplay}{Taille de police et note de bas de page} +% Différentes tailles de texte +{\tiny tiny} {\scriptsize scriptsize} {\footnotesize footnotesize} {\small small} {\normalsize normalsize} {\large large} {\Large Large} {\LARGE LARGE} {\huge huge} {\Huge Huge} \\ + +% Note +Note de bas de page\footnote{La note en question.}. +\end{codedisplay} + +Comme tu peux le constater, \LaTeX{} gère lui-même la numérotation des notes de bas de page, sans rien avoir besoin de lui indiquer. Pratique, n'est-ce pas ? \\ + +Si jamais tu as besoin d'appliquer une mise en forme ou une taille de police à plusieurs paragraphes, \LaTeX{} ne saura pas interpréter le changement de paragraphe. Dans ce cas, il faut passer par un environnement\footnote{Pour la mise en forme du texte, utiliser les noms définis dans la colonne \og Environnement \fg{} de la \tablename{} \ref{table-mise-forme}.} : + +\begin{codedisplay}{Mise en forme et taille -- Environnement} +\begin{Large} +Paragraphe 1. + +Paragraphe 2. \\ +\end{Large} + +\begin{bfseries} +Paragraphe 3. + +Paragraphe 4. +\end{bfseries} +\end{codedisplay} + +\LaTeX{} propose aussi un moyen très simple pour accentuer les majuscules. Il suffit d'utiliser un \textit{backslash}, suivi de l'accent désiré. Puis, tu écris ton mot normalement, avec une majuscule. + +\begin{codedisplay}{Accentuation} +% Accent sur les majuscules +\'E, \`E, \^E et \c{C} \\ + +% "o pris dans e" +\OE{}il, c\oe{}ur +\end{codedisplay} + +Il existe aussi des commandes spécifiques pour des symboles fréquemment utilisés. Je pense notamment aux guillemets et aux points de suspension. La preuve par l'exemple : + +\begin{codedisplay}{Autres symboles utiles} + +% Guillemets +\og guillemets français \fg{} et ``guillemets anglais'' \\ + +% Points de suspension +Points de suspension\dots{} \\ + +% Tirets +Tiret court : - \\ +Tiret moyen : -- \\ +Tiret long : --- \\ + +% Esperluette - Pourcentage +\& et \textit{\&} ; \% +\end{codedisplay} + +Une liste plus complète des symboles utiles sous \LaTeX{} est disponible en annexes, p. \pageref{annexes-liste-symboles}. Nous remarquons au passage que le \textit{backslash} sert aussi de \textbf{caractère d'échappement} pour tous les symboles utilisés lors de l'écriture du code \LaTeX{} (\&, \$, \#, \_, \{ ou \} par exemple). + +\begin{conseil}{Les marges} +Les gens me demandent souvent comment modifier les marges sous \LaTeX{}. Personnellement, j'ai fini par m'habituer aux marges natives de \LaTeX{} : je les modifie donc que pour des besoins très particuliers. \\ + +Si tu tiens à savoir pourquoi les marges sont plus grandes que celles d'un document Word, c'est parce que \LaTeX{} a initialement été inventé par des Américains (conventions américaines). + +De plus, \LaTeX{} sert pour rédiger des rapports scientifiques : leur reliure demande alors une marge plus importante s'ils sont épais. \\ + +Autrement, si tu as absolument besoin de modifier les marges de ton document, je te recommande le package \verb?geometry?, ainsi que la page suivante : \url{http://fr.wikibooks.org/wiki/LaTeX/Mise_en_page#Modification_des_marges}. +\end{conseil} + +Bien, nous avons fait un premier tour d'horizon des premières possibilités offertes par \LaTeX{} pour mettre en forme le texte. Passons à un peu d'organisation. + +\section{Organiser son document} + +\subsection*{La base} + +Taper du texte brut, c'est bien. Mais mettre des titres, c'est mieux. Là encore, rien à gérer. \LaTeX{} met en forme le titre selon son importance et s'occupe de la numérotation. Par ordre d'importance, nous pouvons avoir : + +\begin{itemize}[label = \ding{213}] % Emploi de \verb?\? ou c'est le bordayl dans la structure de Texmaker +\begin{multicols}{2} \raggedcolumns +\item \verb?\?\verb?part{titre}? ; + +\item \verb?\?\verb?chapter{titre}? ; + +\item \verb?\?\verb?section{titre}? ; + +\item \verb?\?\verb?subsection{titre}? ; + +\item \verb?\?\verb?subsubsection{titre}? ; + +\item \verb?\?\verb?paragraph{titre}? ; + +\item \verb?\?\verb?subparagraph{titre}?. \\ +\end{multicols} +\end{itemize} + +\begin{attention}{\textit{Nota Bene}} +La commande \verb?\part? n'est disponible que pour un document de classe \verb?report? (cf. \ref{documentclass} \nameref{documentclass} p. \pageref{documentclass}). \\ + +De même, la commande \verb?\chapter? n'est valable que pour les classes \verb?book? et \verb?report?. +\end{attention} + +Si tu veux sauter une page, la commande \verb?\newpage? est là. Un exemple d'organisation serait donc : + +\begin{code}{Exemple d'organisation} +% Enlever les % ici + +%\part{Partie I} + +%\section{Section 1.1} + +Comment est-ce numéroté ? + +%\section{Section 1.2} + +D'une manière bizarre ! + +%\part{Partie II} + +%\chapter{Chapitre 1} + +%\section{Section 1.1} + +Lorem ipsum\dots{} + +\newpage + +Bis repetita\dots{} +\end{code} + +\subsection*{Configuration de la numérotation} + +Comme tu peux le constater, il y a quelques problèmes de numérotation. Si les compteurs tournent normalement, il faut juste donner un coup de pouce à \LaTeX{} pour faire correctement les choses. Retente le même code avec ces commandes dans le préambule : + +\begin{code}{La numérotation des titres} +% ATTENTION : écriture de ces commandes dans le PREAMBULE !!! + +% RAZ des numéros de section après un chapitre +\makeatletter\@addtoreset{section}{chapter}\makeatother + +% Pour mettre des I, II, etc. aux parties +\renewcommand{\thepart}{\Roman{part}} + +% Pour mettre des 1, 2, etc. aux chapitres +\renewcommand{\thechapter}{\arabic{chapter}} + +% Idem pour les sections et avoir le numéro de chapitre +\renewcommand{\thesection}{\thechapter.\arabic{section}} +\end{code} + +Il existe plusieurs possibilités pour numéroter les différents titres de ton document. La liste complète des commandes utilisables est la suivante : \begin{itemize}[label = \ding{118}] +\item \verb?\arabic? : pour avoir des chiffres arabes soit 1, 2, 3\dots{} ; + +\item \verb?\roman? : pour avoir des chiffres romains minuscules soit i, ii, iii\dots{} ; + +\item \verb?\Roman? : pour avoir des chiffres romains majuscules soit I, II, III\dots{} ; + +\item \verb?\alph? : pour avoir des lettres minuscules soit a, b, c\dots{} ; + +\item \verb?\Alph? : pour avoir des lettres majuscules soit A, B, C\dots{}. +\end{itemize} + +\subsection*{Titre sans numérotation} + +Enfin, dans le cas où tu veux juste écrire un titre sans numéro, il suffit d'ajouter une \verb?*? à la commande du titre : \verb?\?\verb?part*{titre}?, etc. \\ + +Bon, c'est bien gentil d'avoir des titres. Comment obtenir un sommaire désormais ? + +\section{Gestion du sommaire} + +\subsection*{La base} + +Pour une fois, nouvelle option, pas de nouveau package. Pour le sommaire, tout est déjà inclus de base dans \LaTeX{}. Pour l'afficher, il faut juste renseigner dans le code la commande \verb?\tableofcontents?, à l'endroit où tu désires placer le sommaire. + +\begin{attention}{Un problème ?} +\og J'ai lancé la compilation du sommaire mais rien ne s'affiche hormis \verb?Table des matières?. Est-ce normal ? \fg{} \\ + +Oui. Dès lors que tu génères un sommaire, il faut \textbf{toujours compiler deux fois} pour obtenir le résultat final attendu. + +\`A la première compilation, \LaTeX{} créé un nouveau fichier, d'extension \verb?.toc?, où il stocke le sommaire. \`A la seconde, il regarde si un tel fichier existe et, dans ce cas, récupère les informations pour générer le sommaire. +\end{attention} + +\begin{attention}{Une question ?} +\og Je ne veux pas lire \verb?Table des matières? mais \verb?Sommaire?. Est-ce possible ? \fg{} \\ + +Oui, tout à fait. C'est possible avec la commande suivante, dans le corps du texte, juste avant \verb?\tableofcontents? par exemple : \begin{center} \verb?\renewcommand{\contentsname}{Sommaire}? \end{center} +\end{attention} + +\subsection*{Le nec plus ultra} + +Avoir un sommaire, c'est bien. Pouvoir interagir avec, c'est encore mieux ! Pour pouvoir se déplacer rapidement dans le document grâce à un clic sur un titre du sommaire, il faut utiliser un nouveau package : \verb?hyperref?. + +Cependant, le résultat par défaut n'est pas très esthétique et peut entraîner une crise d'épilepsie aux plus sensibles, c'est pourquoi je recommande d'utiliser l'option \verb?colorlinks?\footnote{Si tu ne me crois pas, génères un sommaire avec juste le package \verb?hyperref?, sans option, et regarde le rendu du fichier PDF. Tu comprendras.}. + +Mais \verb?hyperref? va beaucoup plus loin et permet de personnaliser les options de lecture par défaut du PDF généré. C'est pourquoi je recommande d'utiliser aussi les nombreuses options comme indiqué dans l'exemple ci-après. \\ + +Ce même package permet d'indiquer des adresses Internet grâce à la commande \verb?\url{adresse_internet}?. En revanche, si certains liens sont trop longs et finissent en fin de ligne, ils sortent de la page. + +Ajouter \verb?breaklinks? dans les options du package \verb?hyperref? permet de résoudre le problème. Des fois, charger le package supplémentaire \verb?url?, avec l'option \verb?hyphens?, est obligatoire pour traiter les derniers cas de figure problématiques. + +\begin{code}{Le sommaire -- Bilan} +% Ajout au PREAMBULE +\usepackage[hyphens]{url} % Pour des césures correctes dans les URLs +\usepackage[pdfauthor = {{Prénom Nom}}, pdftitle = {{Titre document}}, pdfstartview = Fit, pdfpagelayout = SinglePage, pdfnewwindow = true, bookmarksnumbered = true, breaklinks, colorlinks, linkcolor = red, urlcolor = black, citecolor = cyan, linktoc = all]{hyperref} % Renvois -- Options Adobe/lecteur PDF + + +\begin{document} + +% Page de garde + +% Sommaire -- Penser à compiler deux fois +{ +\hypersetup{hidelinks} % Sommaire en "noir" +\renewcommand{\contentsname}{Sommaire} % Remplacer "Table des matières" +\tableofcontents % Affichage du sommaire +} + +% Si nécessaire +%\clearpage % Mieux qu'un \newpage ou des erreurs dans le sommaire parfois + +% Parties, chapitres, texte, etc. + +% Commande fournie avec le package hyperref +\url{https://www.ctan.org/} + +\end{document} +\end{code} + +Pour revenir rapidement sur les options du package \verb?hyperref?, en voici un descriptif : \begin{itemize}[label = \ding{213}] +\item \verb?pdfauthor? \& \verb?pdftitle? : pour renseigner correctement les champs des options du fichier PDF. + +Il est possible de remplir les autres champs disponibles : cf. la documentation du package \verb?hyperref?\footnote{Et comme je suis adorable, voici le lien : \url{https://www.ctan.org/pkg/hyperref}.} ; + +\item \verb?pdfstartview? \& \verb?pdfpagelayout? : pour les options d'affichage du PDF à sa lecture. + +Pour connaître toutes les options disponibles, cf. la documentation du package \verb?hyperref? ; + +\item \verb?pdfnewwindow = true? : si ton document contient un lien vers un autre fichier PDF, cliquer sur le lien entraîne l'ouverture du PDF dans un nouvel onglet (et non à la place du premier PDF) ; + +\item \verb?bookmarksnumbered? : pour les signets du lecteur PDF ; + +\item \verb?breaklinks? : pour permettre la césure des liens insérés trop longs ; + +\item \verb?colorlinks? et toutes les couleurs qui suivent : pour colorer correctement les références du document ; + +\item \verb?linktoc = all? : pour faire un renvoi du sommaire avec les numéros de page. +\end{itemize} + +\subsection*{Ajout d'un titre étoilé} + +Enfin, dans le cas des titres étoilés, ces derniers n'apparaissent pas dans le sommaire. Il existe malgré tout un moyen de l'ajouter manuellement, si tu y tiens. Cette solution requiert l'utilisation du package \verb?hyperref?, que nous connaissons déjà. + +\begin{code}{Ajout d'un titre étoilé dans le sommaire} +% Ajout dans le préambule +%\usepackage{hyperref} + + +% Ajout d'un titre sans numéro + +% Penser à enlever le % la ligne en dessous +%\section*{Introduction} % Les titres doivent correspondre + +\phantomsection % Renvoi correct dans le sommaire +\addcontentsline{toc}{section}{Introduction} % Ajout dans le sommaire + +Lorem ipsum dolor\dots{} +\end{code} + +La ligne avec la commande \verb?\addcontentsline...? sert à implémenter dans le fichier \verb?.toc? (fichier qui gère le sommaire) le titre \verb?Introduction? en tant que \verb?section? (\verb?part? si partie, \verb?chapter? si chapitre, etc.). + +Le numéro de page correspond à l'endroit où est tapée la commande, d'où son positionnement \textbf{après} \verb?\section*?, pour éviter une mauvaise numérotation si le titre étoilé débute sur une nouvelle page. + +Il faut donc faire bien attention avec cette situation pour garantir la cohérence du document : il faut renseigner le même titre dans \verb?\section*? et dans \verb?\addcontentsline...?. C'est pourquoi, personnellement, j'utilise les titres étoilés le moins possible. \\ + +Bon, maintenant que nous avons un magnifique sommaire, est-il possible d'ajouter une page de garde ? + +\section{La page de garde} + +\subsection*{La base} + +Comme pour le sommaire, il faut d'abord créer la page de garde puis indiquer à \LaTeX{} de l'afficher. Pour la créer, il faut remplir les informations suivantes : + +\begin{code}{La page de garde -- Création} +% Ajout dans le préambule ou après \begin{document} + + +% Titre +\title{Titre} +%\title{\textbf{Titre}} % Ressort mieux selon moi + +% Auteur +\author{Prénom \textsc{Nom} \\ Profession} + +% Date +\date{\today} % Date du jour (compilation du document) +%\date{date_à_afficher} % Date fixe +\end{code} + +Naturellement, tout n'a pas besoin d'être renseigné. Si tu veux uniquement le titre, tu laisses juste la commande \verb?\title{Titre}?. + +\begin{conseil}{La petite astuce} +S'il y a plusieurs auteurs dans ton document, tu peux tous les indiquer. Il faut juste les séparer par un \verb?\and?, ce qui donne : \begin{center} \verb?\author{Nom1 \and Nom2 \and Nom3}? \end{center} + +\LaTeX{} s'occupe ensuite de la mise en forme de tous ces noms. Pratique, n'est-ce pas ? +\end{conseil} + +Pour afficher la page de garde, il faut ensuite renseigner dans le corps du document la commande \verb?\maketitle?, de préférence dès le début. + +Mais, tu devrais te rendre compte, après compilation, que, si tu demandes à ton lecteur de fichier PDF d'aller à la page $N$, tu te retrouves en page $N + 1$. C'est parce que \LaTeX{} ne numérote pas la page de garde et commence ensuite la numérotation à $1$ au lieu de $2$\dots{} + +C'est peut-être un détail mais, personnellement, je trouve extrêmement irritant d'aller dans le sommaire, de trouver le numéro de page de la section qui t'intéresse, de la saisir dans ton lecteur PDF\dots{} et d'arriver à la mauvaise page ! + +Fort heureusement, il suffit d'ajouter après \verb?\maketitle? la commande \verb?\setcounter{page}{2}?, pour réajuster correctement la numérotation des pages. \\ + +S'il fallait synthétiser les différentes options de base pour la page de garde, nous pourrions alors nous servir du code suivant : + +\begin{code}{La page de garde -- Bilan} +\documentclass[a4paper, 12pt]{report} + +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\usepackage[french]{babel} +\usepackage{lmodern} + + +\begin{document} + +% Informations de la page de garde +\title{\textbf{Initiation à \LaTeX{}} \\ \textit{Pour débutants ou jeunes utilisateurs}} +\author{Adrien \textsc{Bouzigues} \\ Salarié \and John \textsc{Doe} \\ Profession} +\date{\today} + +% Générer la page de garde +\maketitle + + +% Changer le titre du résumé +%\renewcommand{\abstractname}{\Large{}\textbf{Résumé}} + +% Résumé +\begin{abstract} +Résumé du document +\end{abstract} +% Classe report : sur une page à part +% Classe article : sur la page de garde (si pas de newpage) + +\clearpage\setcounter{page}{2} + +Lorem ipsum dolor\dots{} + +\end{document} +\end{code} + +\begin{attention}{Une question ?} +\og Ce n'est pas pratique ta page de garde. C'est sobre, impossible de mettre une image ! Est-il possible d'avoir mieux \fg{} \\ + +\dots{} Tu as parfaitement raison ! Il est tout à fait possible d'avoir une page de garde plus personnelle et plus décorée. Pour satisfaire ta curiosité, je te propose une première solution ``simple'' à utiliser. \\ + +\textbf{Mais prends garde !} Dès l'instant où tu commences à arpenter ce chemin -- construire une page spécifique à partir de rien --, tu peux très vite y passer beaucoup de temps. \LaTeX{} n'est pas un outil de création graphique à la base. + +Pour un rapport officiel ou si le temps t'est précieux, je recommande d'utiliser les commandes de base que je viens de présenter. + +Autrement, tu peux te permettre, comme je le fais pour ce guide, de construire ta propre page personnalisée. Il n'y a pas une seule bonne façon de faire et tout dépend de ce que tu veux faire. +\end{attention} + +\subsection*{Personnalisation de la page de garde} + +Comme promis, voici un exemple ``simple'' pour avoir une première page de garde personnalisable. Les possibilités sont très nombreuses avec \LaTeX{} : tout dépend donc de ce que tu veux faire. + +\begin{code}{Une solution personnalisable} +\documentclass[a4paper, 12pt]{report} + +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\usepackage[french]{babel} +\usepackage{lmodern} + +\usepackage{graphicx} % Pour insérer une image (logo) +% cf. les chapitres suivants pour plus de détails + + +\begin{document} + +% Auteur : WikiBooks (http://en.wikibooks.org/wiki/LaTeX/Title_Creation) +% License : CC BY-NC-SA 3.0 (http://creativecommons.org/licenses/by-nc-sa/3.0/) +% Adaptation du document d'origine + +% Environnement titlepage : permet de créer une page de garde et de la personnaliser à volonté +\begin{titlepage} +\newcommand{\HRule}{\rule{\linewidth}{0.5mm}} % Ligne horizontale (épaisseur modifiable) + +\begin{center} % Centrer le contenu de la page +% En-têtes +\textsc{\LARGE{}Université} \\[1.5cm] +\textsc{\Large{}En-tête principal} \\[0.5cm] % Nom du cursus (par exemple) +\textsc{\large{}En-tête secondaire} \\[0.5cm] % Intitulé du cours (par exemple) + +% Titre +\HRule \\[0.6cm] +{\huge\bfseries{}Titre} \\[0.25cm] +\HRule \\[1.5cm] + +% Auteur +\begin{minipage}{0.45\linewidth} +\begin{flushleft} +\Large\textit{Auteur :} \\ +John \textsc{Smith} % Nom auteur +\end{flushleft} +\end{minipage} +\hfill +\begin{minipage}{0.45\linewidth} +\begin{flushright} +\Large\textit{Superviseur :} \\ +Dr. John \textsc{Smith} % Nom superviseur +\end{flushright} +\end{minipage} \\[2cm] + +% Si aucun superviseur, utiliser les lignes ci-après et supprimer les lignes précédentes +%\Large\textit{Auteur :} \\ +%John \textsc{Smith} \\[3cm] % Nom auteur + +% Date +{\large\today} \\[2cm] % Date : \today ou date saisie à la main + +% Logo +%\includegraphics{logo.png} \\[1cm] % Logo à utiliser +\end{center} + +\vfill % Remplir le reste de la page avec du blanc +\end{titlepage} + +\clearpage\setcounter{page}{2} + +Lorem ipsum dolor\dots{} + +\end{document} +\end{code} + +Allez, faisons une petite pause sur la mise en forme pour étudier un point un peu abstrait mais extrêmement puissant et nécessaire pour poursuivre. + +\section{Création de commandes} + +Il peut arriver que tu aies besoin de cumuler des commandes, et ce, un très grand nombre de fois. \LaTeX{} t'offre pour cela la possibilité d'en créer de nouvelles. + +Pour ce faire, il suffit d'ajouter la ligne suivante, de préférence dans le préambule même si tu peux l'insérer n'importe où dans ton document (avant le premier appel de ta nouvelle commande) : \begin{center} \verb?\newcommand{nom_commande}[nombre_arguments]{commande}? \end{center} + +\'Etudions son fonctionnement avec un exemple. Disons que je veuille mettre un mot (ou un groupe de mots) en gras et en italique. Je vais donc procéder ainsi : + +\begin{code}{Une première commande} +\documentclass[a4paper, 12pt]{report} + +\usepackage{lmodern} +\usepackage[french]{babel} +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} + +\newcommand{\grasital}[1]{\textbf{\textit{#1}}} +% Le nom de la commande commence par "\" +% La position de l'argument se fait avec un "#" et son numéro + + +\begin{document} + +J'aime le chocolat ! \\ +\grasital{J'aime le chocolat !} \\ +J'aime le \grasital{chocolat} ! + +\end{document} +\end{code} + +Note bien qu'il peut y avoir aucun argument comme plusieurs, avec une limite de 9. Si l'utilisation avec plusieurs arguments sera plus concrète lorsque nous aborderons les mathématiques, voici un cas sans argument : + +\begin{codedisplay}{Un second cas} +% Création de la commande après \begin{document} : OK +\newcommand{\SAV}{\textbf{Service Après-Vente}} + +Notre \SAV vous aide. \\ + +Grâce à notre \SAV, vous serez comblés. +\end{codedisplay} + +J'ai décidé de mettre le texte en gras, mais rien ne m'empêche en cours de rédaction de mon rapport de modifier ce choix. L'avantage ? Tu as juste à modifier la commande et, lors de la compilation, la modification se répercute sur tout le document ! Pratique, non ? + +\textbf{C'est aussi pourquoi je recommande de placer tous les \verb?newcommand? dans le préambule :} c'est plus pratique pour les retrouver s'ils sont tous au même endroit, au lieu d'être dispersés dans le document. + +\begin{attention}{Une question ?} +\og Pourquoi, dans le second cas, n'y a-t-il pas d'espaces dans le résultat entre \texttt{SAV} et \texttt{propose} ? \fg{} \\ + +Tu as l'\oe{}il ! Suite à une commande, \LaTeX{} ignore les espaces. Tu peux en ajouter un à la fin de la commande mais il y en aura alors aussi un après la virgule. \\ + +Pour indiquer à \LaTeX{} la fin de la commande, il faut donc la fermer avec des accolades. C'est ce que je fais par exemple lorsque j'écris \LaTeX{} : le code derrière est \verb?\LaTeX{}?. + +Il aurait donc fallu écrire dans mon exemple : \verb?notre \SAV{} vous? et \verb?notre \SAV{}, vous?. +\end{attention} + +Tu ne trouves pas cet aspect utile pour l'instant mais tu verras que, quand tu prendras un peu d'expérience, tu finiras par créer toi-même tes commandes pour plus de simplicité et de rapidité. \\ + +Bien, continuons. C'est quoi déjà la suite ? Ah oui, les listes. + +\section{Les listes} + +\subsection*{La base} + +Les listes (à puces ou numérotées) sont très pratiques quand il s'agit d'énumérer des éléments, faire un inventaire ou décrire des étapes. + +Les listes peuvent donc être soit \textcolor{orange}{non numérotées} (listes dites \og à puces \fg{} : tiret, rond, autres symboles), avec l'\textcolor{orange}{environnement \verb?itemize?} ; soit \textcolor{cyan}{numérotées} (numéro ou lettre), grâce à l'\textcolor{cyan}{environnement \verb?enumerate?}. \\ + +Pour définir une puce ou un numéro, il faut utiliser la commande \verb?\item?. Voyons plutôt le résultat avec un exemple : + +\begin{codedisplay}{Une liste à puces} +Détail de la chambre : + +\begin{itemize} +\item un lit ; +% Saut de ligne optionnel (aérer) + +\item une armoire ; + +\item et un bureau. \\ +% Saut de ligne (\\) licite pour aérer le texte +\end{itemize} +\end{codedisplay} + +\begin{codedisplay}{Une liste numérotées} +Pour écrire sous \LaTeX{}, il faut : + +\begin{enumerate} +\item Apprendre les bases. + +\item Pratiquer les bases. + +\item \^Etre curieux ! +\end{enumerate} + +% Imbrication des environnements (et donc des listes) possible +\end{codedisplay} + +Normalement, tu devrais avoir un résultat un peu différent du mieux : les tirets sont plus grands et tes numéros se terminent par un point et non par une parenthèse. + +Tout va bien ! J'ai juste une configuration par défaut de \LaTeX{} qui génère ce rendu. Tu peux donc constater que créer des listes sous \LaTeX{} se révèle très facile. Voyons maintenant comment les personnaliser à notre guise ? + +\subsection*{Personnalisation des listes} + +Pour personnaliser ses listes, il existe un package incontournable : le package \verb?enumitem?. Combiné avec le package \verb?pifont? pour obtenir des symboles supplémentaires et donc avoir de nouvelles puces, c'est la meilleure combinaison possible pour personnaliser simplement ses listes. + +Concrètement, le package \verb?enumitem? offre quelques options, dont les suivantes que je recommande particulièrement : \begin{itemize}[label = \ding{213}] +\item \verb?label = puce? : pour changer la puce ou la numérotation utilisée ; + +\item \verb?leftmargin = *? : pour supprimer l'indentation de la liste ; + +\item \verb?itemsep = ? : pour insérer \verb?? entre 2 puces. C'est plus commode ainsi que de devoir sauter des lignes avec \verb?\\[]? à chaque fin de puce. +\end{itemize} + +Pour ce qui est du package \verb?pifont?, son utilisation est très simple. Il faut utiliser la commande \verb?\ding{}? avec \verb?? pris dans la liste ci-après pour afficher un symbole du package. + +\begin{table}[H] +\centering +\caption{Liste des symboles du package \texttt{pifont}} +\renewcommand{\arraystretch}{1} +\resizebox{!}{52mm}{\begin{tabular}{*{7}{cc|}cc} +32 & \ding{32} & 33 & \ding{33} & 34 & \ding{34} & 35 & \ding{35} & 36 & \ding{36} & 37 & \ding{37} & 38 & \ding{38} & 39 & \ding{39} \\ +40 & \ding{40} & 41 & \ding{41} & 42 & \ding{42} & 43 & \ding{43} & 44 & \ding{44} & 45 & \ding{45} & 46 & \ding{46} & 47 & \ding{47} \\ +48 & \ding{48} & 49 & \ding{49} & 50 & \ding{50} & 51 & \ding{51} & 52 & \ding{52} & 53 & \ding{53} & 54 & \ding{54} & 55 & \ding{55} \\ +56 & \ding{56} & 57 & \ding{57} & 58 & \ding{58} & 59 & \ding{59} & 60 & \ding{60} & 61 & \ding{61} & 62 & \ding{62} & 63 & \ding{63} \\ +64 & \ding{64} & 65 & \ding{65} & 66 & \ding{66} & 67 & \ding{67} & 68 & \ding{68} & 69 & \ding{69} & 70 & \ding{70} & 71 & \ding{71} \\ +72 & \ding{72} & 73 & \ding{73} & 74 & \ding{74} & 75 & \ding{75} & 76 & \ding{76} & 77 & \ding{77} & 78 & \ding{78} & 79 & \ding{79} \\ +80 & \ding{80} & 81 & \ding{81} & 82 & \ding{82} & 83 & \ding{83} & 84 & \ding{84} & 85 & \ding{85} & 86 & \ding{86} & 87 & \ding{87} \\ +88 & \ding{88} & 89 & \ding{89} & 90 & \ding{90} & 91 & \ding{91} & 92 & \ding{92} & 93 & \ding{93} & 94 & \ding{94} & 95 & \ding{95} \\ +96 & \ding{96} & 97 & \ding{97} & 98 & \ding{98} & 99 & \ding{99} & 100 & \ding{100} & 101 & \ding{101} & 102 & \ding{102} & 103 & \ding{103} \\ +104 & \ding{104} & 105 & \ding{105} & 106 & \ding{106} & 107 & \ding{107} & 108 & \ding{108} & 109 & \ding{109} & 110 & \ding{110} & 111 & \ding{111} \\ +112 & \ding{112} & 113 & \ding{113} & 114 & \ding{114} & 115 & \ding{115} & 116 & \ding{116} & 117 & \ding{117} & 118 & \ding{118} & 119 & \ding{119} \\ +120 & \ding{120} & 121 & \ding{121} & 122 & \ding{122} & 123 & \ding{123} & 124 & \ding{124} & 125 & \ding{125} & 126 & \ding{126} \\ + & & 161 & \ding{161} & 162 & \ding{162} & 163 & \ding{163} & 164 & \ding{164} & 165 & \ding{165} & 166 & \ding{166} & 167 & \ding{167} \\ +168 & \ding{168} & 169 & \ding{169} & 170 & \ding{170} & 171 & \ding{171} & 172 & \ding{172} & 173 & \ding{173} & 174 & \ding{174} & 175 & \ding{175} \\ +176 & \ding{176} & 177 & \ding{177} & 178 & \ding{178} & 179 & \ding{179} & 180 & \ding{180} & 181 & \ding{181} & 182 & \ding{182} & 183 & \ding{183} \\ +184 & \ding{184} & 185 & \ding{185} & 186 & \ding{186} & 187 & \ding{187} & 188 & \ding{188} & 189 & \ding{189} & 190 & \ding{190} & 191 & \ding{191} \\ +192 & \ding{192} & 193 & \ding{193} & 194 & \ding{194} & 195 & \ding{195} & 196 & \ding{196} & 197 & \ding{197} & 198 & \ding{198} & 199 & \ding{199} \\ +200 & \ding{200} & 201 & \ding{201} & 202 & \ding{202} & 203 & \ding{203} & 204 & \ding{204} & 205 & \ding{205} & 206 & \ding{206} & 207 & \ding{207} \\ +208 & \ding{208} & 209 & \ding{209} & 210 & \ding{210} & 211 & \ding{211} & 212 & \ding{212} & 213 & \ding{213} & 214 & \ding{214} & 215 & \ding{215} \\ +216 & \ding{216} & 217 & \ding{217} & 218 & \ding{218} & 219 & \ding{219} & 220 & \ding{220} & 221 & \ding{221} & 222 & \ding{222} & 223 & \ding{223} \\ +224 & \ding{224} & 225 & \ding{225} & 226 & \ding{226} & 227 & \ding{227} & 228 & \ding{228} & 229 & \ding{229} & 230 & \ding{230} & 231 & \ding{231} \\ +232 & \ding{232} & 233 & \ding{233} & 234 & \ding{234} & 235 & \ding{235} & 236 & \ding{236} & 237 & \ding{237} & 238 & \ding{238} & 239 & \ding{239} \\ + & & 241 & \ding{241} & 242 & \ding{242} & 243 & \ding{243} & 244 & \ding{244} & 245 & \ding{245} & 246 & \ding{246} & 247 & \ding{247} \\ +248 & \ding{248} & 249 & \ding{249} & 250 & \ding{250} & 251 & \ding{251} & 252 & \ding{252} & 253 & \ding{253} & 254 & \ding{254} +\end{tabular}} +\renewcommand{\arraystretch}{1.3} +\end{table} + +Mais le plus appréciable avec ce package \verb?enumitem?, c'est la possibilité de configurer globalement les liste dès le préambule (\verb?\setlist?), voire d'en créer de nouvelles avec ces propres règles, puces, distances, etc. (\verb?\newlist?). + +Voici un rapide aperçu des possibilités désormais accessibles en quelques touches de clavier : + +\begin{codedisplay}{Des listes proprement personnalisables} +% Ajout dans le préambule +%\usepackage{enumitem, pifont} +%\setlist[itemize, 1]{label = {--}, itemsep = \baselineskip} +%\setlist[enumerate, 1]{label = \arabic*), itemsep = \baselineskip} + + +J'ai envie de dire : \begin{itemize} +\item une chose ; + +\item[\ding{118}] avec une puce ponctuelle ! \\ +\end{itemize} + +Je peux aussi énumérer : \begin{enumerate}[label = {\bfseries{}\'Etape \Alph* :}, leftmargin = *] +\item marcher ; + +\item lire ; + +\item écrire. +\end{enumerate} +\end{codedisplay} + +OK pour toi ? Toujours d'attaque ? Finissons désormais ce chapitre sur la gestion du texte. + +\section{Une petite touche de couleur ?} + +Nous avons vu beaucoup d'éléments de mise en page et de mise en forme du texte mais tu conviendras qu'avoir un gros pavé en noir peut parfois être rebutant à la lecture. + +Pour mettre un peu de couleur, il faut \textcolor{red}{d'abord charger le package \verb?xcolor?} puis utiliser la \textcolor{Green}{commande :} \begin{center} +\verb?\textcolor{nom_couleur}{texte}? \end{center} + +Les couleurs de base disponibles pour \verb?nom_couleur? sont alors les suivantes : + +\begin{itemize}[label = \ding{213}] +\begin{multicols}{3} +\item \textcolor{red}{\verb?red?} ; +\item \textcolor{green}{\verb?green?} ; +\item \textcolor{blue}{\verb?blue?} ; +\item \textcolor{cyan}{\verb?cyan?} ; +\item \textcolor{magenta}{\verb?magenta?} ; +\item \textcolor{yellow}{\verb?yellow?} ; +\item \textcolor{orange}{\verb?orange?} ; +\item \textcolor{violet}{\verb?violet?} ; +\item \textcolor{purple}{\verb?purple?} ; +\item \textcolor{brown}{\verb?brown?} ; +\item \verb?black? ; +\item \textcolor{darkgray}{\verb?darkgray?} ; +\item \textcolor{gray}{\verb?gray?} ; +\item \textcolor{lightgray}{\verb?lightgray?} ; +\item \colorbox{black}{\textcolor{white}{\verb?white?}}. +\end{multicols} +\end{itemize} + +\vspace{\baselineskip} % Pas de \\ dans le itemize ou déséquilibre du multicols + +Si jamais tu trouves qu'il n'y a pas assez de couleurs, tu peux utiliser l'option \verb?dvipsnames? dans le package (\verb?\usepackage[dvipsnames]{xcolor}?) puis te référer à la \textsc{Figure} \ref{dvipsnames} pour \verb?nom_couleur? : + +\begin{figure}[H] +\includegraphics[width = \linewidth]{Aide_LaTeX2.png} +\caption{Les couleurs avec dvipsnames} +\label{dvipsnames} +\end{figure} + +Enfin, si jamais tu trouves que tu n'as toujours pas assez de couleur pour laisser ton talent artistique s'exprimer, sache qu'il est possible d'en créer dans le préambule avec la commande : \begin{center}\verb?\definecolor{nom_couleur}{modèle}{def_couleur}? \end{center} + +Le \verb?modèle? correspond à \verb?RGB? par exemple et \verb?def_couleur? à \verb?255,215,0? (couleur or). Pour plus de renseignements quant à cette commande, tu peux consulter la page suivante : \url{http://fr.wikibooks.org/wiki/LaTeX/Options_de_mise_en_forme_avanc\%C3\%A9es#Mod.C3.A8les_de_couleur}. \\ + +{\bfseries\color{cyan}{}Tu peux aussi renseigner \verb?nom_couleur? ou \verb?def_couleur? par l'intermédiaire de mélanges de couleur.} Pour ce faire, il faut utiliser la \textcolor{Green}{syntaxe \verb?couleurA!x!couleurB?,} pour $\mathtt{x} \in [0\,;\,100]$, qui te permet de mélanger $\mathtt{x}$ \% de \verb?couleurA? et $(100 - \mathtt{x})$ \% de \verb?couleurB?. \\ + +Sache qu'il existe aussi des commandes comme \verb?\colorbox? ou \verb?\pagecolor?. Je te laisse aller te renseigner si tu es intéressé pour te laisser un peu en autonomie. \\ \\ + +Cette fois, nous en avons fini avec le texte et sa mise en forme. Tout d'abord, une référence s'impose : + +\begin{figure}[H] +\centering +\includegraphics[width = 0.7\linewidth]{Aide_LaTeX3.png} +\caption{Non, je ne suis pas un fan d'Evangelion !} +\end{figure} + +Toujours des nôtres ? Si tu te sens prêt, nous allons pouvoir aborder un nouveau chapitre ! \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p3-beamer.tex b/info/guide-latex-fr/Chapitres/p3-beamer.tex new file mode 100644 index 0000000000..d51bdb85d2 --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p3-beamer.tex @@ -0,0 +1,3 @@ +\chapter{Faire des présentations avec \Beamer{}} + +\label{chap-beamer}\`A venir\dots{} (peut-être 2\up{nd} semestre 2019) \ No newline at end of file diff --git a/info/guide-latex-fr/Chapitres/p3-images.tex b/info/guide-latex-fr/Chapitres/p3-images.tex new file mode 100644 index 0000000000..c19ef67a2e --- /dev/null +++ b/info/guide-latex-fr/Chapitres/p3-images.tex @@ -0,0 +1,189 @@ +\chapter{Images : de nouvelles subtilités} + +\label{chap-img-details}\lettrine{C}{omme} pour les mathématiques, l'insertion d'images sous \LaTeX{} est réalisée sans surprise et sans avoir à connaître des techniques très poussées. + +Cependant, au fur et à mesure de la rédaction de tes documents, tu constateras que tu souhaiteras améliorer certains détails. Voici donc quelques astuces supplémentaires toujours utiles ! + +\section{Une référence toute prête} + +Les références, c'est bien. Les automatiser, c'est mieux. J'étais plutôt agacé d'écrire constamment \og (cf. \textsc{Figure} \verb?? p. \verb??) \fg{}, d'autant plus que le mot \og \textsc{Figure} \fg{} peut varier selon la classe. + +Puis, j'ai découvert la commande \verb?\figurename{}? : elle contient justement le nom utilisé dans la légende. Il est donc possible d'automatiser mon problème initial grâce à une commande. \\ + +Mais c'est sans compter sur le package \verb?hyperref? qui propose déjà une commande toute prête à ce sujet : \verb?\autoref{