From 7b01407ce88f5695c9678b98cdf04cc69b427e03 Mon Sep 17 00:00:00 2001
From: jriou <jriou>
Date: Mon, 8 Mar 2004 17:06:30 +0000
Subject: [PATCH] - Paragraphe sur nolinks - Suppression de la mention comme
 quoi on doit passer l'ancien site en XHTML 1.0, c'est fait

---
 doc-interne.tml | 73 ++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 69 insertions(+), 4 deletions(-)

diff --git a/doc-interne.tml b/doc-interne.tml
index 6f496d2..45b2ab8 100644
--- a/doc-interne.tml
+++ b/doc-interne.tml
@@ -382,13 +382,78 @@ mettre
 </li>
 </ol>
 
-<h2>Quoi faire ?</h2>
+<h3>Quelques astuces</h3>
+
+<h4>Ne pas publier une page tout de suite</h4>
+
+<p>Imaginons que vous avez commencé à travailler une nouvelle section du
+site, que les pages que vous venez de faire ne soient pas tout-à-fait au
+point. Vous pouvez alors décider de ne pas faire apparaître dans un
+premier temps vos nouvelles pages dans l'arbre de navigation qui se
+trouve sur la gauche des pages.
+</p>
 
 <p>
-Essentiellement, il s'agit de récupérer les pages de l'ancien site, de
-les mettre à jour en les convertissant en XHTML 1.0 Strict.
+Pour cela, le script de génération des pages regarde dans chaque
+répertoire si un fichier <code>nolinks</code> s'y trouve. Ce fichier doit
+contenir une liste séparée par des espaces ou des retours à la ligne de
+choses de la forme « <code>fichier</code> » ou encore
+« <code>répertoire/</code> ». Cela désactivera les liens éventuels vers
+la page <code>fichier.html</code> ou vers l'index de
+<code>répertoire</code>.
 </p>
 
+<p>
+Par exemple, pour ne pas faire apparaître cette page de documentation
+interne aux tuteurs (et quelques autres) dans l'index, la racine du
+<code>CVS</code> contient :
+</p>
+<pre>
+<span class="prompt">clipper ~tuteurs/www $</span> cat nolinks
+doc-interne
+aide
+404
+actualite
+plan_site
+</pre>
+
+<p>
+Un autre exemple : pendant le développement de la partie
+<code>logiciels/mozilla/</code> du site, le fichier
+<code>logiciels/nolinks</code> contenait:
+</p>
+<pre>
+mozilla/
+</pre>
+
+<p>
+On peut conseiller de ne pas rentrer ce fichier <code>nolinks</code> dans
+<code>CVS</code>, mais seulement de le mettre au bon endroit à partir de
+<code>~tuteurs/www/</code>, cela simplifie un peu les choses, et comme
+cela, sur votre copie de travail, vous avez tous les liens.
+</p>
+
+<div class="attention">
+<h1>&icone.attention; Attention &icone.attention;</h1>
+<p>
+Quand vos pages sont prêtes, procédez en plusieurs étapes pour faire
+disparaître le fichier <code>nolinks</code> :
+</p>
+<ul>
+<li>Éditez-le pour qu'íl devienne vide ;</li>
+<li>Regénérez les pages avec <code>rebuild</code> (ou <code>make
+install</code>) ;</li>
+<li>Effacez le fichier <code>nolinks</code>.</li>
+</ul>
+
+<p>En effet, si vous effacez directement le fichier <code>nolinks</code>,
+<em>a priori</em>, le script de regénération ne refabriquera pas les
+pages et les liens vers les nouvelles pages ne seront pas insérés.
+</p>
+</div>
+
+<h2>Quoi faire ?</h2>
+
 <p>
 L'arborescence voulue du site se trouve dans le fichier
 <code>00INDEX</code> et le fichier <code>00TODO</code> contient ce qui
@@ -451,7 +516,7 @@ scandaleusement pr
 
     <div class="metainformation">
       Auteur : Joël Riou et Nicolas George. 
-Dernière modification le <date value="$Date: 2004-03-08 16:33:20 $" />.
+Dernière modification le <date value="$Date: 2004-03-08 17:06:30 $" />.
     </div>
 
   </body>