Bap: - liens réciproques entre les deux pages de documentation

- ajout de la page de doc avancée dans le nolinks
     - détails typographiques

doc-interne-avancee.tml

@@ -10,6 +10,12 @@
 
 <h1>Documentation interne avancée</h1>
 
+<div class="encadre">
+Pour une première approche, consultez d'abord la page
+de <a href="doc-interne.html">documentation interne sur la contribution
+au site des tuteurs</a>.
+</div>
+
 <p> 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 <a href="./">nouveau site</a>, et Nicolas a implémenté un
@@ -531,7 +537,7 @@ scandaleusement pr
 
     <div class="metainformation">
       Auteur : Joël Riou et Nicolas George. 
-Dernière modification le <date value="$Date: 2007-07-05 13:00:16 $" />.
+Dernière modification le <date value="$Date: 2007-07-05 13:32:07 $" />.
     </div>
 
   </body>

doc-interne.tml

@@ -14,11 +14,11 @@
 
 <p>
 La plupart des programmes utilisés dans la suite sont dans
-<code>~tuteurs/bin</code>. 
-Éditez le fichier <code> .profile </code> à 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) <em>avant</em> de se délogguer.
+<code>~tuteurs/bin</code>.  Éditez le fichier <code> .profile </code> à
+la racine de votre compte, trouvez le passage qui parle du PATH et
+modifiez la fin.  Attention, ne pas oublier de mettre&nbsp;:\ (non suivi
+d'espace&nbsp;!) à la fin de l'avant-dernière ligne, et de tester (en
+vous logguant une deuxième fois) <em>avant</em> de se délogguer.
 </p>
 
 <pre>
@@ -37,8 +37,8 @@ $MISCPATH:\
 
 <p>
 Tout d'abord, créez-vous un répertoire de travail sur votre compte avec
-<code> mkdir </code>. Par la suite, nous supposerons que ce répertoire
-s'appelle <code> tuteurs/cvs </code>.
+<code>mkdir</code>. Par la suite, nous supposerons que ce répertoire
+s'appelle <code> tuteurs/cvs</code>.
 </p>
 
 <p>Tapez les commandes suivantes: 
@@ -77,8 +77,12 @@ site
 est étroit), le <em>titre long</em> sera écrit en gros en 
 haut de la page.
 
-<p>Pour ajouter des fichiers binaires, il faut taper <code>cvstuteurs add -kb
-foobar.png </code>.</p>
+<p>Pour ajouter des fichiers binaires (par exemple des images), il faut
+taper&nbsp;:</p>
+<pre>
+<span class="prompt"> teck ~/tuteurs/cvs/web/unix
+$</span> <code>cvstuteurs add -kb foobar.png </code>.
+</pre>
 </li>
 
 <li>Écrivez le contenu du fichier.  Ce dernier sera passé dans une moulinette
@@ -86,39 +90,45 @@ qui s'appelle <code>xsltproc</code> 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:
-      <blockquote><p>
-       &lt; a href="&amp;url.tuteurs;docs/hublot/typo.html"&gt;
-      </p></blockquote>
+     <!-- <blockquote><p> -->
+<pre>
+&lt; a href="&amp;url.tuteurs;docs/hublot/typo.html"&gt;
+</pre>
+      <!-- </p></blockquote> -->
 
 Il faut mettre à la fin du fichier des lignes du type:
       <pre>
 &lt;div class="metainformation"&gt;
 Auteur : Comptes tuteurs.
-Dernière modification le &lt;date value="$Date: 2007-07-05 12:51:51 $" /&gt;.
+Dernière modification le &lt;date value="$Date: 2007-07-05 13:32:08 $" /&gt;.
 &lt;/div&gt;
 </pre>
   
-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
+      <a href="&url.tuteurs;internet/web/html/">tutoriel XHTML</a> des
+      tuteurs.
 </li>
 
-        <li>Vérifiez votre page avec :
+        <li> Vérifiez votre page avec :
 <pre><span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> tmlcheck accents.tml
 </pre></li>
 
-<li>Lancez le script de conversion en <code>.html</code> en faisant :
+<li> Lancez le script de conversion en <code>.html</code> en faisant :
 <pre><span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> build accents.tml
 </pre> </li>
 
-<li>Si vous avez fait beaucoup de modifications, il peut être utile de faire :
+<li> Si vous avez fait beaucoup de modifications, il peut être utile de
+  retourner dans le répertoire <code>web/</code> et de taper&nbsp;::
 <pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> rebuild .
 </pre></li>
 
-<li>Passer la page que vous venez de créer au <a
+<li> Passer la page que vous venez de créer au <a
 href="http://validator.w3.org/">validateur</a>. 
 </li>
         
 <li><a name="makeinstall" id="makeinstall"></a>
-Quand tout est au point, vous pouvez « commiter » en faisant :
+Quand tout est au point, vous pouvez « commiter » en faisant (depuis le
+  répertoire <code>web/</code>)&nbsp;:
 <pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> make install
 </pre></li>
         
@@ -179,10 +189,13 @@ install</code>)
           <li>Effacez le fichier <code>nolinks</code>.</li>
         </ul>
 
+<p> Vous trouverez des informations plus complètes sur la page de
+  <a href="doc-interne-avancee.html">documentation interne avancée</a>.
+</p>
 
 <div class="metainformation">
 Auteurs : Joël Riou, Nicolas George et Éric Levieil.
-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>
 
 </body>

nolinks

@@ -1,4 +1,5 @@
 doc-interne
+doc-interne-avancee
 aide
 404
 actualite