Autonomie, la liberté de pensée Copyright 2003 Jean-Michel Smith, Thomas Tempé et al. Redistribution et modification permises sous certaines conditions --voire licence.tex AVERTISSEMENT ============= Cette archive contient la version LaTeX d'une partie du roman Autonomie, la liberté de pensée, ainsi que des scripts qui permettent d'interagir directement avec le wiki. Elle est destinée aux personnes qui souhaitent modifier ou relire la version LaTeX. À moins que vous n'ayez une bonne raison de vouloir modifier la version LaTeX du roman, il est recommandé de vous référer au wiki : http://gpl.insa-lyon.fr/OrgaWiki/AutonomyProject Le wiki contient les versions PDF et HTML officielles du projet. C'est aussi la manière la plus sûre et la plus simple pour corriger, relire ou modifier le manuscrit. COMPILATION =========== Pour simplement compiler le LaTeX, taper : % make Cette commande génère les versions PDF et HTML du roman, ainsi que des archives dans différents formats de la version HTML et du source LaTeX. INTERACTION AVEC LE WIKI ======================== Afin d'obtenir la dernière version du roman à partir du wiki, précédez cette commande de : % python scripts/download.py chap*.tex Cette commande identifiera les chapitres présents dans le répertoire courant, et les remplacera par la version du wiki. Les nouveaux chapitres présents sur le wiki ne sont pas traités. Pour ajouter un chapitre nouveau, tapez : % python scripts/download.py chap33.tex Attention, si vous ajoutez un chapitre qui n'a jamais été relu pour le LaTeX, il y a de bonnes chances pour qu'il ne compile pas, ou pour que le résultat ne soit pas satisfaisant. Si vous comptez modifier la version LaTeX, pensez à en récupérer la dernière version *juste avant*, afin de ne pas travailler sur une version ancienne. Juste après votre travail, il est recommandé de publier votre version sur le wiki avec : % ./scripts/upload.py chap12.tex Attention, cette commande est dangeureuse : elle écrase la version du wiki sans prévenir s'il y a eu des changements depuis. LATEX ET WIKI ============= La conversion entre les formats wiki et LaTeX se fait grâce aux scripts Python contenus dans le répertoire ./scripts. Le LaTeX n'est qu'un format intermédiaire pour Autonomie. Il sert à générer la version PDF. Cependant, comme le LaTeX a une expressivité plus grande que le format wiki, certains marquages non-standards sont utilisés dans la version wiki. Ils sont documentés sur le wiki. Malheureusement, rien n'oblige les utilisateurs du wiki à les respecter. Comme le wiki change tout le temps, il est probable que la version latex que vous obtiendrez ne compilera pas du premier coup. Si vous corrigez des erreurs, pensez à les renvoyer sur le wiki. Les conversions wiki->latex->wiki et latex->wiki->latex produisent de légères modifications dans la mise en page du source, mais sont sensées se faire sans perte d'informations. Cependant, les scripts de conversion ne sont pas parfaits. Si vous rencontrez des difficultés, réferrez-vous à la liste de diffusion du projet. FONCTIONNEMENT DU MAKEFILE ========================== Le Makefile ignore complètement l'existance du wiki. Il génère des versions PDF, HTML, et des archives .zip et .tar.gz. Tapez : % make info Pour faire des archives contenant le roman, faire : % make autonomy_html.zip ou % make autonomy_latex.zip ou encore % make archives Pour nettoyer le répertoire, tapez : % make clean DÉPENDANCES =========== Ce système de compilation utilise soit pdflatex soit rubber pour générer la version PDF. La version HTML est produite avec html2latex. Rubber est un wrapper qui permet d'encapsuler la compilation LaTeX de manière plus propre et plus sûre que pdflatex. Le choix de la commande se fait en modifiant la variable LATEX du Makefile. Les scripts de téléchargement et de conversion dépendent de Python, et nécessitent une connexion directe à Internet.