From c10d63b115f3a6add26c825950ee136eed0f176d Mon Sep 17 00:00:00 2001 From: Benjamin Bohard Date: Fri, 4 Sep 2020 16:23:35 +0200 Subject: [PATCH] =?UTF-8?q?Pr=C3=A9sentation=20de=20la=20proc=C3=A9dure=20?= =?UTF-8?q?propos=C3=A9e=20pour=20la=20production=20de=20supports=20de=20f?= =?UTF-8?q?ormation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 196 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 196 insertions(+) diff --git a/README.md b/README.md index a223bd6..ac691a3 100644 --- a/README.md +++ b/README.md @@ -36,3 +36,199 @@ L'ensemble des plans est regroupé et compressé sous le nom plans_de_formation. - compléter ces fichiers Penser à générer de nouveau les plans + +# Révision du processus de production des supports de formation + +## Organisation du dépôt + +Le dépôt encourage autant que possible la réutilisation et la mutualisation du contenu. +Les éléments de contenu à inclure sont dans les dossiers _content_ et _slides_ pour les documents de type _article_ et _beamer_ respectivement. + +Les figures sont placées à part dans le répertoire _figures_. + +Ces éléments de contenu sont inclus dans des fichiers principaux placés dans le répertoire _presentations_. + +Le répertoire _template_ contient des modèles de document au format jinja utilisés par le script _setup_main_tex_file.py_. + +## setup_main_tex_file.py + +Le script setup_main_tex_file.py permet d’organiser la procédure en proposant : +- la création du fichier maître pour une formation +- la création des fichiers de contenu à inclure si nécessaire +- la mise à jour du plan de formation en fonction des éléments inclus. + +Pour chacune de ses sous-étapes, le script propose une sous-commande. + +### Démarrer une formation (sous-commande init) + +``` +./setup_main_tex_file.py init -f beamer -a Cadoles -t "Formation personnalisée Scribe" -c "Conseil départemental" -d modules_EOLE_envole/Conseil_Départemental -i Cadoles -l cc-by-sa -n CD_Formation_Scribe +``` + +Les options obligatoires sont : +- le format (beamer ou article) : -f +- le titre qui apparaîtra sur la page de garde ou la première diapositive : -t +- l’emplacement, soit le sous-répertoire du répertoire presentations : -d +- le nom du fichier (sans l’extension) qui sera créé à l’emplacement indiqué. + +Les autres options prendront des valeurs par défaut si elles ne sont pas fournies : +- l’auteur est Cadoles par défaut +- l’institut, qui détermine les logos à intégrer, est Cadoles par défaut +- la licence est la Creative Commons CC-BY-SA v2 par défaut +- le client est XXX par défaut + +À noter, pour la licence, que seule la CC-BY-SA v2 est disponible dans les contenus à inclure pour l’instant. + +L’exécution de la commande précédente produit le fichier presentations/modules_EOLE_envole/Conseil_Départemental/CD_Formation_Scribe.tex + +### Construire le contenu d’une formation + +On peut construire une formation en éditant le fichier maître créé précédemment. + +Ce fichier présente la configuration du module skb +``` +\documentclass{beamer} + +\usepackage{skb} + +\skbconfig[ + root = ../../../, + rep = content, + pub = presentations, + fig = figures, + sli = slides, + acr = database/acr, + bib = database/bib +]{skblocal.tex} +``` + +Ces variables sont utilisées pour l’inclusion des éléments de contenu répartis dans les différents sous-dossier du dépôt. + +Le corps du document qui est principalement intéressant est minimaliste au départ +``` +\begin{document} + +\skbinput[from=sli]{style/title} + +% Corps de la formation +%\skbinput[from=sli]{} + +\skbinput[from=sli]{licences/license-cc-by-sa-2.0} + +\end{document} +``` + +Pour ajouter du contenu, on ajoute principalement des directives skbinput avec l’option from=sli (pour les documents de type beamer) et l’emplacement du fichier à partir du répertoire slides (puisque from=sli et sli = slides dans la configuration skb) + +On peut également structurer la présentation en intercalant des directives section, subsection, etc. + +Ces directives section, subsection, ainsi que le contenu inclu permet ensuite de construire le plan. + +Les directives skbinput peuvent pointer vers un fichier inexistant dans un premier temps (une tentative de compilation du document dans cet état échouera bien évidemment). + +### Consolider le contenu d’une formation (sous-commande update) + +Par exemple, avec le corps de document suivant +``` +\section{Introduction} +\skbinput[from=sli]{modules_EOLE_envole/commun/intro} +\skbinput[from=sli]{modules_EOLE_envole/commun/nouveautes27} +\skbinput[from=sli]{modules_EOLE_envole/commun/panorama-module} +\skbinput[from=sli]{modules_EOLE_envole/scribe/description} +\section{Outils pédagogique Scribe} +\skbinput[from=sli]{modules_EOLE_envole/scribeAD/eop} +\skbinput[from=sli]{modules_EOLE_envole/scribeAD/eop-pratique} +\skbinput[from=sli]{modules_EOLE_envole/scribeAD/veyon} +\skbinput[from=sli]{modules_EOLE_envole/scribeAD/veyon-pratique} +\section{Les quatre phases} +\skbinput[from=sli]{modules_EOLE_envole/commun/quatre_phases} +\skbinput[from=sli]{modules_EOLE_envole/eolebase/virtualbox} +\skbinput[from=sli]{modules_EOLE_envole/commun/quatre_phases-pratique} +\skbinput[from=sli]{modules_EOLE_envole/commun/configuration-pratique} +\skbinput[from=sli]{modules_EOLE_envole/commun/02-gen_config} +\skbinput[from=sli]{modules_EOLE_envole/commun/instance-pratique} +\skbinput[from=sli]{modules_EOLE_envole/commun/du-contenu-inexistant} +``` + +La plupart du contenu existe déjà. +Seule la dernière inclusion poserait problème lors de la compilation. + +Pour permettre de lancer des compilations sans attendre que tout le contenu soit prêt, le script propose une sous commande qui prépare le terrain en créant les fichiers de contenu manquant. +``` +./setup_main_tex_file.py update -m presentations/modules_EOLE_envole/Conseil_Départemental/CD_Formation_Scribe.tex +``` + +Le seul argument de cette sous-commande _update_ permet d’identifier le fichier maître. + +Cette commande traiter toutes les directives skbinput et créer le fichier à inclure si il n’existe pas déjà. +Elle affiche la liste des fichiers créés en retour de commande. + +``` +$ ./setup_main_tex_file.py update -m presentations/modules_EOLE_envole/Conseil_Départemental/CD_Formation_Scribe.tex +slides/modules_EOLE_envole/commun/du-contenu-inexistant.tex +``` + +Ce fichier contient du texte permettant de le repérer facilement dans le document généré +``` +\begin{frame} + \frametitle{du-contenu-inexistant.tex} + fichier slides/modules\_EOLE\_envole/commun/du-contenu-inexistant.tex à éditer + % contenu (pas trop long) de la diapositive +\end{frame} +``` + +### Affichage du plan (sous-commande outline) + +À ce stade, le script propose un simple affichage sur la sortie standard du plan déduit du contenu +``` +Introduction + EOLE + En quatre points + Ce qui caractérise EOLE + Nouveautés 2.7 + Modules disponibles en 2.7.0 + Modules disponibles à partir de la 2.7.1 + Eclair + Zéphir/Sentinelle + Zéphir + Seshat + Thot + Seth + Hapy + Scribe +Outils pédagogique Scribe + EOP + Mise en pratique + Veyon + Les fonctionnalités + Préparation + Mise en pratique +Les quatre phases + La phase d'installation + La phase de configuration + La phase d'instanciation + La phase d’instanciation + les étapes de l’instanciation + Les comptes administrateurs locaux + Les mots de passe + La phase d'administration + La phase d’administration + VirtualBox + Configuration de la VM Eolebase + Configuration autonome + Nature d’une configuration + Types de variables + Contraintes + Application de configuration du module + Les modes de l’application de configuration du module + Les informations de debug + sauvegarde et chargement de la configuration + Instance +``` + +### Génération du document + +En alternative à la recette Makefile pas encore adaptée pour la compilation de ce nouveau format, on peut utiliser la commande rubber (paquet supplémentaire à installer) +``` +rubber --inplace --module=xelatex presentations/modules_EOLE_envole/Conseil_Départemental/CD_Formation_Scribe.tex +```