summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/fascicules/guide/content/ch2_organisation.tex
blob: 34ab230f48b676ca20f214c752fe195cab32a372 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
\chapter{La structure du manuel} \label{structure}
\backgroundimage{img/ch2}
\thispagestyle{chapterpage}


\newpage


\section{organisation générale}




Voici un schéma qui explique comment est organisé l'arborescence des fichiers de notre futur manuel. Cette arborescence de fichier a été  faite à l'aide d'un paquet (package) \LaTeX, le package \verb|forest| . En cherchant bien, on trouve des package sur à peu près tout ce que l'on veut.

\medskip

\begin{figure}[h]
\begin{forest}
      for tree={
        font=\ttfamily,
        grow'=0,
        child anchor=west,
        parent anchor=south,
        anchor=west,
        calign=first,
        inner xsep=7pt,
        edge path={
          \noexpand\path [draw, \forestoption{edge}]
          (!u.south west) +(7.5pt,0) |- (.child anchor) pic {folder} \forestoption{edge label};
        },
        % style for your file node 
        file/.style={edge path={\noexpand\path [draw, \forestoption{edge}]
          (!u.south west) +(7.5pt,0) |- (.child anchor) \forestoption{edge label};},
          inner xsep=2pt,font=\small\ttfamily
                     },
        before typesetting nodes={
          if n=1
            {insert before={[,phantom]}}
            {}
        },
        fit=band,
        before computing xy={l=15pt},
      }  
    [manuels
      [commons]
      [S5
      [manuel.tex,file]
      [ch1\textunderscore premier\textunderscore chapitre
        [chapitre.tex,file]
        [cours.tex,file]
        [content
           [
           crs.tex,file
           ]
           [
           act.tex,file
           ]
           [
           exos.tex,file
           ]
        ]
        [img]
      ]
      [ch2\textunderscore second\textunderscore chapitre]
      [ch3\textunderscore troisieme\textunderscore chapitre]
      ]
      [S6]
    ]
 \end{forest}
\caption{La structure des fichiers} 
\end{figure}

Le fichier \verb|manuel.tex| est celui que l'on compile pour obtenir le manuel.

Chaque chapitre se trouve dans son propre répertoire. Quand on compile le manuel, on peut décider d'y inclure les chapitres que l'on désire, dans l'ordre qu'on désire.  Dans chaque chapitre, le fichier  \verb|chapitre.tex| permet d'appeler les composants du chapitre (cours, activités, exercices). Ce fichier ne contient aucun contenu.

Dans chaque chapitre, il y a aussi un répertoire \verb|content|. C'est là où se trouve le contenu du manuel. \verb|crs.tex| contient le cours, \verb|act.tex| les activités et \verb|exos.tex| les énoncés des exercices ainsi que leurs solutions.

Lors de la compilation du manuel, on peut facilement décider d'inclure, ou d'exclure, la partie cours, activités ou exercices.

Enfin, chaque chapitre contient le fichier \verb|cours.tex|. Ce fichier permet de créer des transparents avec le cours.


\begin{lesson}
\section{Le cours}

Le cours est à placer au sein d'un environnement \verb|lesson|, c'est à dire entre la balise \verb|\begin{lesson}| et la balise \verb|\end{lesson}|.

Les paragraphes et les sous-paragraphes du cours, numérotés, sont définis avec les commandes \verb|\section{<titre>}| et \verb|\subsection{<titre>}|. Ces deux commandes existent en version étoilées  \verb|\section*{<titre>}|  et \verb|\subsection*{<titre>}| si on ne veut pas de la numérotation. Comme c'est le cas à la ligne suivante \ldots

\subsection*{Les environnements propres au cours}
Tout bon cours de mathématiques contient des définitions, des théorèmes, des propriétés et des formules :


 \begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing above text}
\begin{definition}{}
Soient $X$ et $Y$ deux ensembles; on appelle fonction définie sur l'ensemble $X$et à valeurs dans $Y$ toute opération consistant à faire correspondre à chaque élément $x$ de $X$ un élément $y$ de $Y$, qui dépend de $x$ selon une loi bien déterminée.
\end{definition}
\end{tcblisting}

 \begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing above text}
\begin{theorem}[mon_thm]{de Desargues}
Soient p, q et r trois droites distinctes concourantes ou parallèles et soient ABC et A'B'C' deux triangles tels que A et A' soient sur p, B et B' sur q et C et C' sur r.

Si (AB)//(A'B') et (AC)//(A'C') alors (BC)//(B'C').
\end{theorem}

\begin{proof}
Ici, on peut faire la démonstration.
\end{proof}

On peut par la suite faire une référence à ce \cref{mon_thm} (\nameref{mon_thm})
\end{tcblisting}


 \begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing above text}
\begin{property}{}
Si $f$ et $g$ sont deux fonctions continues par morceaux dans $[a;b]$
et si $f \leqslant g$, on a \[\int_a^b f(x) \text{d}x \leqslant \int_a^b g(x) \text{d}x  \,. \]
\end{property}
\end{tcblisting}


 \begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing above text}
\begin{formula}{de Taylor}
Si $f$ est une fonction complexe admettant dans un intervalle fermé d'extrémités $a$ et $b$ des  dérivées continues jusqu'à l'ordre $n$. Alors

\[
\begin{array}{rcl}
f(b) & = & f(a)+\frac{b-a}{1!}f'(a)+\frac{(b-a)^2}{2!}f''(a)+\ldots \\
& = & +\frac{(b-a)^{n-1}}{(n-1)! f^{(n-1)}(a)}+ \int_a^b \frac{(b-t)^{n-1}}{(n-1)!}f^{(n)}(t) \text{d}t \,.
\end{array}
\] 

\end{formula}
\end{tcblisting}


Enfin, dans tout bon cours de maths, on trouve aussi des méthodes:

 \begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing above text}
\begin{method}[quart]{La recette du quatre-quarts}

\begin{itemize}
\item Préchauffer le four à 180\degree.
\item Mélanger 250g de farine, 250g de beurre ramolli, 250g de sucre et 4 d'œufs.
\item Battre les œufs en neige.
\item Verser dans un moule À cake beurré et fariné et enfourner 45 minutes.
\end{itemize}
\end{method}


\begin{exo}[type=method]
Vous avez 500g de farine. Calculez la quantité nécessaire des autres ingrédients afin d'utiliser toute la farine.

\begin{sol}
Il vous faudra le 500g de beurre,  500g de sucre et 8 œufs.
\end{sol} 
\end{exo}

\end{tcblisting}


\pagebreak

\section{La partie exercices} \label{partie_exos}

Les exercices se trouvent au sein d'un environnement \texttt{exercises}, c'est à dire entre la balise  \texttt{\\begin\{exercises\}} et la balise  \texttt{\\end\{exercises\}}.

 \begin{tcbinputlisting}{colback=red!5!white,colframe=red!75!black,listing only,listing file={content/exos.tex}}
 \end{tcbinputlisting}


La page suivante montre le résultat. Elle est automatiquement séparée en deux colonnes.
\end{lesson}



\begin{exercises}
\input{exos}
\end{exercises}

\newpage

\section{La partie activités} \label{partie_activite}


Les activités se trouvent au sein d'un environnement \texttt{activities}, c'est à dire entre la balise  \texttt{\\begin\{activities\}} et la balise  \texttt{\\end\{activities\}}.

Voici le code, le résultat est visible à la page suivante.


\begin{tcbinputlisting}{colback=red!5!white,colframe=red!75!black,listing only,listing file={content/act_back.tex}}\end{tcbinputlisting}





\begin{activities}

\input{content/act.tex}

\end{activities}


\section{Les réferences}

Dans votre document, vous pouvez faire référence aux activités, aux paragraphes du cours ou aux méthodes. En tout cas, celles qui ont été marquées par un \verb!label!.Pour cela, on peut utiliser la commande  \verb!\ref!, mais la commande \verb!\cref! (du package cleveref) donne un meilleur rendu. 

\begin{tcblisting}{colback=red!5!white,colframe=red!75!black,listing above text}
{
\renewcommand{\arraystretch}{2}
\setlength{\tabcolsep}{1cm}
\begin{tabular}{|l|l|}  \hline
\bfseries commande \verb!\ref! &\bfseries  commande \verb!\cref! \\ \hline  
\ref{quart} &
\cref{quart}
\\ \hline 
\ref{partie_exos} &
\cref{partie_exos}
\\ \hline 
\ref{echec_et_maths} &
\cref{echec_et_maths} \\ \hline 
\end{tabular}
}
\end{tcblisting}