From d9a7cc7b0a318172444638f82d57c7fdecad1609 Mon Sep 17 00:00:00 2001 From: meles Date: Thu, 5 Jul 2007 13:32:07 +0000 Subject: [PATCH] =?UTF-8?q?Bap:=20-=20liens=20r=C3=A9ciproques=20entre=20l?= =?UTF-8?q?es=20deux=20pages=20de=20documentation=20=20=20=20=20=20-=20ajo?= =?UTF-8?q?ut=20de=20la=20page=20de=20doc=20avanc=C3=A9e=20dans=20le=20nol?= =?UTF-8?q?inks=20=20=20=20=20=20-=20d=C3=A9tails=20typographiques?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc-interne-avancee.tml | 8 +++++- doc-interne.tml | 55 +++++++++++++++++++++++++---------------- nolinks | 1 + 3 files changed, 42 insertions(+), 22 deletions(-) diff --git a/doc-interne-avancee.tml b/doc-interne-avancee.tml index 34f290e..a1d2ae5 100644 --- a/doc-interne-avancee.tml +++ b/doc-interne-avancee.tml @@ -10,6 +10,12 @@

Documentation interne avancée

+
+Pour une première approche, consultez d'abord la page +de documentation interne sur la contribution +au site des tuteurs. +
+

Comme vous le savez, le site des tuteurs subit un lifting. Marie-Lan et Nicolas ont notamment choisi les couleurs et la présentation du nouveau site, et Nicolas a implémenté un @@ -531,7 +537,7 @@ scandaleusement pr

Auteur : Joël Riou et Nicolas George. -Dernière modification le . +Dernière modification le .
diff --git a/doc-interne.tml b/doc-interne.tml index 9b43aa9..16a46c5 100644 --- a/doc-interne.tml +++ b/doc-interne.tml @@ -14,11 +14,11 @@

La plupart des programmes utilisés dans la suite sont dans -~tuteurs/bin. -Éditez le fichier .profile à la racine de votre compte, -trouvez le passage qui parle du PATH et modifiez la fin. -Attention, ne pas oublier de mettre :\ à la fin de l'avant-dernière ligne, -et de tester (en vous logguant une deuxième fois) avant de se délogguer. +~tuteurs/bin. Éditez le fichier .profile à +la racine de votre compte, trouvez le passage qui parle du PATH et +modifiez la fin. Attention, ne pas oublier de mettre :\ (non suivi +d'espace !) à la fin de l'avant-dernière ligne, et de tester (en +vous logguant une deuxième fois) avant de se délogguer. 

@@ -37,8 +37,8 @@ $MISCPATH:\
 
 

 Tout d'abord, créez-vous un répertoire de travail sur votre compte avec
- mkdir . Par la suite, nous supposerons que ce répertoire
-s'appelle  tuteurs/cvs .
+mkdir. Par la suite, nous supposerons que ce répertoire
+s'appelle  tuteurs/cvs.
 

 
 
Tapez les commandes suivantes: 
@@ -77,8 +77,12 @@ site 
 est étroit), le titre long sera écrit en gros en 
 haut de la page.
 
-
Pour ajouter des fichiers binaires, il faut taper cvstuteurs add -kb
-foobar.png .

+
Pour ajouter des fichiers binaires (par exemple des images), il faut
+taper :

+
+ teck ~/tuteurs/cvs/web/unix
+$ cvstuteurs add -kb foobar.png .
+

 
 
 
  • Écrivez le contenu du fichier.  Ce dernier sera passé dans une moulinette
@@ -86,39 +90,45 @@ qui s'appelle xsltproc qui rajoute automatiquement
 un plan du site à gauche et un sommaire de la page en cours de lecture.
 
 Les liens internes à la page des tuteurs doivent être sous la forme:
-      
    
-       < a href="&url.tuteurs;docs/hublot/typo.html">
-      
    
+     
+
    +< a href="&url.tuteurs;docs/hublot/typo.html">
+
    
+      
 
 Il faut mettre à la fin du fichier des lignes du type:
       
     <div class="metainformation">
 Auteur : Comptes tuteurs.
-Dernière modification le <date value="$Date: 2007-07-05 12:51:51 $" />.
+Dernière modification le <date value="$Date: 2007-07-05 13:32:08 $" />.
 </div>
 
    
   
-Pour le reste, c'est du XHTML 1.0 Strict.   
+Pour le reste, c'est du XHTML 1.0 Strict. Vous pouvez vous aider du
+      tutoriel XHTML des
+      tuteurs.
 
    • 
 
-        
  • Vérifiez votre page avec :
+        
  •  Vérifiez votre page avec :
 
     teck ~/tuteurs/cvs/web/unix $ tmlcheck accents.tml
 
    • 
 
-
  • Lancez le script de conversion en .html en faisant :
+
  •  Lancez le script de conversion en .html en faisant :
 
     teck ~/tuteurs/cvs/web/unix $ build accents.tml
 
     
    • 
 
-
  • Si vous avez fait beaucoup de modifications, il peut être utile de faire :
+
  •  Si vous avez fait beaucoup de modifications, il peut être utile de
+  retourner dans le répertoire web/ et de taper ::
 
     teck ~/tuteurs/cvs/web $ rebuild .
 
    • 
 
-
  • Passer la page que vous venez de créer au  Passer la page que vous venez de créer au validateur. 
 
    • 
         
 
  • 
-Quand tout est au point, vous pouvez « commiter » en faisant :
+Quand tout est au point, vous pouvez « commiter » en faisant (depuis le
+  répertoire web/) :
 
     teck ~/tuteurs/cvs/web $ make install
 
    • 
         
@@ -178,11 +188,14 @@ dispara
 install) ;
           
  • Effacez le fichier nolinks.
    • 
         
-          
+
+
     Vous trouverez des informations plus complètes sur la page de
+  documentation interne avancée.
+
    
 
 
    
 Auteurs : Joël Riou, Nicolas George et Éric Levieil.
-Dernière modification le .
+Dernière modification le .
 
    
 
 
diff --git a/nolinks b/nolinks
index fbcfb40..d856d3c 100644
--- a/nolinks
+++ b/nolinks
@@ -1,4 +1,5 @@
 doc-interne
+doc-interne-avancee
 aide
 404
 actualite