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}