ScribeAD: ajout des paquets à installer pour quota

Plus proche de la dernière présentation
Début avec les bases Linux

.gitignore

@@ -14,3 +14,5 @@
 build-messages-*.txt
 plans_de_formation.tar.gz
 .~lock*
+*.pygtex
+*.pygstyle

README.md

@@ -36,3 +36,236 @@ 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 _templates_ 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 des fichiers maîtres 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 ;
+- la compilation des trois documents (diaporama, support de cours et programme) si l’application rubber est installée.
+
+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/diaporama.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 -d modules_EOLE_envole/Conseil_Départemental
+```
+
+Le seul argument de cette sous-commande _update_ permet d’identifier le sous-répertoire de _presentations_ contenant le fichier maître _diaporama.tex_.
+
+Cette commande traite toutes les directives skbinput et créer le fichier à inclure s’il n’existe pas déjà.
+Elle affiche la liste des fichiers créés en retour de commande.
+
+```
+$ ./setup_main_tex_file.py update -d modules_EOLE_envole/Conseil_Départemental/ 
+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)
+
+La sous-commande _outline_ permet de créer un sommaire du diaporama sous la forme de listes imbriquées et de l’inclure dans le programme.
+Il est possible de restreindre le nombre de niveaux de titre utilisé pour le plan avec l’option -l.
+```
+./setup_main_tex_file.py outline -d modules_EOLE_envole/Conseil_Départemental
+```
+```
+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
+
+Comme 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
+```
+
+La sous-commande _compile_ appelle rubber pour compiler les trois documents : diaporama, support et programme.
+```
+./setup_main_tex_file.py compile -d modules_EOLE_envole/Conseil_Départemental
+```
+Cette sous-commande n’est disponible que si la commande rubber est installé et accessible (test du retour rubber --version).
+
+### Intégration avec git
+
+Le script entreprend des actions complémentaires lorsque il détecte un environnement _git_.
+
+#### Séparation et isolation des formations
+
+La proposition est la suivante : séparer le contenu générique (contenu inclu dans les formations) et les fichiers maîtres spécifiques à des formations.
+
+Une branche (master en l’occurence) est utilisée comme pivot et contient les fragments de formations.
+Chaque formation spécifique est isolée dans une branche propre.
+
+De fait, le contenu du dossier _presentations_ est commité dans la branche spécifique, tandis que le reste (_content_ et _slides_ notamment) est commité dans _master_. Un hook git local est proposé pour limiter les commits dans les mauvaises branches, basé sur les chemins des fichiers créés ou modifiés.
+
+Le script permet d’automatiser une partie de ce découpage, notamment la création des branches spécifiques et le commit dans les branches appropriées selon les actions entreprises.
+
+#### action d’initialisation
+
+L’initialisation doit être effectué depuis la branche _master_ et exécute les actions suivantes :
+- création d’une branche nommée d’après le répertoire de destination et suffixée avec _xelatex/_
+- création des fichiers propres à la formation (fichiers maîtres pour le diaporama, le support, le programme, etc.)
+- commit de ces fichiers dans la branche spécifique.
+
+#### action de mise à jour du programme
+
+Comme tout ce qui implique la mise à jour ou la création de contenu dans le répertoire _presentations_, le produit de la mise à jour du programme est commité dans la branche spécifique.

content/modules_EOLE_envole/exercices/creole-dictionnaire-structure.tex

@@ -0,0 +1,7 @@
+\skbheading{Explorer la structure d’un dictionnaire Creole}
+
+Un dictionnaire Creole est une description de la configuration à l’aide du format de fichier \emph{xml}.
+
+fichier content/modules\_EOLE\_envole/exercices/creole-dictionnaire-structure.tex à éditer
+
+\inputminted[]{xml}{./content/modules_EOLE_envole/exercices/creole.dtd}

content/modules_EOLE_envole/exercices/creole.dtd

@@ -0,0 +1,237 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!-- ===================================================================== -->
+
+<!-- Definition de la DTD du fichier creole -->
+
+<!-- ===================================================================== -->
+
+<!--
+#    Conception :
+#    Eole (http://eole.orion.education.fr)
+
+#    Copyright (C) 2005-2018
+
+#    distribue sous la licence GPL-2
+
+#    En attendant une traduction officielle de la GPL, la notice de
+#    copyright demeure en anglais.
+
+#    This program is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+
+#    You should have received a copy of the GNU General Public License
+#    along with this program; if not, write to the Free Software
+#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+#    Se reporter a la documentation envoyee avec le programme pour la notice.
+
+-->
+<!--================ -->
+<!-- root element    -->
+<!-- =============== -->
+
+<!ELEMENT creole (containers | files | family_action | variables | constraints | help)*>
+
+<!-- ============== -->
+<!-- files element  -->
+<!-- ============== -->
+
+<!ELEMENT family_action (action)>
+<!ATTLIST family_action name CDATA #REQUIRED>
+<!ATTLIST family_action description CDATA #IMPLIED>
+<!ATTLIST family_action color CDATA #IMPLIED>
+<!ATTLIST family_action image CDATA #IMPLIED>
+<!ELEMENT action ((input* | profile* | ewtapp* | tag* | saltaction*)*)>
+<!ATTLIST action type (form|custom|external|reader|apache) "custom">
+<!ATTLIST action title CDATA #REQUIRED>
+<!ATTLIST action description CDATA #REQUIRED>
+<!ATTLIST action rewrite CDATA #IMPLIED>
+<!ATTLIST action image CDATA #IMPLIED>
+<!ATTLIST action actionlist CDATA #IMPLIED>
+<!-- for apache action -->
+<!ATTLIST action apache_path CDATA #IMPLIED>
+<!ATTLIST action apache_path_type (FilenameOption|SymLinkOption) "FilenameOption">
+<!-- for external action -->
+<!ATTLIST action url CDATA #IMPLIED>
+<!ATTLIST action url_type (URLOption|SymLinkOption) "URLOption">
+<!-- for form action -->
+<!ATTLIST action save (True|False) "False">
+<!ELEMENT files ((service* | service_access* | service_restriction* | package* | file*)*)>
+
+<!ELEMENT containers ((container* | all*)*)>
+
+<!ELEMENT container ((service* | service_access* | service_restriction* | interface* | package* | file* | disknod* | host* | fstab*)*) >
+<!ATTLIST container name CDATA #REQUIRED >
+<!ATTLIST container id CDATA #IMPLIED >
+<!ATTLIST container group CDATA #IMPLIED >
+
+<!ELEMENT all ((service* | interface* | package* | file* | disknod* | host* | fstab*)*) >
+
+<!ELEMENT service (#PCDATA)>
+<!ATTLIST service servicelist CDATA #IMPLIED >
+<!ATTLIST service instance_mode (when_container|when_no_container|always) "always">
+<!ATTLIST service method (systemd|upstart|apache|network|restartonly) "systemd">
+<!ATTLIST service redefine (True|False) "False">
+
+<!ELEMENT input (#PCDATA)>
+<!ELEMENT profile (#PCDATA)>
+<!ELEMENT ewtapp (#PCDATA)>
+<!ELEMENT tag (#PCDATA)>
+<!ELEMENT saltaction (#PCDATA)>
+
+<!ELEMENT service_access ((port | tcpwrapper)*)>
+<!ATTLIST service_access service CDATA #REQUIRED >
+
+<!ELEMENT port (#PCDATA)> <!--port_type-->
+<!ATTLIST port port_type (PortOption|SymLinkOption) "PortOption">
+<!ATTLIST port service_accesslist CDATA #IMPLIED >
+<!ATTLIST port protocol (tcp|udp) "tcp">
+
+<!ELEMENT tcpwrapper (#PCDATA)> <!--tcpwrapper_type-->
+<!ATTLIST tcpwrapper tcpwrapper_type (UnicodeOption|SymLinkOption) "UnicodeOption">
+<!ATTLIST tcpwrapper service_accesslist CDATA #IMPLIED >
+
+<!ELEMENT service_restriction (ip*)>
+<!ATTLIST service_restriction service CDATA #REQUIRED >
+
+<!ELEMENT ip (#PCDATA)> <!--ip_type-->
+<!ATTLIST ip service_restrictionlist CDATA #IMPLIED >
+<!ATTLIST ip ip_type (NetworkOption|SymLinkOption) "NetworkOption">
+<!ATTLIST ip interface_type (UnicodeOption|SymLinkOption) "UnicodeOption">
+<!ATTLIST ip interface CDATA #REQUIRED> <!--interface_type-->
+<!ATTLIST ip netmask_type (NetmaskOption|SymLinkOption) "NetmaskOption">
+<!ATTLIST ip netmask CDATA "255.255.255.255"> <!--netmask_type-->
+
+<!ELEMENT interface (#PCDATA)>
+<!ATTLIST interface interfacelist CDATA #IMPLIED >
+<!ATTLIST interface linkto CDATA #REQUIRED >
+<!ATTLIST interface ip CDATA #REQUIRED> <!--SymLinkOption-->
+<!ATTLIST interface ip_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST interface mask CDATA #REQUIRED> <!--SymLinkOption-->
+<!ATTLIST interface mask_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST interface bcast CDATA #IMPLIED> <!--SymLinkOption-->
+<!ATTLIST interface bcast_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST interface gateway CDATA #IMPLIED> <!--SymLinkOption-->
+<!ATTLIST interface gateway_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST interface method (bridge|macvlan) "macvlan" >
+<!ATTLIST interface redefine (True|False) "False">
+
+<!ELEMENT host EMPTY >
+<!ATTLIST host hostlist CDATA #IMPLIED >
+<!ATTLIST host name CDATA #REQUIRED > <!--SymLinkOption-->
+<!ATTLIST host name_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST host ip CDATA #REQUIRED > <!--SymLinkOption-->
+<!ATTLIST host ip_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST host crossed (True|False) "True" >
+<!ATTLIST host instance_mode (when_container|when_no_container|always) "always">
+<!ATTLIST host comment CDATA #IMPLIED >
+
+<!ELEMENT fstab EMPTY >
+<!ATTLIST fstab name CDATA #REQUIRED> <!--name_type-->
+<!ATTLIST fstab name_type (FilenameOption|SymLinkOption) "FilenameOption">
+<!ATTLIST fstab type (bind|normal) "bind">
+<!ATTLIST fstab fstype (auto|ext3|ext4|nfs|smb) "auto">
+<!ATTLIST fstab mount_point CDATA #IMPLIED> <!--mount_point_type-->
+<!ATTLIST fstab mount_point_type (FilenameOption|SymLinkOption) "FilenameOption">
+<!ATTLIST fstab options CDATA #IMPLIED>
+<!ATTLIST fstab checks CDATA #IMPLIED>
+<!ATTLIST fstab fstablist CDATA #IMPLIED>
+<!ATTLIST fstab instance_mode (when_container|when_no_container|always) "when_container">
+
+<!ELEMENT package (#PCDATA)>
+<!ATTLIST package instance_mode (when_container|when_no_container|always) "always">
+
+<!ELEMENT disknod (#PCDATA)>
+
+<!ELEMENT file EMPTY>
+<!ATTLIST file name CDATA #REQUIRED >
+<!ATTLIST file name_type (UnicodeOption|SymLinkOption) "UnicodeOption">
+<!ATTLIST file source CDATA #IMPLIED>
+<!ATTLIST file mode CDATA #IMPLIED >
+<!ATTLIST file owner CDATA #IMPLIED >
+<!ATTLIST file group CDATA #IMPLIED >
+<!ATTLIST file filelist CDATA #IMPLIED >
+<!ATTLIST file mkdir (True|False) "False">
+<!ATTLIST file instance_mode (when_container|when_no_container|always) "always">
+<!ATTLIST file rm (True|False) "False">
+<!ATTLIST file del_comment CDATA #IMPLIED >
+<!ATTLIST file redefine (True|False) "False">
+
+<!ELEMENT variables (family*, separators*)>
+<!ELEMENT family (#PCDATA | variable)*>
+<!ATTLIST family name CDATA #REQUIRED>
+<!ATTLIST family description CDATA #IMPLIED>
+<!ATTLIST family mode (basic|normal|expert) "basic">
+<!ATTLIST family icon CDATA #IMPLIED>
+<!ATTLIST family hidden (True|False) "False">
+<!ATTLIST family dynamic CDATA #IMPLIED>
+
+<!ELEMENT variable (#PCDATA | value)*>
+<!ATTLIST variable name CDATA #REQUIRED>
+<!ATTLIST variable type CDATA #IMPLIED>
+<!ATTLIST variable description CDATA #IMPLIED>
+<!ATTLIST variable hidden (True|False) "False">
+<!ATTLIST variable disabled (True|False) "False">
+<!ATTLIST variable multi (True|False) "False">
+<!ATTLIST variable redefine (True|False) "False">
+<!ATTLIST variable exists (True|False) "True">
+<!ATTLIST variable mandatory (True|False) "False">
+<!ATTLIST variable auto_freeze (True|False) "False">
+<!ATTLIST variable auto_save (True|False) "False">
+<!ATTLIST variable mode (basic|normal|expert) "normal">
+<!ATTLIST variable remove_check (True|False) "False">
+<!ATTLIST variable remove_condition (True|False) "False">
+
+<!ELEMENT separators (separator*)>
+
+<!ELEMENT separator (#PCDATA)>
+<!ATTLIST separator name CDATA #REQUIRED>
+<!ATTLIST separator never_hidden CDATA #IMPLIED>
+
+<!ELEMENT value (#PCDATA)>
+
+<!ELEMENT constraints ((fill* | check* | condition* | auto* | group*)*)>
+<!ELEMENT fill (param*)>
+<!ATTLIST fill name CDATA #REQUIRED>
+<!ATTLIST fill target CDATA #REQUIRED>
+
+<!ELEMENT check (param*)>
+<!ATTLIST check name CDATA #REQUIRED>
+<!ATTLIST check target CDATA #REQUIRED>
+<!ATTLIST check level (error|warning) "error">
+
+<!ELEMENT auto ((param)*)>
+<!ATTLIST auto name CDATA #REQUIRED>
+<!ATTLIST auto target CDATA #REQUIRED>
+
+<!ELEMENT condition ((target | param)+ )>
+<!ATTLIST condition name CDATA #REQUIRED>
+<!ATTLIST condition source CDATA #REQUIRED>
+<!ATTLIST condition fallback (True|False) "False">
+
+<!ELEMENT group (slave+)>
+<!ATTLIST group master CDATA #REQUIRED>
+<!ATTLIST group description CDATA #IMPLIED>
+
+<!ELEMENT param (#PCDATA)>
+<!ATTLIST param type (string|eole|number|container|context|python) "string">
+<!ATTLIST param name CDATA #IMPLIED>
+<!ATTLIST param hidden (True|False) "True">
+<!ATTLIST param optional (True|False) "False">
+
+<!ELEMENT target (#PCDATA)>
+<!ATTLIST target type (family|filelist|servicelist|interfacelist|variable|service_accesslist|service_restrictionlist|hostlist|fstablist|actionlist) "variable">
+<!ATTLIST target optional (True|False) "False">
+
+<!ELEMENT slave (#PCDATA)>
+
+<!ELEMENT help ((variable* | family*)*)>
+

content/modules_EOLE_envole/exercices/vnstat-activation.tex

@@ -0,0 +1,2 @@
+\skbheading{vnstat-activation.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-activation.tex à éditer

content/modules_EOLE_envole/exercices/vnstat-contrainte.tex

@@ -0,0 +1,2 @@
+\skbheading{vnstat-contrainte.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-contrainte.tex à éditer

content/modules_EOLE_envole/exercices/vnstat-documentation.tex

@@ -0,0 +1,2 @@
+\skbheading{vnstat-documentation.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-documentation.tex à éditer

content/modules_EOLE_envole/exercices/vnstat-gestion-reseau.tex

@@ -0,0 +1,2 @@
+\skbheading{vnstat-gestion-reseau.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-gestion-reseau.tex à éditer

content/modules_EOLE_envole/exercices/vnstat-gestion-service.tex

@@ -0,0 +1,2 @@
+\skbheading{vnstat-gestion-service.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-gestion-service.tex à éditer

content/modules_EOLE_envole/exercices/vnstat-template.tex

@@ -0,0 +1,2 @@
+\skbheading{vnstat-template.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-template.tex à éditer

content/modules_eole_envole/90-vnstat

@@ -0,0 +1,16 @@
+#!/bin/bash
+
+#set -e
+. /usr/lib/eole/diagnose.sh
+EchoGras "*** Service de statistique réseau"
+
+if [ "$(CreoleGet activer_vnstat)" = "oui" ]; then
+    TestPid vnStat vnstatd
+    echo
+    vnstat
+else
+    Inactif vnStat
+fi
+
+echo
+exit 0

content/modules_eole_envole/exemple.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<creole>
+    <files>
+        <file filelist='vnstat' name='etc/vnstat.conf'/>
+        <service servicelist='vnstat'>vnstat</service>
+        <service_access service='vnstat'>
+            <port>8888</port>
+            <tcpwrapper>vnstat</tcpwrapper>
+        </service_access>
+        <service_restriction service='vnstat'>
+            <ip interface='auto' netmask='255.255.255.0'>192.168.56.101</ip>
+        </service_restriction>
+    </files>
+    <variables>
+        <family name='services'>
+            <variable name='activer_vnstat' type='oui/non' description='Activer le service vnStat'>
+                <value>oui</value>
+            </variable>
+        </family>
+        <family name='vnstat'>
+            <variable name='vnstat_interface' type='string' description='Numéro de l’interface par défaut de vnStat' mandatory='True' multi='True'/>
+            <variable name='vnstat_user' type='unix_user' description='Nom d’utilisateur' mode='expert'/>
+            <variable name='vnstat_group' type='unix_user' description='Nom du groupe' mode='expert'/>
+        </family>
+    </variables>
+    <constraints>
+        <check name='valid_enum' target='vnstat_interface'>
+            <param>['0', '1', '2', '3', '4']</param>
+        </check>
+        <fill name='calc_val' target='vnstat_group'>
+            <param type='eole' name='valeur'>vnstat_user</param>
+        </fill>
+        <condition name='disabled_if_in' source='activer_vnstat'>
+            <param>non</param>
+            <target type='family'>vnstat</target>
+            <target type='filelist'>vnstat</target>
+            <target type='servicelist'>vnstat</target>
+        </condition>
+    </constraints>
+</creole>

content/modules_eole_envole/ressources/vnstat/90-vnstat

@@ -0,0 +1,16 @@
+#!/bin/bash
+
+#set -e
+. /usr/lib/eole/diagnose.sh
+EchoGras "*** Service de statistique réseau"
+
+if [ "$(CreoleGet activer_vnstat)" = "oui" ]; then
+    TestPid vnStat vnstatd
+    echo
+    vnstat
+else
+    Inactif vnStat
+fi
+
+echo
+exit 0

content/modules_eole_envole/ressources/vnstat/vnstat.conf

@@ -0,0 +1,170 @@
+# vnStat 1.18 config file
+##
+
+# default interface
+%set %%interfaces = []
+%for interface in %%vnstat_interface
+%set %%zone = 'nom_zone_eth' + interface
+%silent %%interfaces.append(%%getVar(%%zone))
+%end for
+Interface "%%custom_join(%%interfaces,'+']"
+
+# location of the database directory
+DatabaseDir "/var/lib/vnstat"
+
+# locale (LC_ALL) ("-" = use system locale)
+Locale "-"
+
+# on which day should months change
+MonthRotate 1
+
+# date output formats for -d, -m, -t and -w
+# see 'man date' for control codes
+DayFormat    "%x"
+MonthFormat  "%b '%y"
+TopFormat    "%x"
+
+# characters used for visuals
+RXCharacter       "%"
+TXCharacter       ":"
+RXHourCharacter   "r"
+TXHourCharacter   "t"
+
+# how units are prefixed when traffic is shown
+# 0 = IEC standard prefixes (KiB/MiB/GiB/TiB)
+# 1 = old style binary prefixes (KB/MB/GB/TB)
+UnitMode 0
+
+# how units are prefixed when traffic rate is shown
+# 0 = IEC binary prefixes (Kibit/s...)
+# 1 = SI decimal prefixes (kbit/s...)
+RateUnitMode 1
+
+# output style
+# 0 = minimal & narrow, 1 = bar column visible
+# 2 = same as 1 except rate in summary and weekly
+# 3 = rate column visible
+OutputStyle 3
+
+# used rate unit (0 = bytes, 1 = bits)
+RateUnit 1
+
+# number of decimals to use in outputs
+DefaultDecimals 2
+HourlyDecimals 1
+
+# spacer for separating hourly sections (0 = none, 1 = '|', 2 = '][', 3 = '[ ]')
+HourlySectionStyle 2
+
+# try to detect interface maximum bandwidth, 0 = disable feature
+# MaxBandwidth will be used as fallback value when enabled
+BandwidthDetection 1
+
+# maximum bandwidth (Mbit) for all interfaces, 0 = disable feature
+# (unless interface specific limit is given)
+MaxBandwidth 1000
+
+# interface specific limits
+#  example 8Mbit limit for eth0 (remove # to activate):
+#MaxBWeth0 8
+
+# how many seconds should sampling for -tr take by default
+Sampletime 5
+
+# default query mode
+# 0 = normal, 1 = days, 2 = months, 3 = top10
+# 4 = exportdb, 5 = short, 6 = weeks, 7 = hours
+QueryMode 0
+
+# filesystem disk space check (1 = enabled, 0 = disabled)
+CheckDiskSpace 1
+
+# database file locking (1 = enabled, 0 = disabled)
+UseFileLocking 1
+
+# how much the boot time can variate between updates (seconds)
+BootVariation 15
+
+# log days without traffic to daily list (1 = enabled, 0 = disabled)
+TrafficlessDays 1
+
+
+# vnstatd
+##
+
+# switch to given user when started as root (leave empty to disable)
+DaemonUser "%%vnstat_user"
+
+# switch to given user when started as root (leave empty to disable)
+DaemonGroup "%%vnstat_group"
+
+# how many minutes to wait during daemon startup for system clock to
+# sync time if most recent database update appears to be in the future
+TimeSyncWait 5
+
+# how often (in seconds) interface data is updated
+UpdateInterval 30
+
+# how often (in seconds) interface status changes are checked
+PollInterval 5
+
+# how often (in minutes) data is saved to file
+SaveInterval 5
+
+# how often (in minutes) data is saved when all interface are offline
+OfflineSaveInterval 30
+
+# how often (in minutes) bandwidth detection is redone when
+# BandwidthDetection is enabled (0 = disabled)
+BandwidthDetectionInterval 5
+
+# force data save when interface status changes (1 = enabled, 0 = disabled)
+SaveOnStatusChange 1
+
+# enable / disable logging (0 = disabled, 1 = logfile, 2 = syslog)
+UseLogging 2
+
+# create dirs if needed (1 = enabled, 0 = disabled)
+CreateDirs 1
+
+# update ownership of files if needed (1 = enabled, 0 = disabled)
+UpdateFileOwner 1
+
+# file used for logging if UseLogging is set to 1
+LogFile "/var/log/vnstat/vnstat.log"
+
+# file used as daemon pid / lock file
+PidFile "/var/run/vnstat/vnstat.pid"
+
+
+# vnstati
+##
+
+# title timestamp format
+HeaderFormat "%x %H:%M"
+
+# show hours with rate (1 = enabled, 0 = disabled)
+HourlyRate 1
+
+# show rate in summary (1 = enabled, 0 = disabled)
+SummaryRate 1
+
+# layout of summary (1 = with monthly, 0 = without monthly)
+SummaryLayout 1
+
+# transparent background (1 = enabled, 0 = disabled)
+TransparentBg 0
+
+# image colors
+CBackground     "FFFFFF"
+CEdge           "AEAEAE"
+CHeader         "606060"
+CHeaderTitle    "FFFFFF"
+CHeaderDate     "FFFFFF"
+CText           "000000"
+CLine           "B0B0B0"
+CLineL          "-"
+CRx             "92CF00"
+CTx             "606060"
+CRxD            "-"
+CTxD            "-"

content/modules_eole_envole/vnstat.conf

@@ -0,0 +1,170 @@
+# vnStat 1.18 config file
+##
+
+# default interface
+%set %%interfaces = []
+%for interface in %%vnstat_interface
+%set %%zone = 'nom_zone_eth' + interface
+%silent %%interfaces.append(%%getVar(%%zone))
+%end for
+Interface "%%custom_join(%%interfaces,'+']"
+
+# location of the database directory
+DatabaseDir "/var/lib/vnstat"
+
+# locale (LC_ALL) ("-" = use system locale)
+Locale "-"
+
+# on which day should months change
+MonthRotate 1
+
+# date output formats for -d, -m, -t and -w
+# see 'man date' for control codes
+DayFormat    "%x"
+MonthFormat  "%b '%y"
+TopFormat    "%x"
+
+# characters used for visuals
+RXCharacter       "%"
+TXCharacter       ":"
+RXHourCharacter   "r"
+TXHourCharacter   "t"
+
+# how units are prefixed when traffic is shown
+# 0 = IEC standard prefixes (KiB/MiB/GiB/TiB)
+# 1 = old style binary prefixes (KB/MB/GB/TB)
+UnitMode 0
+
+# how units are prefixed when traffic rate is shown
+# 0 = IEC binary prefixes (Kibit/s...)
+# 1 = SI decimal prefixes (kbit/s...)
+RateUnitMode 1
+
+# output style
+# 0 = minimal & narrow, 1 = bar column visible
+# 2 = same as 1 except rate in summary and weekly
+# 3 = rate column visible
+OutputStyle 3
+
+# used rate unit (0 = bytes, 1 = bits)
+RateUnit 1
+
+# number of decimals to use in outputs
+DefaultDecimals 2
+HourlyDecimals 1
+
+# spacer for separating hourly sections (0 = none, 1 = '|', 2 = '][', 3 = '[ ]')
+HourlySectionStyle 2
+
+# try to detect interface maximum bandwidth, 0 = disable feature
+# MaxBandwidth will be used as fallback value when enabled
+BandwidthDetection 1
+
+# maximum bandwidth (Mbit) for all interfaces, 0 = disable feature
+# (unless interface specific limit is given)
+MaxBandwidth 1000
+
+# interface specific limits
+#  example 8Mbit limit for eth0 (remove # to activate):
+#MaxBWeth0 8
+
+# how many seconds should sampling for -tr take by default
+Sampletime 5
+
+# default query mode
+# 0 = normal, 1 = days, 2 = months, 3 = top10
+# 4 = exportdb, 5 = short, 6 = weeks, 7 = hours
+QueryMode 0
+
+# filesystem disk space check (1 = enabled, 0 = disabled)
+CheckDiskSpace 1
+
+# database file locking (1 = enabled, 0 = disabled)
+UseFileLocking 1
+
+# how much the boot time can variate between updates (seconds)
+BootVariation 15
+
+# log days without traffic to daily list (1 = enabled, 0 = disabled)
+TrafficlessDays 1
+
+
+# vnstatd
+##
+
+# switch to given user when started as root (leave empty to disable)
+DaemonUser "%%vnstat_user"
+
+# switch to given user when started as root (leave empty to disable)
+DaemonGroup "%%vnstat_group"
+
+# how many minutes to wait during daemon startup for system clock to
+# sync time if most recent database update appears to be in the future
+TimeSyncWait 5
+
+# how often (in seconds) interface data is updated
+UpdateInterval 30
+
+# how often (in seconds) interface status changes are checked
+PollInterval 5
+
+# how often (in minutes) data is saved to file
+SaveInterval 5
+
+# how often (in minutes) data is saved when all interface are offline
+OfflineSaveInterval 30
+
+# how often (in minutes) bandwidth detection is redone when
+# BandwidthDetection is enabled (0 = disabled)
+BandwidthDetectionInterval 5
+
+# force data save when interface status changes (1 = enabled, 0 = disabled)
+SaveOnStatusChange 1
+
+# enable / disable logging (0 = disabled, 1 = logfile, 2 = syslog)
+UseLogging 2
+
+# create dirs if needed (1 = enabled, 0 = disabled)
+CreateDirs 1
+
+# update ownership of files if needed (1 = enabled, 0 = disabled)
+UpdateFileOwner 1
+
+# file used for logging if UseLogging is set to 1
+LogFile "/var/log/vnstat/vnstat.log"
+
+# file used as daemon pid / lock file
+PidFile "/var/run/vnstat/vnstat.pid"
+
+
+# vnstati
+##
+
+# title timestamp format
+HeaderFormat "%x %H:%M"
+
+# show hours with rate (1 = enabled, 0 = disabled)
+HourlyRate 1
+
+# show rate in summary (1 = enabled, 0 = disabled)
+SummaryRate 1
+
+# layout of summary (1 = with monthly, 0 = without monthly)
+SummaryLayout 1
+
+# transparent background (1 = enabled, 0 = disabled)
+TransparentBg 0
+
+# image colors
+CBackground     "FFFFFF"
+CEdge           "AEAEAE"
+CHeader         "606060"
+CHeaderTitle    "FFFFFF"
+CHeaderDate     "FFFFFF"
+CText           "000000"
+CLine           "B0B0B0"
+CLineL          "-"
+CRx             "92CF00"
+CTx             "606060"
+CRxD            "-"
+CTxD            "-"

content/style/00-entete-pied-de-page.tex

@@ -6,6 +6,6 @@
 %\fancyhead[R]{ }
 
 \fancyfoot[L]{{\tiny \@title \\ \numeroversion}}
-\fancyfoot[C]{{\tiny  {\scriptsize \textbf{\cadoles}} \\ {\adresse  \codepostal  \ville} }}
+\fancyfoot[C]{{\tiny  {\scriptsize \textbf{\cadoles}} \\ {\adresse,~\codepostal~\ville} }}
 \fancyfoot[R]{{\tiny  \thepage / \pageref{LastPage} \\ \telephone }}
 

content/style/preambule-article.tex

@@ -46,6 +46,7 @@
 \usepackage{graphicx}
 \usepackage{pdfpages}
 \usepackage{menukeys}
+\usepackage{minted}
 \makeindex
 
 %

content/style/preambule-programme.tex

@@ -0,0 +1,203 @@
+\usepackage{ifxetex}
+\ifxetex
+   \usepackage{fontspec}
+   %\usepackage{microtype}
+  %\usepackage{xunicode}
+   \usepackage{polyglossia}
+   \usepackage{xltxtra}
+   \setdefaultlanguage{french}
+   \setotherlanguage{english}
+   \defaultfontfeatures{Mapping=tex-text} % To support LaTeX quoting style
+   %\setmainfont{Caviar Dreams}
+   \newfontfamily\headingfont[]{Caviar Dreams}
+   \usepackage{titlesec}
+   \defaultfontfeatures{Ligatures=TeX}
+   % Set sans serif font to Calibri
+   \setsansfont{LiberationSans}
+   % Set serifed font to Cambria
+   \setmainfont{LiberationSans}
+\else
+   \usepackage[utf8]{inputenc}
+   \usepackage[T1]{fontenc}
+   \usepackage{amsfonts}
+   \usepackage[english, francais]{babel}
+\fi
+\usepackage{pifont}
+\usepackage{geometry}
+\usepackage{fancybox}
+\usepackage{verbatim}
+\usepackage{eurosym}
+%\usepackage{color}
+\usepackage[svgnames,table]{xcolor}
+\usepackage{listings}
+\usepackage{graphicx}
+\usepackage{hyperref}
+\usepackage{titlesec}
+\usepackage{fancyhdr}
+\usepackage{lastpage}
+%\usepackage{enumitem}
+\usepackage{makeidx}
+\usepackage{tocbibind}
+\usepackage[backend=biber,hyperref=true,backref=true]{biblatex}
+\addbibresource{biblio.bib}
+\usepackage{url}
+\renewcommand{\baselinestretch}{1.3}
+\addto\captionsfrench{\renewcommand{\contentsname}{Sommaire}}
+\usepackage{graphicx}
+\usepackage{pdfpages}
+\makeindex
+
+%
+% Tableaux
+%
+\usepackage{array}
+\usepackage{booktabs}
+\usepackage{colortbl}
+
+% Default
+\newcolumntype{1}{l}
+\newcolumntype{2}{l}
+\newcolumntype{3}{l}
+\newcolumntype{4}{l}
+\newcolumntype{5}{l}
+\newcolumntype{6}{l}
+\newcolumntype{7}{l}
+\newcolumntype{8}{l}
+\newcommand*\heading{}
+\newcommand*\beforeheading{}
+\newcommand*\afterheading{}
+\newcommand*\normalline{}
+\newcommand*\lastline{}
+
+%\renewcommand*\toprule{\arrayrulecolor{red}{\hline}}
+
+% Nice looking rules, centered cells
+\newcolumntype{1}{c}
+\newcolumntype{2}{c}
+\newcolumntype{3}{c}
+\newcolumntype{4}{c}
+\newcolumntype{5}{c}
+\newcolumntype{6}{c}
+\newcolumntype{7}{c}
+\newcolumntype{8}{c}
+\renewcommand*\heading[1]{\chapterfont\MakeUppercase{#1}}
+\renewcommand*\beforeheading{\arrayrulecolor{CadolesBlue}\toprule}
+\renewcommand*\afterheading{\midrule}
+\renewcommand*\normalline{}
+\renewcommand*\lastline{\bottomrule}
+
+\definecolor{CadolesBlue}{rgb}{.16,.50,.69}
+\definecolor{CadolesLightBlue}{rgb}{.31,.506,.741}
+\newfontfamily\cadolesfont{Caviar Dreams}
+\newfontfamily\chapterfont[Color=CadolesBlue]{Caviar Dreams}
+\newfontfamily\sectionfont[Color=CadolesBlue]{Caviar Dreams}
+\newfontfamily\subsectionfont[Color=CadolesLightBlue]{Caviar Dreams}
+\newfontfamily\subsubsectionfont[Color=CadolesLightBlue]{Caviar Dreams}
+
+\newcommand{\tickYes}{\color{Green}\checkmark}
+\newcommand{\tickNo}{\color{red}{\hspace{1pt}\ding{55}}}
+\newcommand{\wlink}[1]{\textcolor{CadolesBlue}{\underline{#1}}}
+\newcommand{\classname}[1]{\texttt{\textbf{#1}}}
+%\newcommand{\cadoles}{\chapterfont{Cadoles}}
+\newcommand{\cadoles}{\cadolesfont\textcolor{black}{Cad}\textcolor{CadolesBlue}{ole}\textcolor{black}{s}}
+\newcommand{\TitleRule}{\rule[0.5ex]{12cm}{0.5mm}}
+\newcommand\espace{\vrule height 20pt width 0pt}
+\newcommand{\titre}[1]{{\color{DarkBlue}\normalfont\LARGE\bfseries #1\smallskip\hrule height 1pt}\bigskip}
+\renewcommand*\abstractname{Summary}
+%\renewcommand{\FrenchLabelItem}{\color{DarkBlue}{\ding{68}}}
+\let\oldfootnoterule\footnoterule
+\renewcommand\footnoterule{\vspace*{-3pt}%
+\noindent\rule{3in}{0.4pt}\vspace*{2.6pt}}% -3 + 0.4 + 2.6 = 0
+
+%\pagestyle{headings}  
+\makeatletter
+\renewcommand{\thesection}{}
+\titleformat{\chapter}{\LARGE\chapterfont}{\thesection}{0ex}{}[\color{CadolesBlue}\hrule height 1pt]
+\titleformat{\section}{\Large\sectionfont}{\thesection}{0ex}{}[\color{CadolesBlue}\hrule height 1pt]
+\titleformat{\subsection}{\large\subsectionfont}{\thesection}{0ex}{}
+\titleformat{\subsubsection}{\itshape\subsubsectionfont}{\thesection}{0ex}{}
+
+\skbinput[from=rep]{style/00-entete-pied-de-page}
+
+\def\maketitle{
+\skbfigure[center]{logos/Cadoles}
+   \vspace{4.5cm}
+   
+   \begin{flushleft}
+      \textbf{\Huge \cadolesfont\textcolor{CadolesBlue}{\@title}}
+   \end{flushleft}
+   \begin{center}
+      \color{CadolesBlue}\TitleRule
+   \end{center}
+   \begin{flushright}
+      \vspace{-1.5ex}
+      \textbf{\huge \cadolesfont\textcolor{DarkGrey}{\departement}}
+   \end{flushright}
+   \vspace{2.5cm}
+   \pagebreak
+}
+
+
+\def\origine{
+   \vspace{1.5cm}
+   \begin{flushleft}
+      \begin{minipage}[l]{8cm}
+	      \skbinput[from=rep]{style/00-Coordonnees}
+      \end{minipage}
+   \end{flushleft}
+}
+
+%
+% Itemize avec la petite cadoles
+%
+%\newenvironment{citemize}{\renewcommand{\labelitemi{$\odot$}}}
+%\newenvironment{citemize}{\renewcommand{\labelitemi{\includegraphics[height=1.6ex]{inc/cadole.png}}}}
+\newenvironment{citemize}{\renewcommand
+    \labelitemi{\includegraphics[height=1ex]{inc/cadole.png}}\begin{itemize}}{\end{itemize}}
+
+
+%
+% Box pour citations
+%
+\newsavebox{\fmbox}
+\newenvironment{fmpage}[1]
+     {\begin{lrbox}{\fmbox}\begin{minipage}{#1}}
+     {\end{minipage}\end{lrbox}\fbox{\usebox{\fmbox}}}
+
+\hypersetup{
+       backref=true,                           % Permet d'ajouter des liens dans
+       pagebackref=true,                       % les bibliographies
+       hyperindex=true,                        % Ajoute des liens dans les index.
+       colorlinks=true,                        % Colorise les liens.
+       breaklinks=true,                        % Permet le retour à la ligne dans les liens trop longs.
+       urlcolor= CadolesBlue,                  % Couleur des hyperliens.
+       linkcolor= CadolesBlue,                        % Couleur des liens internes.
+       bookmarks=true,                         % Créé des signets pour Acrobat.
+       bookmarksopen=true,                     % Si les signets Acrobat sont créés,
+                                               % les afficher complètement.
+       pdftitle={\@title},  % Titre du document.
+                                               % Informations apparaissant dans
+       pdfauthor={Cadoles},                    % dans les informations du document
+       pdfsubject={Proposition Commerciale}    % sous Acrobat.
+}
+
+
+
+%\topmargin 0in
+%\leftmargin 2.5cm
+%\rightmargin 2.5cm
+
+\setlength{\hoffset}{-18pt}        
+\setlength{\oddsidemargin}{0pt} % Marge gauche sur pages impaires
+\setlength{\evensidemargin}{9pt} % Marge gauche sur pages paires
+\setlength{\marginparwidth}{54pt} % Largeur de note dans la marge
+%\setlength{\textwidth}{481pt} % Largeur de la zone de texte (17cm)
+\setlength{\voffset}{-18pt} % Bon pour DOS
+\setlength{\marginparsep}{7pt} % Séparation de la marge
+\setlength{\topmargin}{0pt} % Pas de marge en haut
+\setlength{\headheight}{13pt} % Haut de page
+\setlength{\headsep}{10pt} % Entre le haut de page et le texte
+\setlength{\footskip}{27pt} % Bas de page + séparation
+\setlength{\textheight}{708pt} % Hauteur de la zone de texte (25cm)
+
+

inc/00-entete-pied-de-page.tex

@@ -6,6 +6,6 @@
 %\fancyhead[R]{ }
 
 \fancyfoot[L]{{\tiny \@title \\ \numeroversion}}
-\fancyfoot[C]{{\tiny  {\scriptsize \textbf{\cadoles}} \\ {\adresse  \codepostal  \ville} }}
+\fancyfoot[C]{{\tiny  {\scriptsize \textbf{\cadoles}} \\ {\adresse,~\codepostal~\ville} }}
 \fancyfoot[R]{{\tiny  \thepage / \pageref{LastPage} \\ \telephone }}