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 -
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. +
-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 nolinks
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 « fichier
» ou encore
+« répertoire/
». Cela désactivera les liens éventuels vers
+la page fichier.html
ou vers l'index de
+répertoire
.
+Par exemple, pour ne pas faire apparaître cette page de documentation
+interne aux tuteurs (et quelques autres) dans l'index, la racine du
+CVS
contient :
+
+clipper ~tuteurs/www $ cat nolinks
+doc-interne
+aide
+404
+actualite
+plan_site
+
+
+
+Un autre exemple : pendant le développement de la partie
+logiciels/mozilla/
du site, le fichier
+logiciels/nolinks
contenait:
+
+mozilla/ ++ +
+On peut conseiller de ne pas rentrer ce fichier nolinks
dans
+CVS
, mais seulement de le mettre au bon endroit à partir de
+~tuteurs/www/
, cela simplifie un peu les choses, et comme
+cela, sur votre copie de travail, vous avez tous les liens.
+
+Quand vos pages sont prêtes, procédez en plusieurs étapes pour faire
+disparaître le fichier nolinks
:
+
rebuild
(ou make
+install
) ;nolinks
.En effet, si vous effacez directement le fichier nolinks
,
+a priori, le script de regénération ne refabriquera pas les
+pages et les liens vers les nouvelles pages ne seront pas insérés.
+
L'arborescence voulue du site se trouve dans le fichier
00INDEX
et le fichier 00TODO
contient ce qui
@@ -451,7 +516,7 @@ scandaleusement pr