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 -

Quoi faire ?

+

Quelques astuces

+ +

Ne pas publier une page tout de suite

+ +

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. +

+ +
+

&icone.attention; Attention &icone.attention;

+

+Quand vos pages sont prêtes, procédez en plusieurs étapes pour faire +disparaître le fichier 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. +

+
+ +

Quoi faire ?

+

L'arborescence voulue du site se trouve dans le fichier 00INDEX et le fichier 00TODO contient ce qui @@ -451,7 +516,7 @@ scandaleusement pr

Auteur : Joël Riou et Nicolas George. -Dernière modification le . +Dernière modification le .