tuteurs.ens.fr/doc-interne.tml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
  PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
  "tuteurs://DTD/tml.dtd">
<html>
  <head>
    <title>Doc. interne</title>
  </head>
  <body>

      <h1>Comment mettre à jour le site des tuteurs ou y ajouter du contenu?</h1>

<h3> Rajouter <code>~tuteurs/bin</code> dans votre <code>PATH</code></h3>

<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 :\ (non suivi
d'espace !) à 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>
PATH=\
$HOME/bin/$SYSTEMNAME:\
$HOME/bin:\
$UTILPATH:\
$MAINPATH:\
$GAMESPATH:\
$MISCPATH:\
/users/staffs/tuteurs/bin
</pre>


       <h3>Se créer un répertoire de travail</h3>

<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>.
</p>

<p>Tapez les commandes suivantes: 
</p>
      <pre>
<span class="prompt"> teck ~/tuteurs/cvs $</span> cvstuteurs checkout web
<span class="prompt"> teck ~/tuteurs/cvs $</span> cd web
<span class="prompt"> teck ~/tuteurs/cvs/web $</span> rebuild .
</pre>
  
  <h3>Écrire une nouvelle page (ou la modifier)</h3>

     <p>Prenons un exemple. Supposons que vous souhaitiez écrire la page
<code>unix/accents.html</code>. Pour cela, il va falloir écrire
un fichier <code>unix/accents.tml</code>.
</p>
      <ol>
        <li>
Commencez par synchroniser votre répertoire de travail avec le repository:
<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> cvstuteurs update
</pre>
</li>
        <li>Pour commencer à travailler sur ce nouveau fichier, faites :

<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> cd unix
<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> tmltemplate accents.tml <em>"titre court"</em> <em>"titre long"</em> 
<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> cvstuteurs add accents.tml
<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> emacs accents.tml
</pre>

Si vous voulez modifier un fichier existant, il ne faut pas taper les
commandes du milieu.

Le <em>titre court</em> est celui qui apparaîtra dans l'arborescence du
site à gauche des pages (choississez-le concis, car l'arbre de navigation
est étroit), le <em>titre long</em> sera écrit en gros en 
haut de la page.

<p>Pour ajouter des fichiers binaires (par exemple des images), il faut
taper :</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
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> -->
<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: 2008-10-05 11:20:36 $" /&gt;.
&lt;/div&gt;
</pre>
  
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 :
<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 :
<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
  retourner dans le répertoire <code>web/</code> et de taper :
<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> rebuild .
</pre></li>

<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 (depuis le
  répertoire <code>web/</code>) :
<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> make install
</pre></li>
        
<li>
On vous demandera
d'indiquer des commentaires sur les man&#339;uvres que vous avez faites
dans les différents répertoires. Il est extrêmement important que ceux-ci
soient précis et circonstanciés, autant que possible. En clair, éviter de
mettre
<pre>Correction d'un problème important dans foobar.tml</pre></li>

<li>L'arborescence du site se trouve dans le fichier
<code>00INDEX</code> et le fichier <code>00TODO</code> contient ce qui
est en cours, avec diverses rubriques. Il est important que ces deux
fichiers soient mis-à-jour.</li>

</ol>

<h4>Ne pas publier une page tout de suite</h4>
      
<p>Vous pouvez 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>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>
Les fichiers <code>nolinks</code> peuvent être écrits directement, sans
passer par <code>CVS</code>.  Comme cela, sur votre copie
de travail, vous avez tous les liens.
</p>
        
<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> 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: 2008-10-05 11:20:36 $" />.
</div>

</body>
</html>
-												Passage en UTF-8, 2 : lignes <?xml encoding?>

Last-change: ignore this commit

											
										
										
											2009-09-20 12:34:28 +02:00
+								<?xml version="1.0" encoding="UTF-8"?>
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								<!DOCTYPE html
 								  PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
 								  "tuteurs://DTD/tml.dtd">
 								<html>
 								  <head>
 								    <title>Doc. interne</title>
 								  </head>
 								  <body>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								      <h1>Comment mettre à jour le site des tuteurs ou y ajouter du contenu?</h1>
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								<h3> Rajouter <code>~tuteurs/bin</code> dans votre <code>PATH</code></h3>
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								La plupart des programmes utilisés dans la suite sont dans
 								<code>~tuteurs/bin</code>.  Éditez le fichier <code> .profile </code> à
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								la racine de votre compte, trouvez le passage qui parle du PATH et
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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) <em>avant</em> de se délogguer.
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</p>
 								<pre>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								PATH=\
 								$HOME/bin/$SYSTEMNAME:\
 								$HOME/bin:\
 								$UTILPATH:\
 								$MAINPATH:\
 								$GAMESPATH:\
 								$MISCPATH:\
 								/users/staffs/tuteurs/bin
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</pre>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								       <h3>Se créer un répertoire de travail</h3>
-												Ajout de mon grain de sel.

											
										
										
											2002-12-06 18:19:11 +01:00
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								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
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								s'appelle <code> tuteurs/cvs</code>.
-												Ajout de mon grain de sel.

											
										
										
											2002-12-06 18:19:11 +01:00
+								</p>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								<p>Tapez les commandes suivantes:
-												Ajout d'un remarque sur l'arborescence

											
										
										
											2002-11-16 19:28:04 +01:00
+								</p>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								      <pre>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<span class="prompt"> teck ~/tuteurs/cvs $</span> cvstuteurs checkout web
 								<span class="prompt"> teck ~/tuteurs/cvs $</span> cd web
 								<span class="prompt"> teck ~/tuteurs/cvs/web $</span> rebuild .
-												Ajout de la nouvelle manière d'insérer la date de dernière modification

											
										
										
											2003-05-24 07:13:12 +02:00
+								</pre>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								  <h3>Écrire une nouvelle page (ou la modifier)</h3>
-												Ajout de la nouvelle manière d'insérer la date de dernière modification

											
										
										
											2003-05-24 07:13:12 +02:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								     <p>Prenons un exemple. Supposons que vous souhaitiez écrire la page
 								<code>unix/accents.html</code>. Pour cela, il va falloir écrire
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								un fichier <code>unix/accents.tml</code>.
-												- Précisions sur la date de dernière modification.
- Ne plus mentionner chklinks mais seulement le démon vérifieur.

											
										
										
											2004-03-08 17:33:20 +01:00
+								</p>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								      <ol>
 								        <li>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Commencez par synchroniser votre répertoire de travail avec le repository:
 								<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> cvstuteurs update
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</pre>
 								</li>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								        <li>Pour commencer à travailler sur ce nouveau fichier, faites :
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> cd unix
 								<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> tmltemplate accents.tml <em>"titre court"</em> <em>"titre long"</em>
 								<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> cvstuteurs add accents.tml
 								<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> emacs accents.tml
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</pre>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								Si vous voulez modifier un fichier existant, il ne faut pas taper les
 								commandes du milieu.
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Le <em>titre court</em> est celui qui apparaîtra dans l'arborescence du
 								site à gauche des pages (choississez-le concis, car l'arbre de navigation
 								est étroit), le <em>titre long</em> sera écrit en gros en
-												Correction des lignes de commandes a entrer pour creer un nouveau
fichier.

											
										
										
											2004-02-11 23:34:48 +01:00
+								haut de la page.
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								<p>Pour ajouter des fichiers binaires (par exemple des images), il faut
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								taper :</p>
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								<pre>
-												Bap: correction typographique mineure

											
										
										
											2007-07-07 11:43:14 +02:00
+								<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> <code>cvstuteurs add -kb foobar.png </code>
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								</pre>
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</li>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<li>Écrivez le contenu du fichier.  Ce dernier sera passé dans une moulinette
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								qui s'appelle <code>xsltproc</code> qui rajoute automatiquement
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								un plan du site à gauche et un sommaire de la page en cours de lecture.
-. doc-interne.tml: uniformisation de la typographie, et en particulier
des balises <pre>foo</pre> pour les lignes de commande.

2. unix/loguer.tml: mise à jour de la documentation sur APG

Baptiste.

											
										
										
											2005-04-11 15:09:58 +02:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Les liens internes à la page des tuteurs doivent être sous la forme:
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								     <!-- <blockquote><p> -->
 								<pre>
-												Bap: correction typographique mineure

											
										
										
											2007-07-07 11:43:14 +02:00
+								&lt;a href="&amp;url.tuteurs;docs/hublot/typo.html"&gt;
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								</pre>
 								      <!-- </p></blockquote> -->
-												Ajout de mon grain de sel.

											
										
										
											2002-12-06 18:19:11 +01:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Il faut mettre à la fin du fichier des lignes du type:
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								      <pre>
 								&lt;div class="metainformation"&gt;
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Auteur : Comptes tuteurs.
 								Dernière modification le &lt;date value="$Date: 2008-10-05 11:20:36 $" /&gt;.
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								&lt;/div&gt;
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</pre>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								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.
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</li>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								        <li> Vérifiez votre page avec :
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								<pre><span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> tmlcheck accents.tml
 								</pre></li>
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								<li> Lancez le script de conversion en <code>.html</code> en faisant :
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<pre><span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> build accents.tml
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								</pre> </li>
-												Mise à jour de doc-interne.tml pour prendre en compte le fait que la page est
installée

											
										
										
											2002-12-21 07:11:47 +01:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<li> Si vous avez fait beaucoup de modifications, il peut être utile de
 								  retourner dans le répertoire <code>web/</code> et de taper :
 								<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> rebuild .
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								</pre></li>
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<li> Passer la page que vous venez de créer au <a
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								href="http://validator.w3.org/">validateur</a>.
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</li>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
 								<li><a name="makeinstall" id="makeinstall"></a>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Quand tout est au point, vous pouvez « commiter » en faisant (depuis le
 								  répertoire <code>web/</code>) :
 								<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span> make install
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								</pre></li>
-												Ajout d'une remarque sur les commentaires lors d'un commit cvs

											
										
										
											2002-11-11 16:16:22 +01:00
+								<li>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								On vous demandera
 								d'indiquer des commentaires sur les man&#339;uvres que vous avez faites
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								dans les différents répertoires. Il est extrêmement important que ceux-ci
 								soient précis et circonstanciés, autant que possible. En clair, éviter de
-												Ajout d'une remarque sur les commentaires lors d'un commit cvs

											
										
										
											2002-11-11 16:16:22 +01:00
+								mettre
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<pre>Correction d'un problème important dans foobar.tml</pre></li>
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								<li>L'arborescence du site se trouve dans le fichier
 								<code>00INDEX</code> et le fichier <code>00TODO</code> contient ce qui
 								est en cours, avec diverses rubriques. Il est important que ces deux
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								fichiers soient mis-à-jour.</li>
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								</ol>
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								<h4>Ne pas publier une page tout de suite</h4>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<p>Vous pouvez décider de ne pas faire apparaître dans un
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
+								premier temps vos nouvelles pages dans l'arbre de navigation qui se
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								trouve sur la gauche des pages.</p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<p>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
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
+								la page <code>fichier.html</code> ou vers l'index de
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<code>répertoire</code>.</p>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<p>Par exemple, pour ne pas faire apparaître cette page de documentation
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
+								interne aux tuteurs (et quelques autres) dans l'index, la racine du
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<code>CVS</code> contient :
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
+								</p>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								      <pre><span class="prompt">clipper ~tuteurs/www $</span> cat nolinks
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
+								doc-interne
 								aide
 
 								actualite
 								plan_site
 								</pre>
 								<p>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Les fichiers <code>nolinks</code> peuvent être écrits directement, sans
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								passer par <code>CVS</code>.  Comme cela, sur votre copie
 								de travail, vous avez tous les liens.
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
+								</p>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<p>Quand vos pages sont prêtes, procédez en plusieurs étapes pour faire
 								disparaître le fichier <code>nolinks</code> :</p>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								        <ul>
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								          <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>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								          <li>Effacez le fichier <code>nolinks</code>.</li>
 								        </ul>
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								<p> Vous trouverez des informations plus complètes sur la page de
 								  <a href="doc-interne-avancee.html">documentation interne avancée</a>.
-												Bap: - liens réciproques entre les deux pages de documentation
     - ajout de la page de doc avancée dans le nolinks
     - détails typographiques

											
										
										
											2007-07-05 15:32:07 +02:00
+								</p>
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								<div class="metainformation">
-												Passage en UTF-8 des fichiers TML, 1 : recodage

Last-change: ignore this commit

											
										
										
											2009-09-20 12:27:14 +02:00
+								Auteurs : Joël Riou, Nicolas George et Éric Levieil.
 								Dernière modification le <date value="$Date: 2008-10-05 11:20:36 $" />.
-												- Paragraphe sur nolinks
- Suppression de la mention comme quoi on doit passer l'ancien site
en XHTML 1.0, c'est fait

											
										
										
											2004-03-08 18:06:30 +01:00
+								</div>
-Réécriture de la page de doc-interne, en mettant tous les éléments avancés
dans une nouvelle page doc-interne-avancee.tml (qui devra être réécrite).

											
										
										
											2007-07-05 14:51:51 +02:00
+								</body>
-												Ajout d'une petite documentation sur comment modifier le site

											
										
										
											2002-11-11 10:13:36 +01:00
+								</html>