Comme vous le savez, le site des tuteurs doit subir un lifting.
+Marie-Lan et Nicolas ont notamment choisi les couleurs et la présentation
+du nouveau site, et Nicolas a implémenté un
+certain nombre de scripts (ceux-ci se trouvent dans la branche
+utilitaires/tml du cvstuteurs).
+Ne pas modifier la branche utilitaires/tml du
+cvstuteurs à moins de savoir vraiment ce que vous faites,
+puisque tout le site Web en dépend.
+Cette page a pour but :
++Un bref résumé des choses à ne pas faire se trouve dans les dix +commandements. +
+ + Tout est géré depuis l'arborescence web du
+cvstuteurs. (NDjriou: l'ancien site est toujours dans
+l'arborescence www dudit cvs)
+Dans ce cvs figurent uniquement des fichiers
+.tml et des fichiers téléchargeables (icones, screenshots,
+illustrations du hublot, PostScripts gzippés d'icelui)
+
+Le site Web en lui-même se trouve à l'adresse http://www.eleves.ens.fr/tuteurs/web/
+temporairement. Quand il sera terminé, il reviendra à sa place, à savoir
+http://www.eleves.ens.fr/tuteurs/.
+
tmlPour faire une nouvelle page Web, il faut écrire un fichier
+foobar.tml. C'est presque du HTML, mais il y a quelques
+nuances. En effet, ces fichiers sont passés dans une moulinette qui
+s'appelle xsltproc quand vous éxécutez la commande :
+bireme ~/tuteurs/cvs/web/docs/hublot $ ~tuteurs/bin/build hublot12.tml
+
+
+Il en ressort normalement (s'il n'y a pas trop d'erreurs de syntaxe) un
+fichier html très joli. Ce dernier utilise une feuille de
+style tuteurs.css, contient une bande de navigation à gauche
+présentant notamment un arbre du site et un sommaire de la page en cours
+de lecture, le tout généré automatiquement grâce à la patience du
+concepteur de la nouvelle charte graphique.
Les scripts prennent en compte le titre des pages pour générer +l'arborescence. Il convient donc de les faire courts.
+La moulinette et la feuille de style permettent de faire très simplement +beaucoup choses : faire des encadrés, des jolis prompts, des +tableaux...
+
+Par ailleurs, dans les fichiers .tml, tous les liens
+internes à la page des tuteurs doivent être relatifs, mais il y a une
+astuce : la racine de l'arborescence du site a pour synonyme
+&url.tuteurs;. Ainsi, dans
+logiciels/latex/astuces.tml, on trouve le lien
+suivant :
+<p> Mais cela ne doit pas vous empêcher de prendre de <a +href="&url.tuteurs;docs/hublot/typo.html">bonnes habitudes</a> quand vous tapez avec d'autres logiciels ou que vous rédigez un courrier toutes les ponctuations sont suivies d'un espace, seules les ponctuations doubles sont précédées d'un espace.</p> ++ + +
htmlLes scripts transforment les .tml en .html. Ces
+derniers doivent être du XHTML 1.0 Strict. Pour le
+vérifier, passez les pages que vous modifiez au validateur.
Quelles sont les différences entre le HTML usuel et le XHTML 1.0 +Strict ?
++<p> +En utilisant la suite spectrale de coniveau, on peut démontrer le +théorème [...]. +</p> ++
<br>. D'ailleurs, ce genre de balises sont écrire
+sous la forme <br /> pour se conformer à la première
+exigence ;
++<img src="hublot01/logoAI.png" alt="[Logo de l'Atelier Internet]"> ++
Quand le repository du cvstuteurs est modifié (ou plutôt
+quand on fait make install dans
+la racine de son répertoire de travail), les fichiers .tml
+figurant dans ~tuteurs/www/web sont mis-à-jour, et le script
+rebuild est lancé dedans, ce script éxécute
+build sur tous les fichiers .tml qui en ont
+besoin.
+
Comme le site est géré via cvs, il convient de connaître
+le minimum nécessaire pour utiliser ce logiciel, nous allons le voir
+ci-dessous.
+
Pour utiliser cvs, il faut se créer un répertoire de
+travail chez soi, c'est-à-dire récupérer les fichiers se
+trouvant dans le repository, à savoir
+~tuteurs/cvs/web. Pour cela, il suffit de taper la commande
+suivante dans votre répertoire ~/tuteurs/cvs par
+exemple :
+bireme ~/tuteurs/cvs $ cvstuteurs checkout web
+
+
+Il est impératif d'utiliser cvstuteurs à la place de
+cvs : ce permet de faire travailler cvs
+directement dans le repository des tuteurs et de le faire travailler en
+tant que membre du groupe tuteurs, ce qui est très important pour éviter
+de tout casser (comme c'est arrivé le premier jour). Par conséquent, je
+vous recommande vivement d'insérer la ligne suivante dans votre
+.zshrc
+alias cvs='echo "Attention, tu utilises cvstuteurs";sleep 2;cvstuteurs' ++ +
+Vous voyez apparaître quelques fichiers .tml dans votre
+répertoire de travail. Pour les transformer en .html,
+faites :
+
+bireme ~/tuteurs/cvs/web $ ~tuteurs/bin/rebuild .
+
+
+Prenons un exemple. Supposons que vous souhaitiez écrire la page
+unix/accents.html.
+bireme ~/tuteurs/cvs/web $ cvstuteurs update
+
+Il arrive souvent que cvs vous demande de faire cette
+manœuvre avant de faire un commit (i.e. de prendre un compte vos
+modifications).
++bireme ~/tuteurs/cvs/web $ cd unix +bireme ~/tuteurs/cvs/web $ cvstuteurs add accents.tml +bireme ~/tuteurs/cvs/web/unix $ vim accents.tml ++La deuxième commande permet de dire à
cvs que vous préparez
+un fichier unix/accents.tml.accents.tml (à savoir l'entête) en faisant
+:r ../index.tml par exemple. Activez le syntax-highlight
+HTML, par exemple en relançant vim.
+.html en faisant
+:! build accents.tml.
+Notez que si d'autres fichiers tml se trouvent dans le
+répertoire courant, leur syntaxe sera aussi vérifiée (pour créer
+l'arborescence dans accents.tml).
+
+bireme ~/tuteurs/cvs/web $ rebuild .
+
+
+bireme ~/www ln -s ../tuteurs/cvs/web tuteurs
+
+
+bireme ~/tuteurs/cvs/web $ make install
+
+
+Pour information, voici le contenu du Makefile
++install: + cvstuteurs commit + su-tuteurs cvstuteurs update -d /users/staffs/tuteurs/www/web + su-tuteurs /users/staffs/tuteurs/share/tml/bin/rebuild /users/staffs/tuteurs/www/web ++La première ligne intéressante met à jour le repository compte tenu de +vos modifications et créations. La deuxième met à jour met à jour entre +autres les fichiers
tml de la page Web en fonction du
+repository nouveau et la troisième ligne met à jour les fichiers
+html et en crée éventuellement de nouveaux.
+cvs mais cvstuteurs.
+~tuteurs/cvs/ et en particulier ~tuteurs/cvs/web/.
+~tuteurs/www/web/.
+cvstuteurs commit,
+ mais make install dans la racine de ton répertoire de travail.
+cvstuteurs add -kb
+foobar.png
+.gif tu ne créeras point, parce que c'est mal.
+00TODO et 00INDEX.
+Je vous prie de bien vouloir excuser les anglicismes +scandaleusement présents dans cette page.
+ + + + +