Changes between Initial Version and Version 1 of document

Timestamp:

Apr 21, 2011, 10:15:47 PM (15 years ago)

Author:

g7moreau

Comment:

Création de la page

document

@@ +1 @@
+= Structuration d'un document =
+
+== Liminaire ==
+
+L'idée principale de la structuration d'un document complexe se résume en deux points :
+
+ - découpage du source en petits fichiers
+ - formatage du document final dans un dossier à part.
+
+Le premier point est important pour aider le travail collaboratif (risque de conflit moindre),
+simplifier le travail du gestionnaire de code source (subversion...).
+L'ensemble des fichiers peuvent être distribués dans des sous dossiers ou positionné en vrac.
+Tout dépend de leur nombre et de la manière de chacun.
+
+Cependant, le '''nom de chaque fichier''' doit être '''unique'''.
+En effet, lors du formatage dans un dossier temporaire,
+des fichiers temporaires mis en vrac soit créés,
+aucune arborescence correspondant à l'arborescence initiale est reconstruite.
+C'est à la fois plus simple à faire
+et avoir '''deux fichiers ayant le même nom''' est toujours une '''très mauvaise idée''' en programmation
+et finit toujours un jour ou l'autre par poser de gros soucis.
+
+Par ailleurs, il est fondamental lorsqu'on travaille sur un gros projet
+de séparer le code source, gérer par un gestionnaire de code source,
+des fichiers temporaires ainsi que des fichiers finaux.
+Ainsi, seul le fichier source est important à sauver,
+à archiver, à transmettre...
+
+Par défaut, les compilateurs travaillent dans le dossier courant.
+LaTeX ne fait pas exception.
+Ce comportement, réaliste pour des petits projets,
+présente trop de risque pour les gros projets.
+Ainsi, avec un paramétrage adéquate,
+le code source peut être mis en lecture seule lors du formatage.
+Il y a de nombreuse manière de faire cela
+et dans la solution proposée,
+un simple changement des droits sur les fichiers assure une protection efficace.
+Cependant, celle-ci est facultative...
+
+== Arborescence ==
+
+Il est hors de question que l'utilisateur se souvienne de commande
+complexe et effectue des manipulations fastidieuses, répétitives
+donc avec des risques d'erreurs importants.
+
+Un très bon outil fait cela depusi des années : '''{{{make}}}'''.