semaine 4 git
This commit is contained in:
parent
06a0b2134f
commit
a772da306d
339
4CMDivers.md
Normal file
339
4CMDivers.md
Normal file
@ -0,0 +1,339 @@
|
|||||||
|
# Divers outils
|
||||||
|
|
||||||
|
Nous allons maintenant (re)voir divers outils utiles pour faire du développement.
|
||||||
|
|
||||||
|
## Contrôle de version
|
||||||
|
|
||||||
|
Il existe de nombreux outils permettant de
|
||||||
|
* mémoriser une version antérieure d'un fichier
|
||||||
|
* partager ce fichier
|
||||||
|
* revenir à une version antérieure
|
||||||
|
|
||||||
|
Pour certains fichiers, il existe un système de suivi de version intégré à l'outil permettant de l'éditer. Par exemple, le suivi de version de word.
|
||||||
|
|
||||||
|
Il existe maintenant des clients avec un serveur centralisé de sauveguarde utilisés par le grand public (NextCloud, Dropbox, etc) et des outils plutôt pour les développeurs (subversion, git, etc).
|
||||||
|
|
||||||
|
Nous allons nous pencher sur git que vous utilisez depuis quelques mois [diaporama Denis](git_tutorial.pdf).
|
||||||
|
|
||||||
|
En TP, nous allons voir git plus en détails, en particulier comment travailler à plusieurs (merge, rebase).
|
||||||
|
|
||||||
|
## Mark down
|
||||||
|
|
||||||
|
Pour faire des readme, des rapports simples, le mark down fonctionne très bien.
|
||||||
|
C'est un fichier texte qui est interprété entre autre par le client web des serveurs git pour un rendu assez raisonnable.
|
||||||
|
|
||||||
|
Le format n'est pas complètement standardisé toutefois, donc veillez à rester sur des choses universelles pour faciliter le rendu.
|
||||||
|
|
||||||
|
## LaTeX
|
||||||
|
|
||||||
|
Pour des rapports plus conséquents (à partir de 4 ou 5 pages qu'on voudra imprimer), il vaut mieux utiliser un outil permettant de garantir un résultat typographiquement supérieur ce qui offira une lecture plus confortable.
|
||||||
|
|
||||||
|
Par exemple voici mon fichier pour une feuille de TD.
|
||||||
|
On peut aussi faire des lettres, des posters, des présentations.
|
||||||
|
|
||||||
|
```latex
|
||||||
|
\documentclass[a4paper,12pt]{article}
|
||||||
|
|
||||||
|
\usepackage[francais]{babel} %%% ponctuation etc en français
|
||||||
|
\usepackage[utf8]{inputenc} %%% saisir de l'utf8 dans le texte
|
||||||
|
\usepackage[T1]{fontenc} %%% chargement d'une police décorée avec les accents
|
||||||
|
\usepackage{lmodern} %%% je souhaite la police lmodern
|
||||||
|
\usepackage{graphics,graphicx}%%% pour importer des images
|
||||||
|
\usepackage{url} %%% pour citer des urls, des adresses mails
|
||||||
|
\usepackage{hyperref} %%% hyperliens dans le pdf
|
||||||
|
\usepackage[pdftex,usenames,dvipsnames]{xcolor} %%% gestion des couleurs
|
||||||
|
%%% decommenter si tikz necessaire
|
||||||
|
%\usepackage{tikz} %%% dessiner programmatiquement.
|
||||||
|
%\usetikzlibrary[decorations.pathmorphing]
|
||||||
|
%\usetikzlibrary[decorations.pathreplacing]
|
||||||
|
%\usetikzlibrary{backgrounds}
|
||||||
|
%\usetikzlibrary{positioning}
|
||||||
|
%\usetikzlibrary{arrows}
|
||||||
|
%\usetikzlibrary{backgrounds}
|
||||||
|
|
||||||
|
|
||||||
|
\usepackage{tcolorbox} %%% boîtes de couleurs
|
||||||
|
\tcbset{textmarker/.style={%
|
||||||
|
% skin=enhancedmiddlejigsaw,breakable,
|
||||||
|
parbox=false,
|
||||||
|
boxrule=0mm,leftrule=5mm,rightrule=5mm,boxsep=0mm,arc=0mm,outer arc=0mm,
|
||||||
|
left=3mm,right=3mm,top=1mm,bottom=1mm,toptitle=1mm,bottomtitle=1mm,oversize}}
|
||||||
|
\newtcolorbox{yellow}{textmarker,colback=yellow!5!white,colframe=yellow}
|
||||||
|
\newtcolorbox{orange}{textmarker,colback=DarkOrange!5!white,
|
||||||
|
colframe=DarkOrange!75!yellow}
|
||||||
|
\newtcolorbox{red}{textmarker,colback=red!5!white,colframe=red}
|
||||||
|
\newtcolorbox{blue}{textmarker,colback=DeepSkyBlue!5!white,colframe=DeepSkyBlue}
|
||||||
|
\newtcolorbox{green}{textmarker,colback=Chartreuse!5!white,colframe=Chartreuse}
|
||||||
|
\newtcolorbox{rainbow}{textmarker,interior hidden,
|
||||||
|
frame style={top color=blue,bottom color=red,middle color=green}}
|
||||||
|
%%%
|
||||||
|
|
||||||
|
\usepackage{framed} %%% boîtes permettant de gérer correctement le saut de page.
|
||||||
|
\usepackage{multicol} %%% plusieurs colonnes
|
||||||
|
\usepackage[subtle]{savetrees} %%% économiser du papier tout en restant lisible.
|
||||||
|
%\usepackage[a4paper,width=17cm,height=23cm]{geometry} %%% changer les marges
|
||||||
|
\usepackage{a4wide} %%% version simple du précédent
|
||||||
|
\usepackage{paralist} %%%
|
||||||
|
\usepackage{fancyhdr} %%% haut de page
|
||||||
|
\usepackage{colortbl} %%% tables de couleur
|
||||||
|
\usepackage{cancel} %%%
|
||||||
|
\usepackage{amssymb,amsmath,amsthm} %%% Maths symboles, théorèmes etc
|
||||||
|
|
||||||
|
%%% On charge le paquet ifthen pout faire des tests
|
||||||
|
\usepackage{ifthen}
|
||||||
|
%%% On définit un compteur numérique pour l'année
|
||||||
|
\newcounter{theyear}
|
||||||
|
\setcounter{theyear}{\number\year}
|
||||||
|
%%% Une macro pour écrire l'année académique automatiquement en
|
||||||
|
%%% fonction du mois en cours
|
||||||
|
\newcommand{\academicyear}[0]{
|
||||||
|
\ifthenelse{\number\month<8}
|
||||||
|
{\addtocounter{theyear}{-1}\arabic{theyear}\addtocounter{theyear}{-1999}\,-\arabic{theyear}}%
|
||||||
|
{\arabic{theyear}\addtocounter{theyear}{-1999}\,-\arabic{theyear}}%
|
||||||
|
}%
|
||||||
|
|
||||||
|
%%% mettre les macros à la racine du cours et ajuster en conséquence
|
||||||
|
%%% pour éviter d'avoir plus d'une copie des macros par cours.
|
||||||
|
%\input{MyMacros.tex}
|
||||||
|
|
||||||
|
%\input{SetColors.tex}
|
||||||
|
|
||||||
|
%%%%%%%%%%%%%%%%%%%%%%%%
|
||||||
|
%%% Def d'environement de Math (Malika)
|
||||||
|
%%%%%%%%%%%%%%%%%%%%%%%%
|
||||||
|
\theoremstyle{plain}
|
||||||
|
\newtheorem*{theo}{Théorème}
|
||||||
|
\newtheorem*{cons}{Conséquence}
|
||||||
|
\newtheorem*{conss}{Conséquences}
|
||||||
|
|
||||||
|
|
||||||
|
\theoremstyle{definition}
|
||||||
|
\newtheorem{exo}{Exercice}
|
||||||
|
\newtheorem*{defi}{Définition}
|
||||||
|
\newtheorem*{probleme}{Problème}
|
||||||
|
\newtheorem*{reponse}{Réponse}
|
||||||
|
|
||||||
|
|
||||||
|
\theoremstyle{remark}
|
||||||
|
\newtheorem*{exemple}{Exemple}
|
||||||
|
\newtheorem*{remarque}{Remarque}
|
||||||
|
\newtheorem*{remarques}{Remarques}
|
||||||
|
\newtheorem*{prop}{Propriété}
|
||||||
|
\newtheorem*{props}{Propriétés}
|
||||||
|
|
||||||
|
%\pagestyle{fancy}
|
||||||
|
\fancyhf{}
|
||||||
|
\fancyhead{
|
||||||
|
\begin{minipage}{16cm}
|
||||||
|
\hspace{-2cm}
|
||||||
|
Nom : \fbox{\begin{minipage}{6cm}\hfill\vspace{.7cm}\end{minipage}}
|
||||||
|
\hfill
|
||||||
|
Pr\'enom : \fbox{\begin{minipage}{4cm}\hfill\vspace{.7cm}\end{minipage}}
|
||||||
|
\hfill
|
||||||
|
Groupe : \fbox{\begin{minipage}{.7cm}\hfill\vspace{.7cm}\end{minipage}}
|
||||||
|
\end{minipage}
|
||||||
|
}
|
||||||
|
\fancyfoot[C]{Page {\large\thepage}}
|
||||||
|
|
||||||
|
|
||||||
|
%%%%%%%%%%%%%%%%%%%%%%%%
|
||||||
|
%%% Quelques paquets gérant la correction / espace pour la reponse
|
||||||
|
%%%%%%%%%%%%%%%%%%%%%%%%
|
||||||
|
\usepackage{comment}
|
||||||
|
%%% Pour afficher la correction et exclure les boites pour la reponse
|
||||||
|
% \includecomment{correction}
|
||||||
|
% \excludecomment{EspaceReponse}
|
||||||
|
%%% Pour version cachant la correction et incluant l'espace pour la reponse
|
||||||
|
\excludecomment{correction}
|
||||||
|
\includecomment{EspaceReponse}
|
||||||
|
|
||||||
|
|
||||||
|
%%%
|
||||||
|
\begin{document}
|
||||||
|
|
||||||
|
\
|
||||||
|
\vspace{.2cm}
|
||||||
|
|
||||||
|
{\small
|
||||||
|
\noindent IUT Sénart-Fontainebleau, UPEC
|
||||||
|
\hfill
|
||||||
|
Florent Madelaine
|
||||||
|
|
||||||
|
\noindent DEV 2.3
|
||||||
|
\hfill
|
||||||
|
Luc Dartois
|
||||||
|
|
||||||
|
\noindent IUT Info 2A \hfill Luc Hernandez
|
||||||
|
|
||||||
|
\hfill\noindent\academicyear{}
|
||||||
|
|
||||||
|
}
|
||||||
|
\vspace{.7cm}
|
||||||
|
|
||||||
|
\hrule
|
||||||
|
\vspace{.3cm}
|
||||||
|
|
||||||
|
\begin{center}
|
||||||
|
|
||||||
|
{\textbf{\Large
|
||||||
|
Quelques outils
|
||||||
|
}}
|
||||||
|
\vspace{.1cm}
|
||||||
|
|
||||||
|
\end{center}
|
||||||
|
\vspace{.3cm}
|
||||||
|
|
||||||
|
\hrule
|
||||||
|
\vspace{.3cm}
|
||||||
|
|
||||||
|
\section*{Préambule}
|
||||||
|
Nous allons survoler certains outils qui sont particulièrement utiles
|
||||||
|
pour travailler sur un projet.
|
||||||
|
|
||||||
|
Je ne vais pas revenir sur les outils de \textbf{gestion de version}. Je
|
||||||
|
recommande très fortement l'utilisation de git (il y a le serveur
|
||||||
|
gitea à l'IUT \url{https://dwarves.iut-fbleau.fr/gitiut}).
|
||||||
|
|
||||||
|
Il y a des alternatives comme svn, voir pour des choses
|
||||||
|
simples lorsqu'on ne travaille pas avec des informaticiens, dropbox ou
|
||||||
|
autre service similaire de cloud.
|
||||||
|
De manière générale, l'excuse \og mon chat a mangé mon projet ce w.e.,
|
||||||
|
je ne peux donc pas vous le rendre\fg{} n'est pas acceptable.
|
||||||
|
|
||||||
|
Il y a de nombreux outils libres assez pratiques, par exemple framapad
|
||||||
|
\url{https://framapad.org/fr/} si vous souhaitez partager des idées à
|
||||||
|
distance sous forme d'un petit texte.
|
||||||
|
|
||||||
|
Vous le savez peut-être mais il y a de nombreuses alternatives libres
|
||||||
|
à des outils bien connus (et propriétaires) qui marchent aussi bien
|
||||||
|
voir mieux. Voir par exemple ce site:
|
||||||
|
\url{https://degooglisons-internet.org/fr/} et cette page pour une
|
||||||
|
liste de service en ligne
|
||||||
|
\url{https://degooglisons-internet.org/fr/list}.
|
||||||
|
|
||||||
|
Aujourd'hui nous allons entrevoir deux outils :
|
||||||
|
\begin{enumerate}
|
||||||
|
\item le premier est un outil pour faire du suivi de projet (remplace
|
||||||
|
le tableau physique du projet agile).
|
||||||
|
\item le second est un logiciel permettant de rédiger de jolis
|
||||||
|
rapports, voir de faire des présentations.
|
||||||
|
\end{enumerate}
|
||||||
|
|
||||||
|
|
||||||
|
\section*{Outil de suivi de projet}
|
||||||
|
Quand on travaille sur un projet à plusieurs (et même parfois seul),
|
||||||
|
il est important de pouvoir faire le point sur ce qu'on doit faire.
|
||||||
|
Il y a un outil non libre qui s'appelle trello que je vous recommande
|
||||||
|
dans l'immédiat.
|
||||||
|
|
||||||
|
Une bonne alternative libre est \url{https://kanboard.org/} mais je ne
|
||||||
|
trouve plus de serveur accessible gratuitement. En attendant que nous
|
||||||
|
l'offrons au département, je vous invite à utiliser trello.
|
||||||
|
|
||||||
|
L'avantage de kanvoard est qu'il permet de faire des diagrammes de
|
||||||
|
Gantt, fonctionalité a priori non disponible sur trello.
|
||||||
|
|
||||||
|
\section*{\LaTeX}
|
||||||
|
|
||||||
|
Il s'agit d'une alternative populaire chez les scientifiques pour
|
||||||
|
rédiger des documents (lettre, notes de cours, articles de recherche,
|
||||||
|
rapports, livres) voir même faire des présentations ou des posters.
|
||||||
|
|
||||||
|
Le projet initial, \TeX, est initié par Donald Knuth\footnotemark{}
|
||||||
|
\footnotetext{voir \url{https://en.wikipedia.org/wiki/Donald_Knuth}.}
|
||||||
|
un pionnier de l'informatique.
|
||||||
|
|
||||||
|
Pour l'instant le logiciel n'est pas installé à l'IUT mais vous pouvez
|
||||||
|
en attendant l'installez chez vous (voir
|
||||||
|
\url{https://www.tug.org/texlive/acquire-netinstall.html}) ou dans
|
||||||
|
l'immédiat pour aujourd'hui utiliser un serveur avec une interface web
|
||||||
|
qui permet même de collaborer sur un même document.
|
||||||
|
|
||||||
|
\begin{yellow}
|
||||||
|
\begin{exo}
|
||||||
|
\begin{enumerate}
|
||||||
|
\item
|
||||||
|
Créez un compte sur \url{https://www.overleaf.com/about}.
|
||||||
|
\item Créez un nouveau projet (en partant d'un exemple).
|
||||||
|
\item Générez le pdf.
|
||||||
|
\end{enumerate}
|
||||||
|
\end{exo}
|
||||||
|
\end{yellow}
|
||||||
|
|
||||||
|
Dans l'esprit, le \LaTeX ressemble au html.
|
||||||
|
Le code est compilé pour produire un document (à l'origine du
|
||||||
|
postcript, maintenant avec pdfLatex, du pdf).
|
||||||
|
|
||||||
|
Si vous souhaitez vous former, vous pouvez par exemple regarder ce
|
||||||
|
wikibook : \url{https://en.wikibooks.org/wiki/LaTeX}.
|
||||||
|
|
||||||
|
Avec assez peu d'efforts, il est facile de faire un rapport avec des
|
||||||
|
sections, un index, quelques images et une bibliographie.
|
||||||
|
|
||||||
|
Vous pouvez même faire des présentations de très belle qualité avec
|
||||||
|
beamer. Le serveur overleaf contient de nombreux template.
|
||||||
|
Dans l'immédiat je vous invite quand même à utiliser des choses très
|
||||||
|
simples.
|
||||||
|
|
||||||
|
\begin{yellow}
|
||||||
|
\begin{exo}
|
||||||
|
Créez un squelette de rapport avec \LaTeX{} comportant un titre,
|
||||||
|
un résumé, une table des matières, une figure.
|
||||||
|
|
||||||
|
Dans un second temps, si ce n'est pas déjà fait, chargez les
|
||||||
|
paquets avec les bonnes options permettant de rédiger un tete en
|
||||||
|
Français avec une gestion des accents, de la ponctuation etc.
|
||||||
|
|
||||||
|
Ensuite, ajoutez une table des figures et un index (glossaire)
|
||||||
|
de termes techniques.
|
||||||
|
|
||||||
|
Ensuite ajoutez une jolie formule de math (avec des fractions et
|
||||||
|
des sommes ou des intégrales).
|
||||||
|
|
||||||
|
Finalement, changez les fontes par défaut en allant voir le
|
||||||
|
catalogue ici \url{https://tug.org/FontCatalogue/allfonts.html}.
|
||||||
|
\end{exo}
|
||||||
|
\end{yellow}
|
||||||
|
|
||||||
|
De manière générale, il ne faut pas chercher à détourner \LaTeX{} de
|
||||||
|
ce qu'il souhaite faire. Le but de ce logiciel est de faire de la mise
|
||||||
|
en page automatiquement. Si vous souhaitez faire de la mise en page
|
||||||
|
très précise (comme dans un journal par exemple) alors \LaTeX{} n'est
|
||||||
|
pas adapté.
|
||||||
|
\end{document}
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
## Documenter votre code
|
||||||
|
|
||||||
|
Il existe des outils qui fonctionnent pour n'importe quel langage comme [doxygen](https://doxygen.nl/).
|
||||||
|
|
||||||
|
Pour java, en général on utilise [javadoc](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
|
||||||
|
|
||||||
|
NB : certains éditeurs (par exemple sublimetext) génèrent à la volée une ébauche de documentation pour chaque méthode, chaque classe.
|
||||||
|
|
||||||
|
La commande `javadoc -d doc` permet de générer la documentation au format html dans le style de la documentation java que vous utilisez. En paramètre, vous pouvez donner des fichiers java.
|
||||||
|
|
||||||
|
## Organisation d'un projet
|
||||||
|
|
||||||
|
On va normalement avoir plusieur répertoires.
|
||||||
|
* `src` pour les sources (les `.java`)
|
||||||
|
* `doc` pour la documentation
|
||||||
|
* `test` pour les tests
|
||||||
|
* `build` pour les exécutables (les `.class`)
|
||||||
|
|
||||||
|
À la racine un `README` expliquant brièvement l'architecture du projet et comment déployer / utiliser le travail du projet.
|
||||||
|
On ajoute aussi normalement une licence, par exemple [creative commons](https://creativecommons.org/about/cclicenses/).
|
||||||
|
|
||||||
|
Quand on a beaucoup de fichiers java on va avoir plusieurs paquets.
|
||||||
|
On verra ça en détail en seconde année.
|
||||||
|
|
||||||
|
On propose normalement une méthode pour compiler les sources efficacement et générer un exécutable.
|
||||||
|
En java souvent on va générer un `jar` (c'est juste une archive zip spéciale contenant les exécutable)
|
||||||
|
|
||||||
|
On peut par exemple utiliser `make` ou encore un script en shell.
|
||||||
|
|
||||||
|
On verra ceci plus tard, mais il existe aussi des outils plus récents, souvent bien intégrés aux IDE permettant de faire du déploiement continu (maven, gradle).
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
BIN
git_tutorial.pdf
Normal file
BIN
git_tutorial.pdf
Normal file
Binary file not shown.
Loading…
Reference in New Issue
Block a user