description, repartition

This commit is contained in:
Mylloon 2024-05-05 20:07:07 +02:00
parent 61e9636f83
commit 31cfe27cd3
Signed by: Anri
GPG key ID: A82D63DFF8D1317F

View file

@ -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}