Révision partielle de formations EOLE
This commit is contained in:
parent
a781e00a5a
commit
93be45617e
|
@ -0,0 +1,5 @@
|
|||
\begin{frame}
|
||||
\begin{exampleblock}{}
|
||||
Des questions ?
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,11 @@
|
|||
\section{Licence}
|
||||
Cette œuvre est mise à disposition sous licence \href{http://creativecommons.org/licenses/by-nc-sa/2.0/fr/}{\textsc{cc-by-sa-2.0}}
|
||||
\begin{itemize}
|
||||
\item Attribution
|
||||
\item Partage dans les Mêmes Conditions 2.0
|
||||
\item France
|
||||
\end{itemize}
|
||||
Pour voir une copie de cette licence, visitez
|
||||
\href{http://creativecommons.org/licenses/by-sa/2.0/fr/}{http://creativecommons.org/licenses/by-sa/2.0/fr/}
|
||||
ou écrivez à Creative Commons, 444 Castro Street, Suite 900,
|
||||
Mountain View, California, 94041, USA.
|
|
@ -0,0 +1,18 @@
|
|||
\skbheading{L’annuaire de module Scribe}
|
||||
L’annuaire du module Scribe est opéré à l’aide du logiciel OpenLDAP.
|
||||
Les schémas mis en place sont définis selon les règles métiers de l’Éducation nationale.
|
||||
Les schémas mis en place sont les suivants :
|
||||
\begin{itemize}
|
||||
\item core.schema
|
||||
\item cosine.schema
|
||||
\item inetorgperson.schema
|
||||
\item nis.schema
|
||||
\item samba.schema
|
||||
\item eole.schema
|
||||
\item eoleshare.schema
|
||||
\item radius.schema
|
||||
\item ent.schema
|
||||
\end{itemize}
|
||||
|
||||
Les schémas \emph{core.schema}, \emph{cosine.schema} et \emph{nis.schema} sont des schémas classiques pour les annuaires décrivant des personnes.
|
||||
Les autres schémas, placés dans le sous-répertoire \emph{eole}, décrivent les objets nécessaires pour Samba (\emph{samba.schema}), les objets précisant les types de personnes (\emph{eole.schema}) et les partages (\emph{eoleshare.schema}), les attributs pour l’utilisation de Radius (\emph{radius.schema}) et, enfin, les objets et attributs pour l’implémentation du schéma directeur des espaces numériques de travail (\emph{ent.schema}).
|
|
@ -0,0 +1,33 @@
|
|||
\skbheading{Les classes d’objets métiers de l’annuaire du module Scribe}
|
||||
Les classe d’objets métiers de l’annuaire du module Scribe sont celles décrites dans les schémas de plus haut niveau.
|
||||
Ces classes d’objets décrivent des utilisateurs, des groupes d’utilisateurs et des ressources comme les partages.
|
||||
Plusieurs classes d’objets peuvent être utilisées conjointement pour préciser le type de la ressource décrite : les classes d’objects sont complémentaires et ne sont pas organisées de manière hiérarchique.
|
||||
Les classes dont le nom débute par \emph{ENT} sont issues du schéma directeur des espaces numériques de travail.
|
||||
|
||||
Les classes d’objets susceptibles d’être utilisées pour les personnes sont les suivantes :
|
||||
\begin{itemize}
|
||||
\item Eleves
|
||||
\item administrateur
|
||||
\item responsable
|
||||
\item administratif
|
||||
\item ENTPerson
|
||||
\item ENTEleve
|
||||
\item ENTAuxPersRelEleve
|
||||
\item ENTAuxEnseignant
|
||||
\item ENTAuxNonEnsServAc
|
||||
\item ENTAuxNonEnsCollLoc
|
||||
\item ENTAuxNonEnsEtab
|
||||
\item ENTAuxPersExt
|
||||
\item ENTAuxTuteurStage
|
||||
\item ENTAuxRespEntrp
|
||||
\item eolemail
|
||||
\item autre
|
||||
\end{itemize}
|
||||
|
||||
Les classes d’objets susceptibles d’être utilisées pour les groupes sont les suivantes :
|
||||
\begin{itemize}
|
||||
\item eolegroupe
|
||||
\item classe
|
||||
\item ENTGroupe
|
||||
\item ENTClasse
|
||||
\end{itemize}
|
|
@ -0,0 +1,79 @@
|
|||
\skbheading{La fiche du personnel administratif dans l’annuaire du module Scribe}
|
||||
Le personnel administratif, dans l’annuaire du module Scribe, est la conjonction de plusieurs classes d’objets :
|
||||
\begin{itemize}
|
||||
\item top
|
||||
\item person
|
||||
\item organizationalPerson
|
||||
\item posixAccount
|
||||
\item shadowAccount
|
||||
\item inetOrgPerson
|
||||
\item sambaSamAccount
|
||||
\item administratif
|
||||
\item ENTPerson
|
||||
\item ENTAuxNonEnsEtab
|
||||
\item radiusprofile
|
||||
\end{itemize}
|
||||
|
||||
La partie métier est portée par les classes \emph{administratif}, \emph{ENTPerson} et \emph{ENTAuxNonEnsEtab}.
|
||||
Les attributs susceptibles d’être associés à un personnel administratif sont les suivants :
|
||||
\begin{itemize}
|
||||
\item les attributs issus de la classe administratif :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item typeadmin
|
||||
\item codecivilite
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item dateNaissance
|
||||
\item mailDir
|
||||
\item mailHost
|
||||
\item intid
|
||||
\item FederationKey
|
||||
\item Divcod
|
||||
\item ManagedGroup
|
||||
\item LastUpdate
|
||||
\item mailAlternateAddress
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
|
||||
\item les attributs issus de la classe ENTPerson :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item ENTPersonLogin
|
||||
\item ENTPersonJointure
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item ENTPersonAutresPrenoms
|
||||
\item ENTPersonNomPatro
|
||||
\item ENTPersonSexe
|
||||
\item ENTPersonCentresInteret
|
||||
\item ENTPersonAdresse
|
||||
\item ENTPersonCodePostal
|
||||
\item ENTPersonVille
|
||||
\item ENTPersonPays
|
||||
\item ENTPersonAlias
|
||||
\item ENTPersonStructRattach
|
||||
\item ENTPersonFonctions
|
||||
\item ENTPersonProfils
|
||||
\item ENTPersonDateNaissance
|
||||
\item personalTitle
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
|
||||
\item les attributs issus de la classe ENTAuxNonEnsEtab :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item aucun attribut obligatoire
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item ENTAuxNonEnsEtabService
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
|
|
@ -0,0 +1,97 @@
|
|||
\skbheading{La fiche de l’élève dans l’annuaire du module Scribe}
|
||||
L’élève, dans l’annuaire du module Scribe, est la conjonction de plusieurs classes d’objets :
|
||||
\begin{itemize}
|
||||
\item top
|
||||
\item person
|
||||
\item organizationalPerson
|
||||
\item posixAccount
|
||||
\item shadowAccount
|
||||
\item inetOrgPerson
|
||||
\item sambaSamAccount
|
||||
\item Eleves
|
||||
\item ENTPerson
|
||||
\item ENTEleve
|
||||
\item radiusprofile
|
||||
\end{itemize}
|
||||
|
||||
La partie métier est portée par les classes \emph{Eleves} et \emph{ENTEleve}.
|
||||
Les attributs susceptibles d’être associés à un élève sont les suivants :
|
||||
\begin{itemize}
|
||||
\item les attributs issus de la classe Eleves :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item givenName
|
||||
\item codecivilite
|
||||
\item mail
|
||||
\item mailHost
|
||||
\item userPassword
|
||||
\item employeeNumber
|
||||
\item dateNaissance
|
||||
\item Meflcf
|
||||
\item Divcod
|
||||
\item uid
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item mailDir
|
||||
\item telephoneNumber
|
||||
\item mailForwardingAddress
|
||||
\item mailAlternateAddress
|
||||
\item textelibre
|
||||
\item photo
|
||||
\item diffusion
|
||||
\item dermaj
|
||||
\item Meflcm
|
||||
\item Divcodmso
|
||||
\item mailparent
|
||||
\item FederationKey
|
||||
\item Ine
|
||||
\item postalAddress
|
||||
\item rne
|
||||
\item LastUpdate
|
||||
\item intid
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
\item les attributs issus de la classe ENTEleve :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item ENTEleveStatutEleve
|
||||
\item ENTEleveMEF
|
||||
\item ENTEleveLibelleMEF
|
||||
\item ENTEleveNivFormation
|
||||
\item ENTEleveFiliere
|
||||
\item ENTEleveEnseignements
|
||||
\item ENTEleveClasses
|
||||
\item ENTEleveMajeur
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item ENTEleveVilleNaissance
|
||||
\item ENTEleveDeptNaissance
|
||||
\item ENTElevePaysNaissance
|
||||
\item ENTEleveParents
|
||||
\item ENTEleveAutoriteParentale
|
||||
\item ENTElevePersRelEleve1
|
||||
\item ENTEleveQualitePersRelEleve1
|
||||
\item ENTElevePersRelEleve2
|
||||
\item ENTEleveQualitePersRelEleve2
|
||||
\item ENTEleveBoursier
|
||||
\item ENTEleveRegime
|
||||
\item ENTEleveTransport
|
||||
\item ENTEleveMEFRattach
|
||||
\item ENTEleveNivFormationDiplome
|
||||
\item ENTEleveSpecialite
|
||||
\item ENTEleveGroupes
|
||||
\item ENTEleveEnsRespStage
|
||||
\item ENTEleveEnsTutStage
|
||||
\item ENTEleveEntrTutStage
|
||||
\item ENTEleveEntrAutres
|
||||
\item ENTEleveDelegClasse
|
||||
\item ENTEleveDelegAutres
|
||||
\item ENTEleveMajeurAnticipe
|
||||
\item ENTEleveStructRattachId
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
\end{itemize}
|
|
@ -0,0 +1,89 @@
|
|||
\skbheading{La fiche de l’enseignant dans l’annuaire du module Scribe}
|
||||
L’enseignant, dans l’annuaire du module Scribe, est la conjonction de plusieurs classes d’objets :
|
||||
\begin{itemize}
|
||||
\item top
|
||||
\item person
|
||||
\item organizationalPerson
|
||||
\item posixAccount
|
||||
\item shadowAccount
|
||||
\item inetOrgPerson
|
||||
\item sambaSamAccount
|
||||
\item administrateur
|
||||
\item ENTPerson
|
||||
\item ENTAuxEnseignant
|
||||
\item radiusprofile
|
||||
\end{itemize}
|
||||
|
||||
La partie métier est portée par les classes \emph{administrateur}, \emph{ENTPerson} et \emph{ENTAuxEnseignant}.
|
||||
Les attributs susceptibles d’être associés à un enseignant sont les suivants :
|
||||
|
||||
\begin{itemize}
|
||||
\item les attributs issus de la classe administrateur :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item typeadmin
|
||||
\item codecivilite
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item dateNaissance
|
||||
\item mailDir
|
||||
\item mailHost
|
||||
\item mailForwardingAddress
|
||||
\item mailAlternateAddress
|
||||
\item Meflcf
|
||||
\item Divcod
|
||||
\item FederationKey
|
||||
\item ManagedGroup
|
||||
\item LastUpdate
|
||||
\item intid
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
|
||||
\item les attributs issus de la classe ENTPerson :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item ENTPersonLogin
|
||||
\item ENTPersonJointure
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item ENTPersonAutresPrenoms
|
||||
\item ENTPersonNomPatro
|
||||
\item ENTPersonSexe
|
||||
\item ENTPersonCentresInteret
|
||||
\item ENTPersonAdresse
|
||||
\item ENTPersonCodePostal
|
||||
\item ENTPersonVille
|
||||
\item ENTPersonPays
|
||||
\item ENTPersonAlias
|
||||
\item ENTPersonStructRattach
|
||||
\item ENTPersonFonctions
|
||||
\item ENTPersonProfils
|
||||
\item ENTPersonDateNaissance
|
||||
\item personalTitle
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
|
||||
\item les attributs issus de la classe ENTAuxEnseignant :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item aucun attribut obligatoire
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item ENTAuxsEnsMEF
|
||||
\item ENTAuxEnsCategoDiscipline
|
||||
\item ENTAuxEnsMatiereEnseignEtab
|
||||
\item ENTAuxEnsClasses
|
||||
\item ENTAuxEnsGroupes
|
||||
\item ENTAuxEnsClassePrincipal
|
||||
\item ENTAuxEnsRespStage
|
||||
\item ENTAuxEnsTutStage
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
|
|
@ -0,0 +1,73 @@
|
|||
\skbheading{La fiche du responsable d’élève dans l’annuaire du module Scribe}
|
||||
Le responsable d’élève, dans l’annuaire du module Scribe, est la conjonction de plusieurs classes d’objets :
|
||||
\begin{itemize}
|
||||
\item inetOrgPerson
|
||||
\item responsable
|
||||
\item ENTPerson
|
||||
\item ENTAuxPersRelEleve
|
||||
\end{itemize}
|
||||
|
||||
La partie métier est portée par les classes \emph{responsable}, \emph{ENTPerson} et \emph{ENTAuxPersRelEleve}.
|
||||
Les attributs susceptibles d’être associés à un responsable d’élève sont les suivants :
|
||||
\begin{itemize}
|
||||
\item les attributs issus de la classe responsable :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item aucun attribut obligatoire
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item mailDir
|
||||
\item mailHost
|
||||
\item sambaLMPassword
|
||||
\item sambaNTPassword
|
||||
\item codecivilite
|
||||
\item LastUpdate
|
||||
\item gecos
|
||||
\item eleve
|
||||
\item intid
|
||||
\item dateNaissance
|
||||
\item mailPerso
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
\item les attributs issus de la classe ENTPerson :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item ENTPersonLogin
|
||||
\item ENTPersonJointure
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item ENTPersonAutresPrenoms
|
||||
\item ENTPersonNomPatro
|
||||
\item ENTPersonSexe
|
||||
\item ENTPersonCentresInteret
|
||||
\item ENTPersonAdresse
|
||||
\item ENTPersonCodePostal
|
||||
\item ENTPersonVille
|
||||
\item ENTPersonPays
|
||||
\item ENTPersonAlias
|
||||
\item ENTPersonStructRattach
|
||||
\item ENTPersonFonctions
|
||||
\item ENTPersonProfils
|
||||
\item ENTPersonDateNaissance
|
||||
\item personalTitle
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
|
||||
|
||||
\item les attributs issus de la classe ENTAuxPersRelEleve :
|
||||
\begin{itemize}
|
||||
\item dont les attributs obligatoires :
|
||||
\begin{itemize}
|
||||
\item ENTAuxPersRelEleveEleve
|
||||
\end{itemize}
|
||||
\item et les attributs optionnels :
|
||||
\begin{itemize}
|
||||
\item ENTAuxPersRelEleveRepresentant
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
|
|
@ -0,0 +1,2 @@
|
|||
\skbheading{schemas.tex}
|
||||
fichier content/modules\_eole\_envole/scribe/annuaire/schemas.tex à éditer
|
|
@ -0,0 +1,29 @@
|
|||
\skbheading{Les outils du backend Scribe}
|
||||
Le module Scribe amène des scripts pour la gestion des utilisateurs et des fonctions liées.
|
||||
Ces fonctions utilisent les mêmes bibliothèques que l’EAD2 pour la gestion des utilisateurs et groupes et sont donc une façon équivalente de manipuler l’annuaire.
|
||||
|
||||
La liste des scripts disponibles est la suivante :
|
||||
\begin{itemize}
|
||||
\item ajout\_partage.py
|
||||
\item change-classe.py
|
||||
\item config-controle-vnc.py
|
||||
\item creation-administratif.py
|
||||
\item creation-eleve.py
|
||||
\item creation-groupe.py
|
||||
\item creation-prof.py
|
||||
\item desinscription.py
|
||||
\item droits\_partage.sh
|
||||
\item droits\_user.py
|
||||
\item inscription.py
|
||||
\item mailsync.py
|
||||
\item maj\_regle\_esu.sh
|
||||
\item manage\_special\_shares.py
|
||||
\item migre-domaine-messagerie.sh
|
||||
\item modifie\_profil.py
|
||||
\item regenalias.sh
|
||||
\item regen\_maillist.py
|
||||
\item suppression\_groupe.py
|
||||
\item suppression\_utilisateur.py
|
||||
\item zenity\_console.py
|
||||
\end{itemize}
|
||||
|
|
@ -0,0 +1,2 @@
|
|||
\skbheading{creation-administratif.tex}
|
||||
fichier content/modules\_eole\_envole/scribe/backend/creation-administratif.tex à éditer
|
|
@ -0,0 +1,28 @@
|
|||
\skbheading{creation-eleve.py}
|
||||
Le script \emph{creation-eleve.py} est utilisé pour créer un nouvel utilisateur du type élève dans l’annuaire du module Scribe.
|
||||
La fiche d’un élève dans l’annuaire du scribe contient obligatoirement :
|
||||
\begin{itemize}
|
||||
\item un identifiant de connexion ;
|
||||
\item la classe de rattachement ;
|
||||
\item un mot de passe ;
|
||||
\item le prénom de l’élève ;
|
||||
\item le nom de famille de l’élève ;
|
||||
\item la date de naissance de l’élève ;
|
||||
\item le numéro de l’élève ;
|
||||
\item la civilité de l’élève.
|
||||
\end{itemize}
|
||||
En complément, il est possible de renseigner les éléments suivants :
|
||||
\begin{itemize}
|
||||
\item le niveau de l’élève ;
|
||||
\item le type de domaine pour le courriel de l’élève ;
|
||||
\item un quota disque à assigner à l’élève ;
|
||||
\item le type de profil pour l’utilisation d’un poste client Windows ;
|
||||
\item l’activation du shell pour permettre la connexion sur un poste client GNU/Linux.
|
||||
\end{itemize}
|
||||
|
||||
\begin{description}
|
||||
\item[emplacement] /usr/share/eole/backend
|
||||
\item[aide] creation-eleve.py
|
||||
\end{description}
|
||||
|
||||
|
|
@ -0,0 +1,2 @@
|
|||
\skbheading{creation-groupe.tex}
|
||||
fichier content/modules\_eole\_envole/scribe/backend/creation-groupe.tex à éditer
|
|
@ -0,0 +1,2 @@
|
|||
\skbheading{creation-prof.tex}
|
||||
fichier content/modules\_eole\_envole/scribe/backend/creation-prof.tex à éditer
|
|
@ -0,0 +1,9 @@
|
|||
\begin{frame}
|
||||
\frametitle{Source Code Management}
|
||||
\begin{description}
|
||||
\item[SCM] Système de gestion du code source
|
||||
\end{description}
|
||||
\begin{exampleblock}{}
|
||||
Outil permettant le développement de code informatique en conservant les étapes de création.
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,11 @@
|
|||
\begin{frame}
|
||||
\frametitle{Fonctionnalités d'un SCM}
|
||||
\framesubtitle{Que peut faire un SCM pour vous ?}
|
||||
Avec un SCM :
|
||||
\begin{itemize}
|
||||
\item produisez des bugs en toute quiétude
|
||||
\item déterminez qui est responsable du bug bloquant
|
||||
\item corrigez facilement ce bug
|
||||
\item identifiez cet état du code comme stable
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,47 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{Récapitulatif}
|
||||
\tiny{
|
||||
\begin{columns}
|
||||
\begin{column}{.3\textwidth}
|
||||
Faire le point :
|
||||
\begin{itemize}
|
||||
\item status
|
||||
\item ls-files
|
||||
\item diff
|
||||
\item log
|
||||
\item grep
|
||||
\item cherry
|
||||
\item show
|
||||
\item bisect
|
||||
\item blame
|
||||
\end{itemize}
|
||||
\end{column}
|
||||
\begin{column}{.3\textwidth}
|
||||
Modifier le contenu :
|
||||
\begin{itemize}
|
||||
\item checkout
|
||||
\item pull
|
||||
\item fetch
|
||||
\item merge
|
||||
\item rebase
|
||||
\item add
|
||||
\item reset
|
||||
\item clean
|
||||
\item commit
|
||||
\item cherry-pick
|
||||
\item revert
|
||||
\item push
|
||||
\item filter-branch
|
||||
\end{itemize}
|
||||
\end{column}
|
||||
\begin{column}{.3\textwidth}
|
||||
Organiser le développement :
|
||||
\begin{itemize}
|
||||
\item branch
|
||||
\item tag
|
||||
\end{itemize}
|
||||
\end{column}
|
||||
\end{columns}
|
||||
}
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{add}
|
||||
\begin{description}
|
||||
\item[\commande{git add}] Ajouter le contenu d'un fichier à l'index.
|
||||
\end{description}
|
||||
\skbinput[from=fig]{apps/git_commande_add}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{-u}] ajout des modifications des fichiers déjà connus de git
|
||||
\item[\commande{-i}] ajout interactif
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,7 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{bisect}
|
||||
\begin{description}
|
||||
\item[\commande{git bisect start}] Démarrer une session de recherche du commit problématique par division binaire
|
||||
\end{description}
|
||||
\end{frame}
|
|
@ -0,0 +1,7 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{blame}
|
||||
\begin{description}
|
||||
\item[\commande{git blame}] Afficher l'auteur et la référence de la dernière modification pour chaque ligne d'un fichier
|
||||
\end{description}
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{branch}
|
||||
\begin{description}
|
||||
\item[git branch] Gérer les branches
|
||||
\end{description}
|
||||
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--list}] Lister les branches (\commande{-a} les branches locales et distantes, \commande{-r} les branches distantes uniquement)
|
||||
\item[\commande{-d}] Supprimer une branche
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{checkout}
|
||||
\begin{description}
|
||||
\item[\commande{git checkout}] Synchroniser le répertoire de travail avec une version
|
||||
\end{description}
|
||||
\skbinput[from=fig]{apps/git_commande_checkout}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{-b}] Créer une nouvelle branche et déplacer HEAD dessus
|
||||
\item[\commande{--ours --theirs}] Conserver des modifications explicitement
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,12 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{cherry-pick}
|
||||
\begin{description}
|
||||
\item[\commande{git cherry-pick}] Appliquer les changements introduits dans un commit donné
|
||||
\end{description}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--abort}] Interrompre le processus
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,7 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{cherry}
|
||||
\begin{description}
|
||||
\item[\commande{git cherry}] Trouver les commit qui ne sont pas encore appliqués dans le dépôt distant
|
||||
\end{description}
|
||||
\end{frame}
|
|
@ -0,0 +1,13 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{clean}
|
||||
\begin{description}
|
||||
\item[\commande{git clean}] Supprime les fichiers non suivis du répertoire de travail
|
||||
\end{description}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{-xdf}] Combinaison pour supprimer du répertoire de travail les dossiers et fichiers non suivis
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{clone}
|
||||
\begin{description}
|
||||
\item[\commande{git clone <url du dépôt>}] Récupérer un dépôt git depuis une source distante
|
||||
\end{description}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,15 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{commit}
|
||||
\begin{description}
|
||||
\item[\commande{git commit}] Créer un commit à partir du contenu de l'index
|
||||
\end{description}
|
||||
\skbinput[from=fig]{apps/git_commande_commit}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{-a}] Court-circuiter l'index en intégrant au commit les modifications des fichiers suivis dans le répertoire de travail
|
||||
\item[\commande{--amend}] Modifier le dernier commit
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{diff}
|
||||
\begin{description}
|
||||
\item[\commande{git diff}] Afficher la différence entre deux états (entre le répertoire de travail ou l'index et la branche par exemple)
|
||||
\end{description}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,13 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{checkout}
|
||||
\begin{description}
|
||||
\item[git fetch] Mettre à jour la copie locale d'un dépôt distant
|
||||
\end{description}
|
||||
\skbinput[from=fig]{apps/git_commande_fetch}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[-all] Mettre à jour les copies locales de tous les dépôts distants configurés
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,13 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{filter-branch}
|
||||
\begin{description}
|
||||
\item[\commande{git filter-branch}] Exécuter une commande sur un ensemble de commit
|
||||
\end{description}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--tree-filter}] Modifier le contenu de l'arborescence pour chaque version du projet
|
||||
\item[\commande{--env-filter}] Modifier la teneur des variables d'environnement pour chaque commit
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{grep}
|
||||
\begin{description}
|
||||
\item[\commande{git grep}] Rechercher dans chaque fichier d'un arbre quelconque
|
||||
\end{description}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--break}] Sépare les résultats pour une meilleure lisibilité
|
||||
\item[\commande{--heading}] Donne le contexte du résultat
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{init}
|
||||
\begin{description}
|
||||
\item[\commande{git init}] Convertir le dossier courant en dépôt git
|
||||
\end{description}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,15 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{log}
|
||||
\begin{description}
|
||||
\item[\commande{git log}] Afficher une liste de commit
|
||||
\end{description}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{-L}] Retracer l'historique d'un morceau de code
|
||||
\item[\commande{<c1>..<c2>}] Lister les commit accessibles depuis c2 mais pas c1
|
||||
\item[\commande{<c1>...<2>}] Lister les commit accessibles depuis l'un ou l'autre mais pas des deux à la fois
|
||||
\item[\commande{--not Ref}] Lister les commit qui ne sont pas accessibles depuis Ref
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,7 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{ls-files}
|
||||
\begin{description}
|
||||
\item[\commande{git ls-files}] Afficher les informations sur les fichiers de l'index et du répertoire de travail.
|
||||
\end{description}
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{merge}
|
||||
\begin{description}
|
||||
\item[\commande{git merge}] Intégrer les commit d'une branche à une autre
|
||||
\end{description}
|
||||
%\skbinput[from=fig]{apps/git_commande_merge}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--abort}] Pour faire machine arrière lors d'un merge manuel
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{pull}
|
||||
\begin{description}
|
||||
\item[\commande{git pull}] Synchroniser une branche locale avec la branche distante
|
||||
\end{description}
|
||||
\skbinput[from=fig]{apps/git_commande_pull}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--rebase}] Choisir la stratégie rebase pour incorporer les changements (équivalent à la succession des commandes \commande{fetch} et \commande{rebase})
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,15 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{push}
|
||||
\begin{description}
|
||||
\item[\commande{git push}] Synchroniser une branche distante avec une branche locale
|
||||
\end{description}
|
||||
\skbinput[from=fig]{apps/git_commande_push}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--tags}] Pousser les tags locaux sur le dépôt distant
|
||||
\item[\commande{--all}] Pousser toutes les branches
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{rebase}
|
||||
\begin{description}
|
||||
\item[\commande{git rebase}] Rejouer les modifications après mise à jour de la branche
|
||||
\end{description}
|
||||
%\skbinput[from=fig]{apps/git_commande_rebase}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{-i}] Réordonner les modifications manuellement
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{reset}
|
||||
\begin{description}
|
||||
\item[\commande{git reset}] Revenir à une version antérieure
|
||||
\end{description}
|
||||
%\skbinput[from=fig]{apps/git_commande_reset}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--hard}] Écraser le contenu du répertoire de travail et de l'index
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{revert}
|
||||
\begin{description}
|
||||
\item[\commande{git revert}] Créer le commit annulant un autre commit
|
||||
\end{description}
|
||||
%\skbinput[from=fig]{apps/git_commande_revert}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{--abort}] Interrompre le traitement
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{show}
|
||||
\begin{description}
|
||||
\item[\commande{git show}] Afficher la description d'un commit
|
||||
\end{description}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{status}
|
||||
\begin{description}
|
||||
\item[\commande{git status}] Afficher le statut du répertoire de travail, et de l'index relativement à la branche
|
||||
\end{description}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,15 @@
|
|||
\begin{frame}
|
||||
\frametitle{Commandes git}
|
||||
\framesubtitle{tag}
|
||||
\begin{description}
|
||||
\item[\commande{git tag}] Gérer les étiquettes attachées à un commit
|
||||
\end{description}
|
||||
\begin{exampleblock}{Options à retenir}
|
||||
\begin{description}
|
||||
\item[\commande{-l}] Lister les étiquettes (éventuellement correpondant à un motif)
|
||||
\item[\commande{-a}] Annoter l'étiquette
|
||||
\item[\commande{-s}] Signer l'étiquette
|
||||
\end{description}
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,33 @@
|
|||
\begin{frame}
|
||||
\frametitle{Ergonomie}
|
||||
\framesubtitle{alias}
|
||||
Les alias sont des raccourcis gérés pas git.
|
||||
|
||||
\commande{git config alias.<nom de l'alias> "<commande>"}
|
||||
|
||||
\begin{exampleblock}{Nature des commandes}
|
||||
Les commandes peuvent aussi bien être des options et sous-commandes de git que des commandes externes accessibles au shell.
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle {Ergonomie}
|
||||
\framesubtitle{Exemples d'alias}
|
||||
\begin{minted}[fontsize=\tiny]{ini}
|
||||
[alias]
|
||||
co = checkout
|
||||
st = status
|
||||
fe = fetch
|
||||
lo = log --oneline
|
||||
re = reset --hard HEAD~1
|
||||
br = branch
|
||||
mnf = merge --no-ff
|
||||
sw = checkout @{-1}
|
||||
lu = log ..@{upstream}
|
||||
luo = log --oneline ..@{upstream}
|
||||
ul=log @{upstream}..HEAD
|
||||
ulo=log --oneline @{upstream}..HEAD
|
||||
cslt = !git describe --long --first-parent | awk -F'/' '{print $NF}' | awk -F'-' '{print $(NF-1)}'
|
||||
clf = !git lo --no-merges $(git lo -1 --pretty=format:"%h" debian/changelog)..
|
||||
\end{minted}
|
||||
\end{frame}
|
|
@ -0,0 +1,10 @@
|
|||
\begin{frame}
|
||||
\frametitle{Ergonomie}
|
||||
\framesubtitle{Interface}
|
||||
\begin{itemize}
|
||||
\item \commande{git config --global core.editor "vim"}
|
||||
\item \commande{git config --global core.pager "less"}
|
||||
\item \commande{git config --global color.ui auto}
|
||||
\end{itemize}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,47 @@
|
|||
\begin{frame}
|
||||
\frametitle{Ergonomie}
|
||||
\framesubtitle{Hooks}
|
||||
Les hooks sont des actions déclenchées par des évènements concernant le dépôt git.
|
||||
\begin{exampleblock}{}
|
||||
Les hooks sont des scripts exécutables (pas de langage imposé) posés dans le dossier .git/hooks.
|
||||
\end{exampleblock}
|
||||
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Ergonomie}
|
||||
\framesubtitle{Hooks pour le client}
|
||||
\begin{columns}
|
||||
\begin{column}{0.5\textwidth}
|
||||
\begin{itemize}
|
||||
\item pre-commit
|
||||
\item prepare-commit-msg
|
||||
\item commit-msg
|
||||
\item post-commit
|
||||
|
||||
\item applypatch-msg
|
||||
\item preapply-patch
|
||||
\item postapply-patch
|
||||
\end{itemize}
|
||||
|
||||
\end{column}
|
||||
\begin{column}{0.5\textwidth}
|
||||
\begin{itemize}
|
||||
\item pre-rebase
|
||||
\item post-rewrite
|
||||
\item post-checkout
|
||||
\item post-merge
|
||||
\item pre-push
|
||||
\end{itemize}
|
||||
\end{column}
|
||||
\end{columns}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Ergonomie}
|
||||
\framesubtitle{Hooks pour le serveur}
|
||||
\begin{itemize}
|
||||
\item pre-receive
|
||||
\item update
|
||||
\item post-receive
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Configurer git}
|
||||
\framesubtitle{Une configuration souple}
|
||||
\begin{itemize}
|
||||
\item configuration globale
|
||||
\item configuration par dépôt
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,16 @@
|
|||
\begin{frame}[fragile]
|
||||
\frametitle{Ergonomie}
|
||||
\framesubtitle{bash}
|
||||
\begin{minted}{bash}
|
||||
source ~/.git-prompt.sh
|
||||
GIT_PS1_SHOWDIRTYSTATE=1
|
||||
GIT_PS1_SHOWSTASHSTATE=1
|
||||
GIT_PS1_SHOWUNTRACKEDFILES=1
|
||||
GIT_PS1_SHOWUPSTREAM="auto"
|
||||
PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ '
|
||||
\end{minted}
|
||||
\begin{exampleblock}{git-prompt}
|
||||
git-prompt.sh est un script définissant la fonction \_\_git\_ps1 permettant d'afficher des informations pertinentes sur l'état du dépôt git dans l'invite de commande.
|
||||
\end{exampleblock}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,9 @@
|
|||
\begin{frame}
|
||||
\frametitle{Configurer git}
|
||||
\framesubtitle{Identifier l'utilisateur}
|
||||
git associe à chaque commit des informations sur la personne ayant commité et sur la personne ayant mergé le commit.
|
||||
\begin{itemize}
|
||||
\item \commande{git config --global user.name "<nom d'utilisateur>"}
|
||||
\item \commande{git config --global user.email "<courriel>"}
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,6 @@
|
|||
\begin{frame}
|
||||
\frametitle{Décentralisé}
|
||||
\begin{description}
|
||||
\item[DVCS] Système de gestion de version décentralisé
|
||||
\end{description}
|
||||
\end{frame}
|
|
@ -0,0 +1,12 @@
|
|||
\begin{frame}
|
||||
\frametitle{Les trois états des fichiers}
|
||||
\begin{itemize}
|
||||
\item non-suivi (avec la variante ignoré)
|
||||
\item suivi :
|
||||
\begin{itemize}
|
||||
\item non modifié (par rapport au dernier état archivé)
|
||||
\item modifié (par rapport au dernier état archivé)
|
||||
\item sélectionné pour être archivé
|
||||
\end{itemize}
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,10 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercices}
|
||||
\framesubtitle{Configuration globale de git}
|
||||
Les paramètres de l'application git peuvent être globaux ou propres à un dépôt.
|
||||
|
||||
L'ergonomie, l'identité, les alias sont souvent les mêmes pour tous les dépôts.
|
||||
La première étape consiste généralement à renseigner ces paramètres.
|
||||
|
||||
Le premier exercice consiste donc à renseigner un minimum de ces variables globales.
|
||||
\end{frame}
|
|
@ -0,0 +1,38 @@
|
|||
\begin{frame}
|
||||
\frametitle{Mise en place}
|
||||
\framesubtitle{Identité de l'utilisateur}
|
||||
\begin{itemize}
|
||||
\item \commande{git config --global user.name "<nom de l'utilisateur>"}
|
||||
\item \commande{git config --global user.email "<courriel de l'utilisateur>"}
|
||||
\end{itemize}
|
||||
\begin{exampleblock}{En cas d'oubli}
|
||||
\commande{git} émet un avertissement lors du premier commit si ces variables ne sont pas renseignées.
|
||||
Il est possible de corriger cet oubli facilement si les commit n'ont pas encore été partagés.
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Mise en place}
|
||||
\framesubtitle{Ergonomie}
|
||||
\begin{itemize}
|
||||
\item \commande{git config --global color.ui auto}
|
||||
\item \commande{git config --global core.editor "<éditeur de texte à utiliser>"}
|
||||
\item \commande{git config --global core.pager "<pager>"}
|
||||
\end{itemize}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Mise en place}
|
||||
\framesubtitle{Ergonomie (GNU/Linux)}
|
||||
\begin{minted}{bash}
|
||||
source ~/.git-prompt.sh
|
||||
GIT_PS1_SHOWDIRTYSTATE=1
|
||||
GIT_PS1_SHOWSTASHSTATE=1
|
||||
GIT_PS1_SHOWUNTRACKEDFILES=1
|
||||
GIT_PS1_SHOWUPSTREAM="auto"
|
||||
PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ '
|
||||
\end{minted}
|
||||
\begin{exampleblock}{git-prompt}
|
||||
git-prompt.sh est un script définissant la fonction \_\_git\_ps1 permettant d'afficher des informations pertinentes sur l'état du dépôt git dans l'invite de commande.
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,14 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercices}
|
||||
\framesubtitle{Initialiser un dépôt}
|
||||
Un dépôt git peut être amorcé de différentes façons selon le contexte.
|
||||
\begin{itemize}
|
||||
\item le dépôt existe déjà en \emph{distant} :
|
||||
\begin{itemize}
|
||||
\item le dépôt distant est déjà au format git ;
|
||||
\item le dépôt distant est géré par un autre scm ;
|
||||
\end{itemize}
|
||||
\item un répertoire local doit être converti en dépôt git ;
|
||||
\end{itemize}
|
||||
L'exercice propose la création d'un dépôt suivant ces différents contextes.
|
||||
\end{frame}
|
|
@ -0,0 +1,21 @@
|
|||
\begin{frame}
|
||||
\frametitle{Initialiser le dépôt}
|
||||
\framesubtitle{Récupérer le dépôt git distant en ssh}
|
||||
Le serveur de dépôt de test propose un dépôt par groupe.
|
||||
|
||||
\commande{git clone ssh://gogs@<adresse\_serveur>/formation/<groupe>}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Initialiser le dépôt}
|
||||
\framesubtitle{Récupérer le dépôt git distant en https}
|
||||
L'accès au serveur est aussi permis en http(s)
|
||||
|
||||
\commande{git clone http://<adresse\_serveur>:3000/formation/<groupe>}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Initialiser le dépôt}
|
||||
\framesubtitle{Convertir le dossier local en dépôt git}
|
||||
N'importe quelle répertoire peut être converti en dépôt git.
|
||||
|
||||
\commande{git init}
|
||||
\end{frame}
|
|
@ -0,0 +1,9 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercice}
|
||||
\framesubtitle{Avoir des dépôts distants en référence}
|
||||
Les dépôts distants sont un aspect important du fonctionnement d'un SCM décentralisé.
|
||||
|
||||
git permet d'associer plusieurs dépôts distants à un dépôt local et de renseigner à quelle branche de quel dépôt distant une branche locale doit se référer.
|
||||
|
||||
Le présent exercice aborde la mise en place de tels liens entre branches locales et branches distantes.
|
||||
\end{frame}
|
|
@ -0,0 +1,31 @@
|
|||
\begin{frame}
|
||||
\frametitle{Associer les dépôts distants}
|
||||
\framesubtitle{Ajouter un dépôt distant}
|
||||
\commande{git remote add <nom> <protocole>://[<utilisateur>@]<adresse>[:port]/<chemin>}
|
||||
|
||||
Exemples :
|
||||
\begin{itemize}
|
||||
\item \commande{git remote add formation ssh://gogs@localhost:3000/formation/exercices.git}
|
||||
\item \commande{git remote add formation http://gogs@localhost:3000/formation/exercices.git}
|
||||
\end{itemize}
|
||||
\begin{exampleblock}{Vérification}
|
||||
Les dépôts distants configurés peuvent être listés avec :
|
||||
\begin{itemize}
|
||||
\item \commande{git remote} pour la version sobre ou
|
||||
\item \commande{git remote -v} pour plus de détails.
|
||||
\end{itemize}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Associer les dépôts distants}
|
||||
\framesubtitle{Observer une branche distante}
|
||||
Pour une branche distante existante :
|
||||
\begin{itemize}
|
||||
\item \commande{git branch --set-upstream-to=<nom\_dépôt\_distant>/<branche\_distante>}
|
||||
\end{itemize}
|
||||
Pour une branche distante inexistante :
|
||||
\begin{itemize}
|
||||
\item \commande{git push --set-upstream <nom\_dépôt\_distant> <branche\_locale>}
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,7 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercice}
|
||||
\framesubtitle{Premier commit}
|
||||
Le premier commit est toujours le plus facile. Pas de conflit à attendre, pas de stress…
|
||||
|
||||
Cet exercice permet de revoir le fonctionnement des \emph{arbres} de git avec l'ajout d'un simple fichier dans un dossier.
|
||||
\end{frame}
|
|
@ -0,0 +1,138 @@
|
|||
\begin{frame}[fragile]
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Dépôt vide}
|
||||
Au démarrage, est un dépôt vide :
|
||||
|
||||
\begin{minted}[fontsize=\tiny]{bash}
|
||||
Sur la branche master
|
||||
|
||||
Validation initiale
|
||||
|
||||
rien à valider (créez/copiez des fichiers et utilisez "git add" pour les suivre)
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Et pourtant…}
|
||||
\begin{columns}
|
||||
\begin{column}{0.5\textwidth}
|
||||
L'initialisation consiste en la création du dossier .git :
|
||||
\end{column}
|
||||
\begin{column}{0.5\textwidth}
|
||||
\begin{minted}[fontsize=\tiny]{bash}
|
||||
.
|
||||
└── .git
|
||||
├── branches
|
||||
├── config
|
||||
├── description
|
||||
├── HEAD
|
||||
├── hooks
|
||||
│ ├── applypatch-msg.sample
|
||||
│ ├── commit-msg.sample
|
||||
│ ├── post-update.sample
|
||||
│ ├── pre-applypatch.sample
|
||||
│ ├── pre-commit.sample
|
||||
│ ├── prepare-commit-msg.sample
|
||||
│ ├── pre-push.sample
|
||||
│ ├── pre-rebase.sample
|
||||
│ └── update.sample
|
||||
├── info
|
||||
│ └── exclude
|
||||
├── objects
|
||||
│ ├── info
|
||||
│ └── pack
|
||||
└── refs
|
||||
├── heads
|
||||
└── tags
|
||||
\end{minted}
|
||||
\end{column}
|
||||
\end{columns}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Création d'un dossier}
|
||||
\commande{mkdir doc}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Création d'un dossier}
|
||||
\commande{git status}
|
||||
\begin{minted}[fontsize=\tiny]{bash}
|
||||
Sur la branche master
|
||||
|
||||
Validation initiale
|
||||
|
||||
rien à valider (créez/copiez des fichiers et utilisez "git add" pour les suivre)
|
||||
\end{minted}
|
||||
\begin{exampleblock}{}
|
||||
git ne prend en considération que le contenu des fichiers.
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Création d'un fichier}
|
||||
\commande{touch doc/README}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Création d'un fichier}
|
||||
\commande{git status}
|
||||
\begin{minted}[fontsize=\tiny]{bash}
|
||||
Sur la branche master
|
||||
|
||||
Validation initiale
|
||||
|
||||
Fichiers non suivis:
|
||||
(utilisez "git add <fichier>..." pour inclure dans ce qui sera validé)
|
||||
|
||||
doc/
|
||||
|
||||
aucune modification ajoutée à la validation mais des fichiers non suivis sont présents
|
||||
(utilisez "git add" pour les suivre)
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Création d'un fichier}
|
||||
\commande{git add .}
|
||||
\skbinput[from=fig]{apps/git_commande_add}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Création d'un fichier}
|
||||
\commande{git status}
|
||||
\begin{minted}[fontsize=\tiny]{bash}
|
||||
Sur la branche master
|
||||
|
||||
Validation initiale
|
||||
|
||||
Modifications qui seront validées :
|
||||
(utilisez "git rm --cached <fichier>..." pour désindexer)
|
||||
|
||||
nouveau fichier : doc/README
|
||||
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Création d'un fichier}
|
||||
\commande{git commit -m "Ajout du premier fichier."}
|
||||
\skbinput[from=fig]{apps/git_commande_commit}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Premier pas}
|
||||
\framesubtitle{Création d'un fichier}
|
||||
\commande{git status}
|
||||
\begin{minted}[fontsize=\tiny]{bash}
|
||||
Sur la branche master
|
||||
rien à valider, la copie de travail est propre
|
||||
\end{minted}
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercice}
|
||||
\framesubtitle{Gérer son répertoire de travail}
|
||||
Le répertoire de travail est la vue du dépôt la plus facile à prendre en main dans un dépôt git.
|
||||
|
||||
Cet exercice a pour but de bien maîtriser les quatre états des fichiers dans un dépôt git : non-suivi, suivi et identique au contenu de l'index, suivi et différent et enfin, suivi, différent et selectionné pour archivage.
|
||||
La difficulté majeure, à ce stade, est de toujours contrôler les passages d'état pour ne pas archiver un fichier indésirable par exemple.
|
||||
\end{frame}
|
|
@ -0,0 +1,115 @@
|
|||
\begin{frame}
|
||||
\frametitle{Gérer son répertoire de travail}
|
||||
\framesubtitle{Créer un fichier}
|
||||
\commande{echo "userA userApwd" > password}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Gérer son répertoire de travail}
|
||||
\framesubtitle{Modifier un fichier}
|
||||
Ajouter du texte au fichier doc/README
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Gérer son répertoire de travail}
|
||||
\framesubtitle{Admirer la complexité de la situation}
|
||||
\commande{git status}
|
||||
\begin{minted}[fontsize=\tiny]{console}
|
||||
Sur la branche master
|
||||
Modifications qui seront validées :
|
||||
(utilisez "git reset HEAD <fichier>..." pour désindexer)
|
||||
|
||||
modifié : doc/README
|
||||
|
||||
Fichiers non suivis:
|
||||
(utilisez "git add <fichier>..." pour inclure dans ce qui sera validé)
|
||||
|
||||
password
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Gérer son répertoire de travail}
|
||||
\framesubtitle{À la croisée des chemins}
|
||||
Associer les commandes suivantes :
|
||||
\begin{columns}
|
||||
\begin{column}{.3\textwidth}
|
||||
\tiny{\commande{git add .}}
|
||||
|
||||
\tiny{\commande{git commit -m "Tout de go"}}
|
||||
\end{column}
|
||||
\begin{column}{.3\textwidth}
|
||||
\tiny{\commande{git commit -am "Implicite"}}
|
||||
\end{column}
|
||||
\begin{column}{.3\textwidth}
|
||||
\tiny{\commande{git add doc/README}}
|
||||
|
||||
\tiny{\commande{git commit -m "Explicite"}}
|
||||
\end{column}
|
||||
\end{columns}
|
||||
aux résultats suivants :
|
||||
\begin{columns}
|
||||
\begin{column}{.3\textwidth}
|
||||
\begin{minted}[fontsize=\tiny,breaklines,frame=single]{console}
|
||||
Sur la branche master
|
||||
Fichiers non suivis:
|
||||
(utilisez "git add <fichier>..." pour inclure dans ce qui sera validé)
|
||||
|
||||
password
|
||||
|
||||
aucune modification ajoutée à la validation mais des fichiers non suivis sont présents (utilisez "git add" pour les suivre)
|
||||
\end{minted}
|
||||
\end{column}
|
||||
\begin{column}{.3\textwidth}
|
||||
\begin{minted}[fontsize=\tiny,breaklines,frame=single]{console}
|
||||
Sur la branche master
|
||||
rien à valider, la copie de travail est propre
|
||||
\end{minted}
|
||||
\end{column}
|
||||
\begin{column}{.3\textwidth}
|
||||
\begin{minted}[fontsize=\tiny,breaklines,frame=single]{console}
|
||||
Sur la branche master
|
||||
Fichiers non suivis:
|
||||
(utilisez "git add <fichier>..." pour inclure dans ce qui sera validé)
|
||||
|
||||
password
|
||||
|
||||
aucune modification ajoutée à la validation mais des fichiers non suivis sont présents (utilisez "git add" pour les suivre)
|
||||
\end{minted}
|
||||
\end{column}
|
||||
\end{columns}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Gérer son répertoire de travail}
|
||||
\framesubtitle{Parer les erreurs prévisibles}
|
||||
\commande{echo "password" > .gitignore}
|
||||
|
||||
\commande{git add .gitignore}
|
||||
|
||||
\commande{git commit -m "Filtre de fichier à ne pas suivre"}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Gérer son répertoire de travail}
|
||||
\framesubtitle{Laisser sur le côté de la route}
|
||||
\commande{git status}
|
||||
\begin{minted}[fontsize=\tiny]{console}
|
||||
Sur la branche master
|
||||
rien à valider, la copie de travail est propre
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Gérer son répertoire de travail}
|
||||
\framesubtitle{Et s'il est trop tard ?}
|
||||
\commande{git reset HEAD\~{}1}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Gérer son répertoire de travail}
|
||||
\framesubtitle{Recueil de .gitignore}
|
||||
Des .gitignore adaptés à différents contextes sont faciles à obtenir sur l'Internet.
|
||||
|
||||
\url{https://github.com/github/gitignore}
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercice}
|
||||
\framesubtitle{Utiliser les branches}
|
||||
Les branches sont faciles à créer et détruire dans un dépôt git.
|
||||
Cela en fait un outil de choix pour l'organisation du développement.
|
||||
|
||||
L'exercice suivant aborde les manipulations de base avec les branches.
|
||||
\end{frame}
|
|
@ -0,0 +1,219 @@
|
|||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\framesubtitle{Créer une branche}
|
||||
On créé une branche qui contiendra le fichier password.
|
||||
|
||||
\commande{git checkout -b branche\_indiscrete}
|
||||
|
||||
équivalent de la succession de commandes :
|
||||
\begin{enumerate}
|
||||
\item \commande{git branch branche\_indiscrete}
|
||||
\item \commande{git checkout branche\_indiscrete}
|
||||
\end{enumerate}
|
||||
\begin{tikzpicture}
|
||||
\gitDAG[grow right sep = 1em]{
|
||||
A -- B};
|
||||
\gitbranch{master}{above=of B}{B}
|
||||
\gitHEAD{above=of master}{master}
|
||||
\end{tikzpicture}
|
||||
\begin{tikzpicture}
|
||||
\gitDAG[grow right sep = 1em]{
|
||||
A -- B};
|
||||
\gitbranch{master}{above=of B}{B}
|
||||
\gitHEAD{above=of master}{master}
|
||||
\gitbranch[brindis]{brancheindiscrete}{below=of B}{B}
|
||||
\end{tikzpicture}
|
||||
\begin{tikzpicture}
|
||||
\gitDAG[grow right sep = 1em]{
|
||||
A -- B};
|
||||
\gitbranch{master}{above=of B}{B}
|
||||
\gitbranch[brindis]{brancheindiscrete}{below=of B}{B}
|
||||
\gitHEAD{below=of brindis}{brindis}
|
||||
\end{tikzpicture}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\frametitle{Aparté}
|
||||
\commande{git add password}
|
||||
|
||||
\commande{git commit -m "le fichier indésirable"}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\frametitle{Aparté}
|
||||
\commande{git log master..branche\_indiscrete}
|
||||
|
||||
\commande{git log master..}
|
||||
|
||||
\commande{git reflog}
|
||||
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\framesubtitle{Merge}
|
||||
\commande{git checkout master}
|
||||
|
||||
\commande{git branch merge/automatique}
|
||||
|
||||
\commande{git branch merge/conflit}
|
||||
|
||||
\commande{git branch merge/rebase}
|
||||
% \begin{tikzpicture}
|
||||
% \gitDAG[grow down sep = 1em]{
|
||||
% A -- B};
|
||||
% \gitbranch{master}{left=of B}{B}
|
||||
% \gitHEAD{left=of master}{master}
|
||||
% \gitbranch[auto]{merge/automatique}{right=of master}{B}
|
||||
% \gitbranch[conflit]{merge/conflit}{right=of auto}{B}
|
||||
% \gitbranch[rebase]{merge/rebase}{right=of conflit}{B}
|
||||
% \end{tikzpicture}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\framesubtitle{Merge}
|
||||
\commande{git checkout merge/automatique}
|
||||
|
||||
\commande{cp doc/README\{,.md\}}
|
||||
|
||||
\commande{git add doc/}
|
||||
|
||||
\commande{git commit -m "Copie du fichier"}
|
||||
% \begin{tikzpicture}
|
||||
% \gitDAG[grow down sep = 1em]{
|
||||
% A -- B --{C}};
|
||||
% \gitbranch{master}{right=of B}{B}
|
||||
% \gitHEAD{left=of auto}{auto}
|
||||
% \gitbranch[auto]{merge/automatique}{left=of C}{C}
|
||||
% \gitbranch[conflit]{merge/conflit}{right=of master}{B}
|
||||
% \gitbranch[rebase]{merge/rebase}{right=of conflit}{B}
|
||||
% \end{tikzpicture}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\framesubtitle{Merge}
|
||||
\commande{git checkout merge/conflit}
|
||||
|
||||
Édition du fichier doc/README
|
||||
|
||||
\commande{git commit -am "Des ennuis en perspective"}
|
||||
|
||||
% \begin{tikzpicture}
|
||||
% \gitDAG[grow down sep = 1em]{
|
||||
% A -- B --{C, D}};
|
||||
% \gitbranch{master}{right=of B}{B}
|
||||
% \gitHEAD{left=of conflit}{conflit}
|
||||
% \gitbranch[auto]{merge/automatique}{right=of C}{C}
|
||||
% \gitbranch[conflit]{merge/conflit}{left=of D}{D}
|
||||
% \gitbranch[rebase]{merge/rebase}{right=of master}{B}
|
||||
% \end{tikzpicture}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\framesubtitle{Merge}
|
||||
\commande{git checkout merge/rebase}
|
||||
|
||||
Édition du fichier doc/README
|
||||
|
||||
\commande{git commit -am "Des ennuis en perspective"}
|
||||
|
||||
% \begin{tikzpicture}
|
||||
% \gitDAG[grow right sep = 1em]{
|
||||
% A -- B --{C, D, E}};
|
||||
% \gitbranch{master}{above=of B}{B}
|
||||
% \gitHEAD{above=of rebase}{rebase}
|
||||
% \gitbranch[auto]{merge/automatique}{above=of C}{C}
|
||||
% \gitbranch[conflit]{merge/conflit}{above=of D}{D}
|
||||
% \gitbranch[rebase]{merge/rebase}{above=of E}{E}
|
||||
% \end{tikzpicture}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\framesubtitle{Merge}
|
||||
|
||||
\commande{git checkout master}
|
||||
|
||||
Édition du fichier doc/README pour ajouter des alias
|
||||
|
||||
\commande{git commit -am "Des ennuis en perspective"}
|
||||
|
||||
Pour chaque branche merge/*, tenter la commande :
|
||||
\commande{git merge merge/<nom>}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Utiliser les branches}
|
||||
\framesubtitle{Rebase}
|
||||
\commande{git checkout merge/rebase}
|
||||
|
||||
\commande{git rebase master}
|
||||
% \begin{tikzpicture}
|
||||
% \gitDAG[grow down sep = 1em]{
|
||||
% A -- B --{C, D, E'}};
|
||||
% \gitbranch{master}{right=of B}{B}
|
||||
% \gitHEAD{left=of rebase}{rebase}
|
||||
% \gitbranch[auto]{merge/automatique}{right=of C}{C}
|
||||
% \gitbranch[conflit]{merge/conflit}{right=of D}{D}
|
||||
% \gitbranch[rebase]{merge/rebase}{left=of E'}{E'}
|
||||
% \end{tikzpicture}
|
||||
|
||||
\end{frame}
|
||||
% \begin{tikzpicture}
|
||||
% % Commit DAG
|
||||
% \gitDAG[grow right sep = 2em]{
|
||||
% A -- B -- {
|
||||
% C,
|
||||
% D -- E,
|
||||
% }
|
||||
% };
|
||||
% % Tag reference
|
||||
% \gittag
|
||||
% [v0p1] % node name
|
||||
% {v0.1} % node text
|
||||
% {above=of A} % node placement
|
||||
% {A} % target
|
||||
% % Remote branch
|
||||
% \gitremotebranch
|
||||
% [origmaster] % node name
|
||||
% {origin/master} % node text
|
||||
% {above=of C} % node placement
|
||||
% {C} % target
|
||||
% % Branch
|
||||
% \gitbranch
|
||||
% {master} % node name and text
|
||||
% {above=of E} % node placement
|
||||
% {E} % target
|
||||
% % HEAD reference
|
||||
% \gitHEAD
|
||||
% {above=of master} % node placement
|
||||
% {master} % target
|
||||
% \end{tikzpicture}
|
||||
% \begin{tikzpicture}
|
||||
% \gitDAG[grow right sep = 2em]{
|
||||
% A -- B -- {
|
||||
% C -- D' -- E',
|
||||
% {[nodes=unreachable] D -- E },
|
||||
% }
|
||||
% };
|
||||
% % Tag reference
|
||||
% \gittag
|
||||
% [v0p1] % node name
|
||||
% {v0.1} % node text
|
||||
% {above=of A} % node placement
|
||||
% {A} % target
|
||||
% % Remote branch
|
||||
% \gitremotebranch
|
||||
% [origmaster] % node name
|
||||
% {origin/master} % node text
|
||||
% {above=of C} % node placement
|
||||
% {C} % target
|
||||
% % Branch
|
||||
% \gitbranch
|
||||
% {master} % node name and text
|
||||
% {above=of E'} % node placement
|
||||
% {E'} % target
|
||||
% % HEAD reference
|
||||
% \gitHEAD
|
||||
% {above=of master} % node placement
|
||||
% {master} % target
|
||||
% \SAandWT
|
||||
% \end{tikzpicture}
|
|
@ -0,0 +1,11 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercice}
|
||||
\framesubtitle{Inspection générale}
|
||||
Un historique de code n'a d'intérêt que si le besoin de connaître les actions
|
||||
qui ont mené à un état se fait sentir.
|
||||
|
||||
git met à disposition divers outils pour inspecter l'historique.
|
||||
Cet exercice se propose de présenter certains de ces outils.
|
||||
|
||||
Cet exercice s'appuie sur le contenu du dépôt git \emph{exercices} fourni.
|
||||
\end{frame}
|
|
@ -0,0 +1,132 @@
|
|||
\begin{frame}
|
||||
\frametitle{Inspection}
|
||||
\framesubtitle{log}
|
||||
Comparer les branches du dépôt \emph{exercices} en explorant les différentes options de git log (--graph, --all, --decorate, .., ...)
|
||||
|
||||
\commande{git log}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Inspection}
|
||||
\framesubtitle{log}
|
||||
\begin{tikzpicture}
|
||||
\begin{pgflowlevelscope}{\pgftransformscale{0.5}}
|
||||
\gitDAG[grow right sep=1em]{
|
||||
fcacc8a -- a3a980c -- {6d7f839 -- {d221665 -- 841f693 -- f5965df -- a12f94b -- 5464ee7, fe0c2b7 -- 6212e29 -- 0f13577 -- a60f3ed, f81ca5c, 7e54de0},
|
||||
30a5821, b13bcf2, 902ae87}
|
||||
};
|
||||
\gitbranch
|
||||
{master}
|
||||
{above=of 6d7f839}
|
||||
{6d7f839}
|
||||
\gitbranch
|
||||
{brancheindiscrete}
|
||||
{right=of 902ae87}
|
||||
{902ae87}
|
||||
\gitbranch
|
||||
{merge/conflit}
|
||||
{right=of 30a5821}
|
||||
{30a5821}
|
||||
\gitbranch
|
||||
{merge/automatique}
|
||||
{right=of b13bcf2}
|
||||
{b13bcf2}
|
||||
\gitbranch
|
||||
{merge/rebase}
|
||||
{right=of 7e54de0}
|
||||
{7e54de0}
|
||||
\gitbranch
|
||||
{branche/perdue}
|
||||
{right=of f81ca5c}
|
||||
{f81ca5c}
|
||||
\gitbranch
|
||||
{branche/minee}
|
||||
{above=of 5464ee7}
|
||||
{5464ee7}
|
||||
\gitbranch
|
||||
{histoire/confuse}
|
||||
{right=of a60f3ed}
|
||||
{a60f3ed}
|
||||
\end{pgflowlevelscope}
|
||||
\end{tikzpicture}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Inspection}
|
||||
\framesubtitle{bisect}
|
||||
\begin{minipage}{\textwidth}
|
||||
\begin{tikzpicture}
|
||||
%\begin{pgflowlevelscope}{\pgftransformscale{0.5}}
|
||||
\begin{pgflowlevel}{\pgftransformscale{0.6}}
|
||||
\gitDAG[grow right sep=1em]{
|
||||
fcacc8a -- a3a980c -- {6d7f839 -- {d221665 -- 841f693 -- f5965df -- a12f94b -- 5464ee7}}
|
||||
};
|
||||
\gitbranch
|
||||
{master}
|
||||
{above=of 6d7f839}
|
||||
{6d7f839}
|
||||
\gitbranch
|
||||
{branche/minee}
|
||||
{above=of 5464ee7}
|
||||
{5464ee7}
|
||||
%\end{pgflowlevelscope}
|
||||
\end{pgflowlevel}
|
||||
\end{tikzpicture}
|
||||
\end{minipage}
|
||||
|
||||
La branche minee schématise une situation dans laquelle un dysfonctionnement a été introduit mais pas détecté
|
||||
aussitôt.
|
||||
Un script \emph{test.sh} a été ajouté pour simuler le test du code.
|
||||
Il retourne \emph{0} lorsque le code est bon, \emph{1} lorsque le code est mauvais.
|
||||
|
||||
L'exercice consiste donc à utiliser la commande \commande{git bisect} pour repérer le commit ayant introduit l'erreur, c'est-à-dire à partir duquel le script retourne \emph{1}.
|
||||
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Inspection}
|
||||
\framesubtitle{bisect}
|
||||
Conditions de départ :
|
||||
\begin{itemize}
|
||||
\item dernier \emph{commit} de la branche \emph{branche/minee}
|
||||
\item dernier état du code fonctionnel : dernier \emph{commit} de la branche \emph{master}.
|
||||
\end{itemize}
|
||||
\begin{enumerate}[<+->]
|
||||
\item \commande{git checkout branche/minee}
|
||||
\item \commande{git bisect start} \# démarrage de la session de recherche
|
||||
\item \commande{git bisect bad} \# déclaration de l'état du dernier \emph{commit}
|
||||
\item \commande{git bisect good \$(git log --oneline -1 --format=\%h master)} \# déclaration du dernier état fonctionnel connu
|
||||
\end{enumerate}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Inspection}
|
||||
\framesubtitle{bisect}
|
||||
À chaque déplacement contrôlé par \commande{git bisect}, exécuter \emph{test.sh} et indiquer si l'état est fonctionnel :
|
||||
|
||||
\commande{./test.sh; [[ \$? -eq 0 ]] \&\& git bisect good || git bisect bad}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Inspection}
|
||||
\framesubtitle{bisect}
|
||||
\commande{a12f94b62f617417f4b1f8c5317bc2f033c92f5a is the first bad commit}
|
||||
|
||||
Terminer la session de recherche :
|
||||
\commande{git bisect reset}
|
||||
\end{frame}
|
||||
|
||||
\begin{frame}
|
||||
\frametitle{Inspection}
|
||||
\framesubtitle{blame}
|
||||
La conclusion précédente, vu la simplicité du code en cause, aurait pu être tirée grâce à \commande{git blame} et \commande{git log}.
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Inspection}
|
||||
\framesubtitle{blame}
|
||||
\begin{itemize}
|
||||
\item \commande{git blame test.sh}
|
||||
\item \commande{git log -S"exit 1" test.sh}
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercice}
|
||||
\framesubtitle{Travail collaboratif}
|
||||
En fait de travail collaboratif, chacun peut facilement personnifier l'enfer pour ses collègues.
|
||||
|
||||
L'exercice suivant propose de nettoyer son dépôt personnel avant de le rendre public.
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,156 @@
|
|||
\begin{frame}
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
\begin{minipage}{\textwidth}
|
||||
\begin{tikzpicture}
|
||||
%\begin{pgflowlevelscope}{\pgftransformscale{0.5}}
|
||||
\begin{pgflowlevel}{\pgftransformscale{0.6}}
|
||||
\gitDAG[grow right sep=1em]{
|
||||
fcacc8a -- a3a980c -- {6d7f839 -- {fe0c2b7 -- 6212e29 -- 0f13577 -- a60f3ed}}
|
||||
};
|
||||
\gitbranch
|
||||
{master}
|
||||
{above=of 6d7f839}
|
||||
{6d7f839}
|
||||
\gitbranch
|
||||
{histoire/confuse}
|
||||
{above=of a60f3ed}
|
||||
{a60f3ed}
|
||||
%\end{pgflowlevelscope}
|
||||
\end{pgflowlevel}
|
||||
\end{tikzpicture}
|
||||
\end{minipage}
|
||||
|
||||
Le scénario proposé pour le nettoyage s'appuie sur la branche \emph{histoire/confuse}.
|
||||
|
||||
Les \emph{commit} n'y sont pas cohérents : mélange de corrections syntaxiques, orthographiques et grammaticales.
|
||||
Le but est de redonner de la lisibilité à l'historique du dépôt en le réécrivant à l'aide de \commande{git rebase -i} et \commande{git add -i}.
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
\begin{enumerate}[<+->]
|
||||
\item \commande{git checkout histoire/confuse}
|
||||
\item \commande{git show master..} \# aperçu des modifications à réorganiser
|
||||
\item \commande{git rebase -i \$(git merge-base --fork-point master)} \# rebase de tous les commits depuis la divergence avec la branche \emph{master}
|
||||
\end{enumerate}
|
||||
\end{frame}
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
À l'origine :
|
||||
\begin{minted}[fontsize=\tiny]{console}
|
||||
pick fe0c2b7 Commit un peu rapide.
|
||||
pick 6212e29 Premier commit de correction
|
||||
pick 0f13577 Deuxième commit de correction
|
||||
pick a60f3ed Troisième et dernier (on espère) commit de correction
|
||||
\end{minted}
|
||||
Ce qu'on veut faire :
|
||||
\begin{itemize}
|
||||
\item un \emph{commit} pour les espaces superflues (0f13577 et 6212e29)
|
||||
\item un \emph{commit} pour l'orthographe et la grammaire (0f13577, a60f3ed et 6212e29)
|
||||
\item un \emph{commit} pour le contresens
|
||||
\end{itemize}
|
||||
\end{frame}
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
\begin{enumerate}[<+->]
|
||||
\item s'arrêter sur le \emph{commit} 6212e29 et répartir les modifications sur trois \emph{commit}
|
||||
\item s'arrèter sur le \emph{commit} 0f13577 et répartir les modifications sur deux \emph{commit}
|
||||
\item reformuler le message du \emph{commit} a60f3ed
|
||||
\end{enumerate}
|
||||
\begin{minted}[fontsize=\tiny]{console}
|
||||
pick fe0c2b7 Commit un peu rapide.
|
||||
e 6212e29 Premier commit de correction
|
||||
e 0f13577 Deuxième commit de correction
|
||||
r a60f3ed Troisième et dernier (on espère) commit de correction
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
Pour chaque \emph{commit} édité :
|
||||
\begin{enumerate}[<+->]
|
||||
\item \commande{git reset HEAD\~{}1}
|
||||
\item \commande{git add -i}
|
||||
\item \commande{patch} et sélection du fichier à éditer
|
||||
\item validation, refus ou édition du fragment de patch
|
||||
\item sortie du mode patch
|
||||
\item \commande{git add doc/README} suivi de \commande{git commit}
|
||||
\item si il n'y a plus de modifications, \commande{git rebase --continue}, sinon, retour à l'étape 2
|
||||
\end{enumerate}
|
||||
\end{frame}
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
\begin{minted}[fontsize=\tiny]{console}
|
||||
f500056 Corrections orthographiques et grammaticales
|
||||
a11256a Suppression des espaces superflues
|
||||
1a03003 Corrections orthographiques et grammaticales
|
||||
f48a802 Corrections orthographiques et grammaticales
|
||||
9ed1adb Suppression des espaces superflues
|
||||
7236369 Correction du contresens
|
||||
fe0c2b7 Commit un peu rapide.
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
Prêt pour la seconde passe.
|
||||
\begin{minted}[fontsize=\tiny]{console}
|
||||
pick fe0c2b7 Commit un peu rapide.
|
||||
pick 7236369 Correction du contresens
|
||||
pick 9ed1adb Suppression des espaces superflues
|
||||
s a11256a Suppression des espaces superflues
|
||||
pick f48a802 Corrections orthographiques et grammaticales
|
||||
s 1a03003 Corrections orthographiques et grammaticales
|
||||
s f500056 Corrections orthographiques et grammaticales
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
\begin{frame}[fragile]
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
Prêt pour la seconde passe.
|
||||
\begin{minted}[fontsize=\tiny]{console}
|
||||
f7caf4b Corrections orthographiques et grammaticales
|
||||
cdcf39e Suppression des espaces superflues
|
||||
7236369 Correction du contresens
|
||||
fe0c2b7 Commit un peu rapide.
|
||||
\end{minted}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
Évidemment, dans la situation décrite, peu de modifications mais imbriquées, un résultat équivalent mais plus rapidement obtenu avec :
|
||||
\begin{enumerate}[<+->]
|
||||
\item \commande{git reset \$(git merge-base --fork-point master)}
|
||||
\item \commande{git add -i}
|
||||
\end{enumerate}
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Nettoyage}
|
||||
\begin{minipage}{\textwidth}
|
||||
\begin{tikzpicture}
|
||||
%\begin{pgflowlevelscope}{\pgftransformscale{0.5}}
|
||||
\begin{pgflowlevel}{\pgftransformscale{0.6}}
|
||||
\gitDAG[grow right sep=1em]{
|
||||
fcacc8a -- a3a980c -- {902ae87}
|
||||
};
|
||||
\gitbranch
|
||||
{brancheindiscrete}
|
||||
{above=of 902ae87}
|
||||
{902ae87}
|
||||
%\end{pgflowlevelscope}
|
||||
\end{pgflowlevel}
|
||||
\end{tikzpicture}
|
||||
\end{minipage}
|
||||
|
||||
Il ne reste plus qu'à purger les \emph{commit} de tous les fichiers embarrassants, ajoutés par inadvertance.
|
||||
\begin{enumerate}[<+->]
|
||||
\item \commande{git checkout branche\_indiscrete}
|
||||
\item \commande{git filter-branch --tree-filter "git rm password" master..}
|
||||
\end{enumerate}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Travail collaboratif}
|
||||
\framesubtitle{Partager}
|
||||
Reprendre les exercices en incluant les commandes push, pull et fetch.
|
||||
|
||||
Côté serveur, tester les hooks.
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,4 @@
|
|||
\begin{frame}
|
||||
\frametitle{}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,9 @@
|
|||
\begin{frame}
|
||||
\frametitle{Exercice}
|
||||
\framesubtitle{Intégration dans les processus}
|
||||
|
||||
git est intégré dans divers processus, notamment les processus de packaging.
|
||||
|
||||
Cet exercice donne un aperçu d'une telle intégration dans le cas du packaging debian.
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,35 @@
|
|||
\begin{frame}
|
||||
\frametitle{Packaging debian}
|
||||
\framesubtitle{buildpackage}
|
||||
buildpackage regroupe les outils simplifiant le packaging debian basé sur des sources maintenues en dépôts git.
|
||||
|
||||
\commande{apt-get install git-buildpackage}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Packaging debian}
|
||||
\framesubtitle{patchs}
|
||||
gbp-pq est la commande permettant de faire correspondre les commit d'une branche aux patchs d'un paquet.
|
||||
|
||||
Depuis la branche de packaging :
|
||||
\commande{gbp-pq import}
|
||||
|
||||
Après modification du code et organisation en commit :
|
||||
\commande{gbp-pq export}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Packaging debian}
|
||||
\framesubtitle{changelog}
|
||||
git dch permet d'automatiser l'écriture du changelog en se basant sur les commit.
|
||||
|
||||
\commande{git dch}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
||||
\begin{frame}
|
||||
\frametitle{Packaging debian}
|
||||
\framesubtitle{description du paquet}
|
||||
Finalement, git buildpackage produit les fichiers nécessaires à la construction du paquet : .dsc, archive des sources, etc.
|
||||
\commande{apt-get install git-buildpackage}
|
||||
% contenu (pas trop long) de la diapositive
|
||||
\end{frame}
|
|
@ -0,0 +1,7 @@
|
|||
\begin{frame}
|
||||
\frametitle{Installer git}
|
||||
\framesubtitle{sur les systèmes d'exploitation GNU/Linux}
|
||||
\begin{itemize}
|
||||
\item apt-get, dnf, emerge, pacman, zypper, \ldots{}
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Installer git}
|
||||
\framesubtitle{sur les systèmes d'exploitation Apple}
|
||||
\begin{itemize}
|
||||
\item \url{http://git-scm.com/download/mac}
|
||||
\item \url{https://mac.github.com/}
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Installer git}
|
||||
\framesubtitle{sur les systèmes d'exploitation Microsoft©}
|
||||
\begin{itemize}
|
||||
\item \url{http://git-scm.com/download/win}
|
||||
\item \url{https://windows.github.com/}
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,9 @@
|
|||
\begin{frame}
|
||||
\frametitle{Git en un mot}
|
||||
\begin{itemize}
|
||||
\item projet créé en 2005
|
||||
\item sous licence GPLv2
|
||||
\item gère le code source du noyau linux
|
||||
\item est multiplateforme
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Références}
|
||||
\begin{itemize}
|
||||
\item \url{http://www.git-scm.com/docs}
|
||||
\item Pro-git, S. Chacon et B. Straub, Apress, 2014
|
||||
\item les pages de man : gitcore-tutorial, gitworkflows, gitcvs-migration
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,11 @@
|
|||
\begin{frame}
|
||||
\frametitle{Ce que cache le dépôt git}
|
||||
\begin{description}[répertoire de travail]
|
||||
\item[.git]<1-> Les objets et la configuration locale du dépôt git
|
||||
\item[répertoire de travail]<2-> Une arborescence de fichiers accessible à l'édition, le bac à sable
|
||||
\item[index]<3-> Les changements candidats à l'archivage
|
||||
\item[HEAD]<4-> Le dernier état archivé
|
||||
\item[stash]<5-> Une zone tampon pour les modifications à mettre momentanément de côté
|
||||
\end{description}
|
||||
\skbinput[from=fig]{apps/git_trees}
|
||||
\end{frame}
|
|
@ -0,0 +1,7 @@
|
|||
\begin{frame}
|
||||
\frametitle{Serveur de dépôts git}
|
||||
\framesubtitle{Serveur basique ssh}
|
||||
Ajout des clés des utilisateurs au fichier ~/.ssh/authorized\_keys de l'utilisateur administrant les dépôts.
|
||||
|
||||
Préciser l'utilisation d'un shell restreint, git-shell, pour limiter les droits (\commande{chsh git /usr/bin/git-shell}).
|
||||
\end{frame}
|
|
@ -0,0 +1,10 @@
|
|||
\begin{frame}
|
||||
\frametitle{Serveur de dépôts git}
|
||||
\framesubtitle{GitLab}
|
||||
Application combinant un serveur de dépôts git avec une interface web conviviale.
|
||||
\begin{itemize}
|
||||
\item Gestion des utilisateurs
|
||||
\item Navigation dans les dépôts
|
||||
\item Gestion des évènements git et web
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,11 @@
|
|||
\begin{frame}
|
||||
\frametitle{Serveur de dépôts git}
|
||||
\framesubtitle{gitolite}
|
||||
Application de gestion de dépôts git sans interface graphique
|
||||
\begin{itemize}
|
||||
\item Gestion des utilisateurs
|
||||
\item Accès par ssh
|
||||
\item Gestion fine des droits
|
||||
\item Gestion sous la forme d'un dépôt git
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,10 @@
|
|||
\begin{frame}
|
||||
\frametitle{Serveur de dépôts git}
|
||||
\framesubtitle{Gogs}
|
||||
Application combinant un serveur de dépôts git avec une interface web conviviale.
|
||||
\begin{itemize}
|
||||
\item Gestion des utilisateurs
|
||||
\item Navigation dans les dépôts
|
||||
\item Gestion des évènements git et web
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,8 @@
|
|||
\begin{frame}
|
||||
\frametitle{Des branches pour étayer le tronc}
|
||||
\begin{itemize}
|
||||
\item maintenir l'histoire du code lisible
|
||||
\item faciliter les divergences
|
||||
\item éphémères ou pérennes
|
||||
\end{itemize}
|
||||
\end{frame}
|
|
@ -0,0 +1,9 @@
|
|||
\begin{frame}
|
||||
\frametitle{Un processus bien documenté}
|
||||
\begin{description}
|
||||
\item[git-flow] une démarche de développement tirant parti des capacités de git.
|
||||
\end{description}
|
||||
\begin{exampleblock}{}
|
||||
\small{\url{http://nvie.com/posts/a-successful-git-branching-model/}}
|
||||
\end{exampleblock}
|
||||
\end{frame}
|
|
@ -0,0 +1,15 @@
|
|||
\begin{frame}
|
||||
\frametitle{Processus de Vincent Driessen}
|
||||
\begin{columns}
|
||||
\begin{column}{0.5\textwidth}
|
||||
\begin{itemize}
|
||||
\item Des branches \emph{master} et \emph{develop} pour le code fonctionnel
|
||||
\item Des branches pour les développements en cours
|
||||
\item Un circuit entre les branches bien fléché
|
||||
\end{itemize}
|
||||
\end{column}
|
||||
\begin{column}{0.5\textwidth}
|
||||
\skbfigure[center, figure, caption=Vincent Driessen CC-by-sa, height=0.5\textheight]{scm/git-model@2x.png}
|
||||
\end{column}
|
||||
\end{columns}
|
||||
\end{frame}
|
|
@ -0,0 +1,12 @@
|
|||
\skbheading{Équipements personnels utilisés}
|
||||
|
||||
Utilisez-vous des équipements personnels (smartphone, ordinateur) ?
|
||||
|
||||
\ChoiceMenu[radio,radiosymbol=\ding{52},name=utilisation_equipement_personnel]{}{oui}
|
||||
\ChoiceMenu[radio,radiosymbol=\ding{52},name=utilisation_equipement_personnel]{}{non}
|
||||
|
||||
Si vous avez répondu oui à la question précédente, pourquoi utilisez-vous un équipement personnel ?
|
||||
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=pourquoi_equipement_personnel]{}{par commodité}
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=pourquoi_equipement_personnel]{}{par obligation}
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=pourquoi_equipement_personnel]{}{par nécessité}
|
|
@ -0,0 +1,2 @@
|
|||
\skbheading{equipement\_personnel\_utilises\_oui\_non.tex}
|
||||
fichier content/questions/equipement/equipement\_personnel\_utilises\_oui\_non.tex à éditer
|
|
@ -0,0 +1,12 @@
|
|||
\skbheading{Équipements utilisés}
|
||||
|
||||
Utilisez-vous plusieurs équipements (smartphone, ordinateur) ?
|
||||
|
||||
\ChoiceMenu[radio,radiosymbol=\ding{52},name=utilisation_equipement_personnel]{}{oui}
|
||||
\ChoiceMenu[radio,radiosymbol=\ding{52},name=utilisation_equipement_personnel]{}{non}
|
||||
|
||||
Si vous avez répondu oui à la question précédente, pourquoi utilisez-vous plusieurs équipements ?
|
||||
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=pourquoi_equipement_personnel]{}{par commodité}
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=pourquoi_equipement_personnel]{}{par obligation}
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=pourquoi_equipement_personnel]{}{par nécessité}
|
|
@ -0,0 +1,9 @@
|
|||
\skbheading{Type d’accès aux services numériques}
|
||||
|
||||
Depuis quel endroit avez-vous accès aux services numériques ?
|
||||
|
||||
\begin{center}
|
||||
\ChoiceMenu[radio,radiosymbol=\ding{52},name=ou_service]{}{depuis mon établissement}
|
||||
\ChoiceMenu[radio,radiosymbol=\ding{52},name=ou_service]{}{depuis mon domicile}
|
||||
\ChoiceMenu[radio,radiosymbol=\ding{52},name=ou_service]{}{depuis les deux}
|
||||
\end{center}
|
|
@ -0,0 +1,2 @@
|
|||
\skbheading{attentes\_ameliorations.tex}
|
||||
fichier content/questions/services/attentes\_ameliorations.tex à éditer
|
|
@ -0,0 +1,8 @@
|
|||
\skbheading{Méthodes d’authentification aux services numériques}
|
||||
|
||||
Disposez-vous d’un compte unique pour tous les services numériques ?
|
||||
|
||||
\begin{center}
|
||||
\ChoiceMenu[radio, radiosymbol=\ding{52}, name=auth_service]{}{oui}
|
||||
\ChoiceMenu[radio, radiosymbol=\ding{52}, name=auth_service]{}{non}
|
||||
\end{center}
|
|
@ -0,0 +1,12 @@
|
|||
\skbheading{Satisfaction donnée par les services numériques}
|
||||
|
||||
Quel est le degré de satisfaction que vous donne les services numériques proposés ?
|
||||
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=satisfaction_menu]{}{totalement satisfait}
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=satisfaction_menu]{}{partiellement satisfait}
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=satisfaction_menu]{}{peu satisfait}
|
||||
\ChoiceMenu[bordercolor=CadolesBlue,radio,radiosymbol=\ding{52},name=satisfaction_menu]{}{pas du tout satisfait}
|
||||
|
||||
Si vous avez répondu autre chose que totalement satisfait à la précedent question, en quoi les services numériques proposés ne répondent pas à vos attentes ?
|
||||
|
||||
\TextField[height=10em,width=\textwidth,multiline]{}
|
|
@ -0,0 +1,5 @@
|
|||
\skbheading{Liste des services numériques utilisés}
|
||||
|
||||
Lister les services numérique utilisés :
|
||||
|
||||
\TextField[height=10em,width=\textwidth,multiline]{}
|
|
@ -0,0 +1,6 @@
|
|||
\textbf{\cadoles} \\
|
||||
\adresse \\
|
||||
\codepostal \ville \\
|
||||
\telephone \\
|
||||
\fax \\
|
||||
\siteweb \\
|
|
@ -0,0 +1,11 @@
|
|||
\pagestyle{fancy}
|
||||
\fancyhf{}
|
||||
\renewcommand{\headrulewidth}{0pt}
|
||||
\renewcommand{\footrulewidth}{0pt}
|
||||
%\fancyhead[L]{ }
|
||||
%\fancyhead[R]{ }
|
||||
|
||||
\fancyfoot[L]{{\tiny \@title \\ \numeroversion}}
|
||||
\fancyfoot[C]{{\tiny {\scriptsize \textbf{\cadoles}} \\ {\adresse \codepostal \ville} }}
|
||||
\fancyfoot[R]{{\tiny \thepage / \pageref{LastPage} \\ \telephone }}
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
\skbheading{Licence}
|
||||
Cette œuvre est mise à disposition sous licence \href{http://creativecommons.org/licenses/by-nc-sa/2.0/fr/}{\textsc{cc-by-sa-2.0}}
|
||||
\begin{itemize}
|
||||
\item Attribution
|
||||
\item Partage dans les Mêmes Conditions 2.0
|
||||
\item France
|
||||
\end{itemize}
|
||||
Pour voir une copie de cette licence, visitez
|
||||
\href{http://creativecommons.org/licenses/by-sa/2.0/fr/}{http://creativecommons.org/licenses/by-sa/2.0/fr/}
|
||||
ou écrivez à Creative Commons, 444 Castro Street, Suite 900,
|
||||
Mountain View, California, 94041, USA.
|
|
@ -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}
|
||||
\usepackage{menukeys}
|
||||
\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]{cadoles/logo_01}
|
||||
\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\destinataire{
|
||||
\vspace{2cm}
|
||||
\begin{flushright}
|
||||
\begin{minipage}[r]{8cm}
|
||||
\skbinput[from=rep]{style/Destinataire}
|
||||
\end{minipage}
|
||||
\end{flushright}
|
||||
|
||||
}
|
||||
|
||||
\def\origine{
|
||||
\vspace{1.5cm}
|
||||
\begin{flushleft}
|
||||
\begin{minipage}[l]{8cm}
|
||||
\skbinput{style/00-Coordonnees}
|
||||
\end{minipage}
|
||||
\end{flushleft}
|
||||
}
|
||||
%
|
||||
% 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}{660pt} % Hauteur de la zone de texte (25cm)
|
||||
|
||||
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue