summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-09-02 20:07:46 +0000
committerKarl Berry <karl@freefriends.org>2023-09-02 20:07:46 +0000
commit020bf6deb3c4586bb3f1b994918a42e789816242 (patch)
tree519d7b4655047587a8842cde20dc65614591eab7 /Master/texmf-dist/doc
parent62d8a847df7fb51ac49488369b07f10d4e89d13b (diff)
cahierprof (2sep23)
git-svn-id: svn://tug.org/texlive/trunk@68148 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/cahierprof/ListeEleves.tex32
-rw-r--r--Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.pdfbin282687 -> 293047 bytes
-rw-r--r--Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.tex197
-rw-r--r--Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.pdfbin220954 -> 268264 bytes
-rw-r--r--Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.tex40
5 files changed, 186 insertions, 83 deletions
diff --git a/Master/texmf-dist/doc/latex/cahierprof/ListeEleves.tex b/Master/texmf-dist/doc/latex/cahierprof/ListeEleves.tex
deleted file mode 100644
index cc5c2adffc0..00000000000
--- a/Master/texmf-dist/doc/latex/cahierprof/ListeEleves.tex
+++ /dev/null
@@ -1,32 +0,0 @@
-Seconde
-\begin{enumerate}
-\item Élève Seconde 1
-\item Élève Seconde 2
-\item Élève Seconde 3
-\item Élève Seconde 4
-\item Élève Seconde 5
-\end{enumerate}
-Première G
-\begin{enumerate}
-\item Élève Première 1
-\item Élève Première 2
-\item Élève Première 3
-\item Élève Première 4
-\item Élève Première 5
-\end{enumerate}
-1 STMG
-\begin{enumerate}
-\item Élève STMG 1
-\item Élève STMG 2
-\item Élève STMG 3
-\item Élève STMG 4
-\item Élève STMG 5
-\end{enumerate}
-2 euro
-\begin{enumerate}
-\item Élève Euro 1
-\item Élève Euro 2
-\item Élève Euro 3
-\item Élève Euro 4
-\item Élève Euro 5
-\end{enumerate}
diff --git a/Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.pdf b/Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.pdf
index e3b174888dc..a29b127ec9a 100644
--- a/Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.pdf
+++ b/Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.tex b/Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.tex
index 338ddb0b246..19d5795a1e3 100644
--- a/Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.tex
+++ b/Master/texmf-dist/doc/latex/cahierprof/cahierprof-doc.tex
@@ -5,6 +5,7 @@
\usepackage{tcolorbox}
\usepackage[framemethod=TikZ]{mdframed}
\usepackage{minted}
+\usepackage{xcolor}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% En tête du document
@@ -15,13 +16,13 @@
\title{
cahierprof.sty\\
- Un cahier de textes pour les professeurs en \LaTeX{}
+ Un cahier de textes en \LaTeX{} pour les professeurs
}
\author{
Raphaël Giromini\\
\texttt{raphael.giromini -- at -- gmail.com}
}
-\date{Version 0.92 -- 10 août 2023}
+\date{Version 1.0 -- 1er septembre 2023}
\setminted{frame=single,linenos,numbersep=6pt}
@@ -42,7 +43,27 @@ constitué de deux éléments:
\item un tableau des élèves répartis par classe (pour les absences et/ou les
notes).
\end{itemize}
+Merci à Frédéric Bréal pour ses conseils, ses idées et ses relectures attentives
+du package.
+\subsection*{Nouveautés de la version 1.0}
+\begin{itemize}
+ \item La date du lundi de Pâques se calcule automatiquement.
+ \item Option \texttt{samedi}, qui permet d'afficher un emploi tu temps
+ hebdomadaire du lundi au samedi.
+ \item Possibilité d'utiliser un fichier personnel dans la commande
+ \mintinline{latex}|\ListeEleves|.
+ \item Création des commandes \mintinline{latex}|\setFin|\texttt{*}, où
+ \texttt{*} correspond à \texttt{Toussaint}, \texttt{Noel}, \texttt{Hiver} ou
+ \texttt{Printemps}, qui permet de définir des dates spécifiques de fin de
+ vacances.
+ \item Création de commandes pour définir les dates du diplôme national du
+ brevet et du baccalauréat: \mintinline{latex}|\setDNB|,
+ \mintinline{latex}|\setBac|, \mintinline{latex}|\setBacPhilo|,
+ \mintinline{latex}|\setBacFrancais|, \mintinline{latex}|\setGO|.
+\end{itemize}
+
+\section*{Versions antérieures}
\subsection*{Nouveautés de la version 0.92}
\begin{itemize}
@@ -66,7 +87,7 @@ constitué de deux éléments:
automatiquement.
\end{itemize}
-
+\vfil
\begin{center}
\begin{minipage}{.8\linewidth}
\begin{tcolorbox}[colback=white, colframe=green!75!black]
@@ -74,16 +95,17 @@ constitué de deux éléments:
\end{tcolorbox}
\end{minipage}
\end{center}
+\vfil
+\newpage
-\section{
- Calendrier des semaines de cours --
- commande \texttt{\textbackslash{}EmploiDuTemps}
-}
+\section{Calendrier des semaines de cours --
+ commande \texttt{\textbackslash{}EmploiDuTemps}}
Pour créer un calendrier scolaire hebdomadaire; il faut définir en préambule la
date du premier lundi de l'année scolaire, avec la commande
-\mintinline{latex}|\setLundiRentree\{JJ\}\{MM\}\{YYYY\}|, où \texttt{JJ} est
-le quantième du mois; \texttt{MM} est le mois et \texttt{YYYY} est l'année.
+\mintinline{latex}|\setLundiRentree{JJ}{MM}{YYYY}|, où \texttt{JJ} est le
+quantième du mois; \texttt{MM} est le mois et \texttt{YYYY} est l'année de la
+rentrée.
\begin{minted}{latex}
% Le lundi de la semaine de la rentrée est le 4 septembre 2023
\setLundiRentree{4}{9}{2023}
@@ -97,7 +119,7 @@ l'exemple ci-dessous:
\EmploiDuTemps{
% & Lundi & Mardi & Mercr. & Jeudi & Vend. \\
8h & & 1G & & 1G & \\ [1.5cm] \cline{1-2}\cline{4-6}
- 9h & & & 1STMG & 1STMG & \\ [1.5cm] \hline
+ 9h & & & TSTMG & TSTMG & \\ [1.5cm] \hline
10h & 1G & 2nde & 1G & & \\ [1.5cm] \hline
11h & & & 2nde A.P. & & 1G \\ [1.5cm] \hline\hline
13h30 & & 1G & & & 2nde \\ [1.5cm] \cline{1-5}
@@ -117,6 +139,35 @@ nombre entier de semaines.
\setNombreSemaines{10}
\end{minted}
+\subsection{Emploi du temps du lundi au samedi --
+ option \texttt{samedi} ou \texttt{\textbackslash{}Samedi}}
+
+Par défaut, l'emploi du temps est du lundi au vendredi. Mais il est possible
+d'avoir un emploi du temps du lundi au samedi avec l'option \texttt{samedi},
+dans la déclaration du package.
+\begin{minted}{latex}
+\usepackage[samedi]{cahierprof}
+\end{minted}
+Cette option peut également être activée par la commande
+\mintinline{latex}|\setSamedi|. Ne pas oublier de déclarer un Emploi du temps à
+sept colonnes
+\begin{minted}{latex}
+% Déclaration du samedi (sans utiliser l'option du package)
+\setSamedi
+% Emploi du temps sur sept colonnes.
+\EmploiDuTemps{
+ % & Lundi & Mardi & Merc. & Jeudi & Vend. & Sam. \\
+ 8h & & 1G & & 1G & & \\ [1.5cm] \cline{1-2}\cline{4-7}
+ 9h & & & TSTMG & TSTMG & & \\ [1.5cm] \hline
+ 10h & 1G & 2nde & 1G & & & 2nde \\ [1.5cm] \cline{1-6}
+ 11h & & & 2nde A.P. & & 1G & \\ [1.5cm] \hline\hline
+ 13h30 & & 1G & & & & \\ [1.5cm] \hline
+ 14h30 & & & 1G A/B & & & \\ [1.5cm] \hline
+ 15h30 & & & 2 euro & & & \\ [1.5cm] \hline
+ 16h30 & & & & & & \\ [1.5cm] \hline
+}
+\end{minted}
+
\subsection{Séance bimestrielles -- commande \texttt{\textbackslash{}sem}}
Certaines séances sont bimestriels (tous les 15 jours), suivant la parité de la
@@ -133,10 +184,11 @@ deux arguments: la séance en semaine impair, puis la séance en semaine pair.
\subsection{Gestion des vacances scolaires}
Le package \texttt{cahierprof} permet de gérer les vacances scolaires
-Les vacances scolaires (de Toussaint, de Noel, d'hiver et de printemps). Chacune
-de ces petites vacances dure 15 jours. Selon les zones (et les années) il faut
-définir en préambule le premier samedi de chaque vacances.
-
+Les vacances scolaires (de Toussaint, de Noel, d'hiver et de printemps). Selon
+les zones (et les années) il faut définir en préambule le premier samedi de
+chaque vacances, sous la forme \mintinline{latex}|\setDebutToussaint{JJ}{MM}|
+où \texttt{JJ} est le quantième du samedi du début des vacances et \texttt{MM}
+le mois du début des vacances.
\begin{minted}{latex}
% Début de chaque vacances scolaire pour l'année en cours (le samedi).
\setDebutToussaint{21}{10}
@@ -144,6 +196,68 @@ définir en préambule le premier samedi de chaque vacances.
\setDebutHiver{10}{2}
\setDebutPrintemps{6}{4}
\end{minted}
+Chacune de ces petites vacances dure automatiquement 15 jours. Cependant, il est
+possible de définir des dates spécifiques, sous la forme
+\mintinline{latex}|\setFinToussaint{JJ}{MM}| où \texttt{JJ} est le quantième du
+lundi de la fin des vacances et \texttt{MM} le mois de la fin des vacances.
+\begin{minted}{latex}
+% Fin de chaque vacances scolaire pour l'année en cours (le lundi).
+% Optionnel
+\setFinToussaint{6}{11}
+\setFinNoel{8}{1}
+\setFinHiver{26}{2}
+\setFinPrintemps{22}{4}
+\end{minted}
+
+\subsection{Gestion des examens -- commandes \texttt{\textbackslash{}setDNB} et
+ \texttt{\textbackslash{}setBac}
+}
+
+On peut définir des dates pour les examens: diplôme national du brevet (DNB), le
+les épreuves finales du baccalauréat, l'épreuve de philosophie, l'épreuve de
+français et le grand oral.
+
+Pour le diplôme national du brevet (DNB), les dates des épreuves sont définies
+par la commande \mintinline{latex}|\setDNB{JD}{JF}{YY}|, où \texttt{JD} est le
+quantième du début du DNB, \texttt{JF} est le quantième de la fin du DNB et
+\texttt{MM} est le mois du DNB. Pour ces jours, la date sera sur fond vert et la
+mention \colorbox{green}{$\star$DNB$\star$} sera ajoutée après la date.
+\begin{minted}{latex}
+% Le DNB a lieu les 24 et 25 juin.
+\setDNB{24}{25}{6}
+\end{minted}
+Pour les épreuves du baccalauréat:
+\begin{itemize}
+ \item les jours des épreuves finales du baccalauréat sont définie par la
+ commande \mintinline{latex}|\setBac{JD}{JF}{MM}|, où \texttt{JD} est le
+ quantième du début des épreuves, \texttt{JF} est le quantième de la fin des
+ épreuves et \texttt{MM} est le mois des épreuves;
+ \item le jour de l'épreuve de philosophie est définie par la commande
+ \mintinline{latex}|\setBacPhilo{JJ}{MM}|, où \texttt{JJ} est le quantième et
+ \texttt{MM} est le mois de l'épreuve de philosophie;
+ \item le jour de l'épreuve de français est définie par la commande
+ \mintinline{latex}|\setBacfrancais{JJ}{MM}|, où \texttt{JJ} est le quantième
+ et \texttt{MM} est le mois de l'épreuve de français.
+ \item Les jours des épreuves de grand oral sont définie par la commande
+ \mintinline{latex}|\setGO{JD}{JF}{MM}|, où \texttt{JD} est le quantième du
+ début des épreuves, \texttt{JF} est le quantième de la fin des épreuves et
+ \texttt{MM} est le mois des épreuves.
+\end{itemize}
+Pour ces jours, la date sera sur fond vert et la mention
+\colorbox{green}{$\star$Bac$\star$} ou bien \colorbox{green}{$\star$GO$\star$}
+sera ajoutée après la date.
+\begin{minted}{latex}
+% Les épreuves finales du bac ont lieu du 18 au 20 mars
+\setBac{18}{20}{3}
+% L'épreuve de philosophie a lieu le 11 juin
+\setBacPhilo{11}{6}
+% L'épreuve de français a lieu le 12 jun
+\setBacFrancais{12}{6}
+% Le Grand Oral a lieu du 17 au 28 juin
+\setGO{17}{28}{6}
+\end{minted}
+
+
\subsection{Gestion des jours fériés}
@@ -151,21 +265,19 @@ Les jours fériés sont les jours de fêtes légales énumérés par l’article
L.~3133-1 du code du travail: 1er janvier, lundi de Pâques, 1er mai, 8 mai,
Ascension, lundi de Pentecôte, 14 juillet, Assomption (15 août), Toussaint, 11
novembre et 25 décembre. Pour ces jours, La date sera sur fond gris et la
-mention $\star$Ferié$\star$ sera ajoutée après la date.
-
-La date du lundi de Pâques est variable chaque l'année, de même pour le jeudi de
-l'ascension et le lundi de Pentecôte. L'ascension a lieu 38 jours après le lundi
-de Pâques. Par défaut, le vendredi de l'ascension est considéré comme férié. Le
-lundi de Pentecôte a lieu 10 jours après le vendredi de l'ascension.
-
-Dans ce package, la date du lundi de Pâques est définie (jusqu'à l'année
-2040) par celle du calendrier grégorien occidental (la date utilisée par
-l'éducation nationale). Cependant, si l'on souhaite entrer une autre date, on
-peut utiliser dans le préambule la commande
-\mintinline{latex}|\setLundiPaques{JJ}{MM}|, où \texttt{JJ} est le jour
-et \texttt{MM} est le mois du lundi de Pâques.\\
+mention \colorbox{lightgray}{$\star$Férié$\star$} sera ajoutée après la date.
+
+La date du lundi de Pâques est définie par celle du calendrier grégorien
+occidental (la date utilisée par l'éducation nationale), calculé automatiquement
+par la méthode de Butcher-Meeus. Cependant, il est possible de fixer un autre
+lundi de Pâques, en utilisant, dans le préambule, la commande
+\mintinline{latex}|\setLundiPaques{JJ}{MM}| où \texttt{JJ} est le jour et
+\texttt{MM} est le mois du lundi de Pâques. L'ascension a lieu 38 jours après le
+lundi de Pâques. Par défaut, le vendredi de l'ascension est considéré comme
+férié. Le lundi de Pentecôte a lieu 10 jours après le vendredi de l'ascension.
+
Dans tous les cas, les dates de l'ascension et de la Pentecôte sont
-automatiquement calculées.
+automatiquement calculées à partir de la date du lundi de Pâques.
\begin{minted}{latex}
% Et si le lundi de Pâques était un 17 mars ?
@@ -176,7 +288,8 @@ automatiquement calculées.
\texttt{\textbackslash{}Classe}}
La commande \mintinline{latex}|\Classe| permet de générer des tableaux
-d'appels des classes. Cette commande prend trois arguments:
+d'appels des classes.\\
+Cette commande prend trois arguments:
\begin{itemize}
\item le nom de la classe;
\item le nombre de fois que l'on voit les élèves dans la semaine;
@@ -184,7 +297,7 @@ d'appels des classes. Cette commande prend trois arguments:
\end{itemize}
Par exemple:
\begin{minted}{latex}
-% La classe de seconde a 3 séances dans la semaine
+% La classe de seconde a 4 séances dans la semaine
\Classe{Seconde}{4}{
Élève Seconde 1,
Élève Seconde 2,
@@ -202,21 +315,25 @@ Par exemple:
}
\end{minted}
-\subsection{Liste des élèves}
+\subsection{Liste des élèves -- commande \texttt{\textbackslash{}ListeEleves}}
-La commande \mintinline{latex}|\ListeEleves| va va créer un fichier
-\texttt{ListeEleves.tex} avec la liste (numérotés) de l'ensemble des élèves
-réparti par classe, puis insérer dans le cahier de texte cette liste (penser à
-compiler deux fois).
+La commande \mintinline{latex}|\ListeEleves{<fichier>}| permet d'insérer le
+contenu du \texttt{<fichier>}. Si aucun fichier n'est spécifié, le package créé
+un fichier \texttt{ListeEleves.tex} avec la liste (numérotés) de l'ensemble des
+élèves réparti par classe, puis insérer dans le cahier de texte cette liste
+(penser à compiler deux fois).
-% \begin{minted}{latex}
-% % Liste des élèves, sauvée dans le fichier ListeEleves.tex,
-% % créée à partir des \Classe{}{}{}. Penser à compiler deux fois.
-% \ListeEleves
-% \end{minted}
+\begin{minted}{latex}
+% Liste des élèves, sauvée dans le fichier ListeEleves.tex,
+% créée à partir des \Classe{}{}{}. Penser à compiler deux fois.
+\ListeEleves{}
+\end{minted}
\section{Un exemple complet}
+L'exemple ci-dessous du cahier de texte est compilé dans
+\texttt{cahierprof-exemple.pdf}
+
\inputminted{latex}{cahierprof-exemple.tex}
\end{document}
diff --git a/Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.pdf b/Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.pdf
index 24d975ecdf0..2330ab5ddd4 100644
--- a/Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.pdf
+++ b/Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.tex b/Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.tex
index f1f80b8f017..887f4cb0047 100644
--- a/Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.tex
+++ b/Master/texmf-dist/doc/latex/cahierprof/cahierprof-exemple.tex
@@ -14,13 +14,13 @@
\title{
cahierprof-exemple.tex\\
- Utilisation du cahier de textes pour les professeurs en \LaTeX{}
+ Utilisation du cahier de textes en \LaTeX{} pour les professeurs
}
\author{
Raphaël Giromini\\
\texttt{raphael.giromini -- at -- gmail.com}
}
-\date{Version 0.92 -- 10 août 2023}
+\date{Version 1.0 -- 1er septembre 2023}
% 1er lundi de l'année scolaire (pour le cahier de texte)
\setLundiRentree{4}{9}{2023}
@@ -29,6 +29,17 @@
\setDebutNoel{23}{12}
\setDebutHiver{10}{2}
\setDebutPrintemps{6}{4}
+% Les examens
+% Le DNB a lieu les 24 et 25 juin.
+% \setDNB{24}{25}{6}
+% Les épreuves finales du bac ont lieu du 18 au 20 mars
+\setBac{18}{20}{3}
+% L'épreuve de philosophie a lieu le 11 juin
+\setBacPhilo{11}{6}
+% L'épreuve de français a lieu le 12 jun
+\setBacFrancais{12}{6}
+%Le Grand Oral a lieu du 17 au 28 juin
+\setGO{17}{28}{6}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Début du document
@@ -39,16 +50,21 @@
\section{Calendrier des semaines de cours}
-Le calendrier débute sur la page suivante au format paysage.
+Exemple du cahier de texte à partir de l'exemple complet de
+\texttt{cahierprof-doc.tex}
+
+Le cahier de texte débute sur la page suivante au format paysage.
% Emploi du temps au format tableau (tabularx).
\begin{landscape}
\EmploiDuTemps{
% & Lundi & Mardi & Merc. & Jeudi & Vend. \\
- 8h & & 1G & & 1G & \\ [1.5cm] \cline{1-2}\cline{4-6}
- 9h & & & 1STMG & 1STMG & \\ [1.5cm] \hline
+ 8h & & 1G & & 1G & \\ [1.5cm]
+ \cline{1-2}\cline{4-6}
+ 9h & & & TSTMG & TSTMG & \\ [1.5cm] \hline
10h & 1G & 2nde & 1G & & \\ [1.5cm] \hline
- 11h & & & \sem{2nde A.P.}{} & & 1G \\ [1.5cm] \hline\hline
+ 11h & & & \sem{2nde A.P.}{} & & 1G \\ [1.5cm]
+ \hline\hline
13h30 & & 1G & & & 2nde \\ [1.5cm] \cline{1-5}
14h30 & & & 1G (Groupe~\sem{A}{B}) & & \\ [1.5cm] \hline
15h30 & & & 2 euro & & \\ [1.5cm] \hline
@@ -60,16 +76,18 @@ Le calendrier débute sur la page suivante au format paysage.
\subsection{Liste des élèves}
-\ListeEleves
+Affiche la liste des élèves et la sauve dans le fichier par défaut
+\texttt{ListeEleves.tex}.
+\ListeEleves{}
\newpage
\subsection{Tableaux des classes}
-% \Classe{Nom de la classe}{Nombre de séances dans la semaine}{Liste des élèves
-% séparés par une virgule}
+% \Classe{Nom de la classe}{Nombre de séances dans la semaine}
+% {Liste des élèves séparés par une virgule}
-\Classe{Seconde}{3}
+\Classe{Seconde}{4}
{
Élève Seconde 1,
Élève Seconde 2,
@@ -87,7 +105,7 @@ Le calendrier débute sur la page suivante au format paysage.
Élève Première 5
}
-\Classe{1 STMG}{2}
+\Classe{T STMG}{2}
{
Élève STMG 1,
Élève STMG 2,