From 31cfe27cd34dfb9fa24c8925ffb055d8424eb1b1 Mon Sep 17 00:00:00 2001
From: Mylloon <kennel.anri@tutanota.com>
Date: Sun, 5 May 2024 20:07:07 +0200
Subject: [PATCH] description, repartition

---
 report/document.tex | 76 ++++++++++++++++++++++++++++++---------------
 1 file changed, 51 insertions(+), 25 deletions(-)

diff --git a/report/document.tex b/report/document.tex
index 4e66446..b4d7807 100644
--- a/report/document.tex
+++ b/report/document.tex
@@ -26,6 +26,11 @@
 \def\matthieu{Matthieu Tonino}
 \def\anri{Anri Kennel}
 \def\lsys{L-système}
+\def\xml{\texttt{XML}}
+\def\xsl{\texttt{XSL}}
+\def\xsd{\texttt{XSD}}
+\def\csv{\texttt{CSV}}
+\def\svg{\texttt{SVG}}
 
 
 % Métadonnées
@@ -54,59 +59,80 @@
 \clearpage
 
 \section[Description]{Description du projet}
-Le projet a pour but de générer un fichier SVG en partant d'un \lsys~en
-utilisant des transformations de XML par XSL.
+Le projet a pour but de générer un fichier \svg~en partant d'un \lsys~en
+utilisant des transformations de \xml~par \xsl.
+
+\subsection{Gestion de projet}
+Nous avons écrit un \texttt{Makefile} pour nous faciliter le développement.
+
+\subsubsection*{Une commande qui fait tout}
+\begin{description}
+  \item[\texttt{make nom=snow n=3}] génère un fichier \texttt{image.svg}
+        correspondant \\ au \lsys~nommé "snow" avec trois itérations.
+\end{description}
+
+\subsubsection*{Possibilité de faire qu'une action à la fois}
+\begin{description}
+  \item[\texttt{make generation}] génère le fichier \xml~des \lsys{}s.
+  \item[\texttt{make tortue nom=koch5 n=4}] génère le fichier \xml~du
+        \lsys{}~"koch5" avec quatre itérations.
+  \item[\texttt{make traceur}] génère le fichier \xml~du traceur.
+  \item[\texttt{make svg}] génère le fichier \svg.
+\end{description}
+
+\subsubsection*{Des utilitaires}
+\begin{description}
+  \item[\texttt{make saxon}] télécharge Saxon pour la transformation
+        des fichiers \xml~via \xsl.
+  \item[\texttt{make clean}] supprime les fichiers générés.
+\end{description}
 
 \section{Explication des choix}
 Dans cette partie, nous justifions nos décisions.
 
 \subsection{Conception}
 Nous avons choisi le langage de programmation Python pour réaliser la
-première partie du projet parce que c'est un langage simple pour ce que l'on
-veut faire, qu'il est doté d'une librairie qui permet de générer des fichiers
-XML et que nous maitrisons tous les deux.
+première partie du projet parce que c'est un langage simple pour ce que nous
+voulons faire, qu'il est doté d'une librairie qui permet de générer des fichiers
+\xml~et que nous maitrisons tous les deux.
 
 \subsection{Implémentation}
 % TODO
 
 
 \section{Répartition des tâches}
-% TODO
+La conversion du fichier \csv~en fichier \xml, ainsi que la transformation
+du fichier XML ainsi générer en fichier \xml~de la tortue ont étés faits
+par \anri.
+La conversion du fichier \xml~de la tortue en fichier \xml~du traceur a été
+écrite par \matthieu.
+Chacun a écrit les fichiers \xsd~correspondant à ses fichiers \xml.
 
-% CSV -> XML : Python Anri
-
-% XML -> Tortue  : XSLT Anri
-% XML -> Traceur : XSLT Matthieu
-
-% XML -> SVG : XSLT (qui?)
+% TODO: XML -> SVG : XSLT (qui?)
 
 \subsection[Chronologie]{Chronologie des tâches}
 \def\sp{\hspace{8pt}} % petit espace pour l'alignement
 \begin{description}
-  \item[15 avril] Début de l'écriture du parseur CSV vers XML
-  \item[17 avril] Transformation du fichier CSV vers XML achevé
-  \item[26 avril] Écriture du schéma XML validant le format du fichier XML généré
-  \item[27 avril] Écriture des fichiers XSL et XSD pour la tortue
-  \item[2 mai\sp] Écriture des fichiers XSL et XSD pour le traceur
-  \item[4 mai\sp] Écriture des fichiers XSL pour la conversion en SVG
+  \item[15 avril] Début de l'écriture du parseur \csv~vers \xml
+  \item[17 avril] Transformation du fichier \csv~vers \xml~achevé
+  \item[26 avril] Écriture du schéma \xml~validant le format du fichier \xml~généré
+  \item[27 avril] Écriture des fichiers \xsl~et \xsd~pour la tortue
+  \item[2 mai\sp] Écriture des fichiers \xsl~et \xsd~pour le traceur
+  \item[4 mai\sp] Écriture des fichiers \xsl~pour la conversion en \svg
 \end{description}
 
 
 \section{Limitations}
 Dans cette partie nous abordons les limitations de notre projet.
 
-\subsection{Difficultés rencontrées}
-% TODO
+% \subsection{Difficultés rencontrées}
+% TODO - uniquement si on a galéré
 
 %\subsubsection*{Bugs}
 % TODO - uniquement s'il y a des bugs
+%  Problème: quand `n' est grand, on a un problème de mémoire
 
 %\subsection{Omissions} % Ce qu'il manque
 % TODO - uniquement s'il y a des omissions
 
-\section{Divers} % TODO:meilleur titre de section
-Nous avons écrit un Makefile pour nous faciliter le développement.
-
-% TODO: parler des target / paraphrase du README + saxon
-
 \end{document}