2002-11-11 10:13:36 +01:00
|
|
|
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
|
|
|
|
<!DOCTYPE html
|
|
|
|
|
|
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
|
|
|
|
|
|
"tuteurs://DTD/tml.dtd">
|
|
|
|
|
|
<html>
|
|
|
|
|
|
<head>
|
|
|
|
|
|
<title>Doc. interne</title>
|
|
|
|
|
|
</head>
|
|
|
|
|
|
<body>
|
|
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<h1>Comment mettre <20> jour le site des tuteurs ou y ajouter du contenu?</h1>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<h3> Rajouter <code>~tuteurs/bin</code> dans votre <code>PATH</code></h3>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
|
|
|
|
|
<p>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
La plupart des programmes utilis<69>s dans la suite sont dans
|
2007-07-05 15:32:07 +02:00
|
|
|
|
<code>~tuteurs/bin</code>. <20>ditez le fichier <code> .profile </code> <20>
|
|
|
|
|
|
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 !) <20> la fin de l'avant-derni<6E>re ligne, et de tester (en
|
|
|
|
|
|
vous logguant une deuxi<78>me fois) <em>avant</em> de se d<>logguer.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<pre>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
PATH=\
|
|
|
|
|
|
$HOME/bin/$SYSTEMNAME:\
|
|
|
|
|
|
$HOME/bin:\
|
|
|
|
|
|
$UTILPATH:\
|
|
|
|
|
|
$MAINPATH:\
|
|
|
|
|
|
$GAMESPATH:\
|
|
|
|
|
|
$MISCPATH:\
|
|
|
|
|
|
/users/staffs/tuteurs/bin
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<h3>Se cr<63>er un r<>pertoire de travail</h3>
|
2002-12-06 18:19:11 +01:00
|
|
|
|
|
|
|
|
|
|
<p>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
Tout d'abord, cr<63>ez-vous un r<>pertoire de travail sur votre compte avec
|
2007-07-05 15:32:07 +02:00
|
|
|
|
<code>mkdir</code>. Par la suite, nous supposerons que ce r<>pertoire
|
|
|
|
|
|
s'appelle <code> tuteurs/cvs</code>.
|
2002-12-06 18:19:11 +01:00
|
|
|
|
</p>
|
|
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<p>Tapez les commandes suivantes:
|
2002-11-16 19:28:04 +01:00
|
|
|
|
</p>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt"> teck ~/tuteurs/cvs $</span><3E>cvstuteurs checkout web
|
|
|
|
|
|
<span class="prompt"> teck ~/tuteurs/cvs $</span><3E>cd web
|
|
|
|
|
|
<span class="prompt"> teck ~/tuteurs/cvs/web $</span><3E>rebuild .
|
2003-05-24 07:13:12 +02:00
|
|
|
|
</pre>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
|
|
|
|
|
|
<h3><3E>crire une nouvelle page (ou la modifier)</h3>
|
2003-05-24 07:13:12 +02:00
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<p>Prenons un exemple. Supposons que vous souhaitiez <20>crire la page
|
|
|
|
|
|
<code>unix/accents.html</code>. Pour cela, il va falloir <20>crire
|
|
|
|
|
|
un fichier <code>unix/accents.tml</code>.
|
2004-03-08 17:33:20 +01:00
|
|
|
|
</p>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<ol>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Commencez par synchroniser votre r<>pertoire de travail avec le repository:
|
|
|
|
|
|
<pre><span class="prompt"> teck ~/tuteurscvs/web $</span><3E>cvstuteurs update
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</pre>
|
|
|
|
|
|
</li>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<li>Pour commencer <20> travailler sur ce nouveau fichier, faites<65>:
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span><3E>cd unix
|
|
|
|
|
|
<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> tmltemplate accents.tml <em>"titre court"</em><3E><em>"titre long"</em><3E>
|
|
|
|
|
|
<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span><3E>cvstuteurs add accents.tml
|
|
|
|
|
|
<span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span><3E>emacs accents.tml
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</pre>
|
|
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
Si vous voulez modifier un fichier existant, il ne faut pas taper les
|
|
|
|
|
|
commandes du milieu.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
2004-02-11 23:34:48 +01:00
|
|
|
|
Le <em>titre court</em> est celui qui appara<72>tra dans l'arborescence du
|
2007-07-05 14:51:51 +02:00
|
|
|
|
site <20> gauche des pages (choississez-le concis, car l'arbre de navigation
|
|
|
|
|
|
est <20>troit), le <em>titre long</em> sera <20>crit en gros en
|
2004-02-11 23:34:48 +01:00
|
|
|
|
haut de la page.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
2007-07-05 15:32:07 +02:00
|
|
|
|
<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>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</li>
|
|
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<li><3E>crivez le contenu du fichier. Ce dernier sera pass<73> dans une moulinette
|
|
|
|
|
|
qui s'appelle <code>xsltproc</code> qui rajoute automatiquement
|
|
|
|
|
|
un plan du site <20> gauche et un sommaire de la page en cours de lecture.
|
2005-04-11 15:09:58 +02:00
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
Les liens internes <20> la page des tuteurs doivent <20>tre sous la forme:
|
2007-07-05 15:32:07 +02:00
|
|
|
|
<!-- <blockquote><p> -->
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
< a href="&url.tuteurs;docs/hublot/typo.html">
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
<!-- </p></blockquote> -->
|
2002-12-06 18:19:11 +01:00
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
Il faut mettre <20> la fin du fichier des lignes du type:
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<div class="metainformation">
|
|
|
|
|
|
Auteur<EFBFBD>: Comptes tuteurs.
|
2007-07-05 15:32:07 +02:00
|
|
|
|
Derni<EFBFBD>re modification le <date value="$Date: 2007-07-05 13:32:08 $" />.
|
2007-07-05 14:51:51 +02:00
|
|
|
|
</div>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</pre>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
|
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.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</li>
|
|
|
|
|
|
|
2007-07-05 15:32:07 +02:00
|
|
|
|
<li> V<>rifiez votre page avec :
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<pre><span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> tmlcheck accents.tml
|
|
|
|
|
|
</pre></li>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
2007-07-05 15:32:07 +02:00
|
|
|
|
<li> Lancez le script de conversion en <code>.html</code> en faisant :
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<pre><span class="prompt"> teck ~/tuteurs/cvs/web/unix $</span> build<6C>accents.tml
|
|
|
|
|
|
</pre> </li>
|
2002-12-21 07:11:47 +01:00
|
|
|
|
|
2007-07-05 15:32:07 +02:00
|
|
|
|
<li> Si vous avez fait beaucoup de modifications, il peut <20>tre utile de
|
|
|
|
|
|
retourner dans le r<>pertoire <code>web/</code> et de taper ::
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span><3E>rebuild .
|
|
|
|
|
|
</pre></li>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
2007-07-05 15:32:07 +02:00
|
|
|
|
<li> Passer la page que vous venez de cr<63>er au <a
|
2007-07-05 14:51:51 +02:00
|
|
|
|
href="http://validator.w3.org/">validateur</a>.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</li>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
|
|
|
|
|
|
<li><a name="makeinstall" id="makeinstall"></a>
|
2007-07-05 15:32:07 +02:00
|
|
|
|
Quand tout est au point, vous pouvez <20><>commiter<65><72> en faisant (depuis le
|
|
|
|
|
|
r<>pertoire <code>web/</code>) :
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<pre><span class="prompt"> teck ~/tuteurs/cvs/web $</span><3E>make install
|
|
|
|
|
|
</pre></li>
|
|
|
|
|
|
|
2002-11-11 16:16:22 +01:00
|
|
|
|
<li>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
On vous demandera
|
|
|
|
|
|
d'indiquer des commentaires sur les manœuvres que vous avez faites
|
2002-11-11 16:16:22 +01:00
|
|
|
|
dans les diff<66>rents r<>pertoires. Il est extr<74>mement important que ceux-ci
|
|
|
|
|
|
soient pr<70>cis et circonstanci<63>s, autant que possible. En clair, <20>viter de
|
|
|
|
|
|
mettre
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<pre>Correction d'un probl<62>me important dans foobar.tml</pre></li>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
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
|
|
|
|
|
|
fichiers soient mis-<2D>-jour.</li>
|
2004-03-08 18:06:30 +01:00
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
</ol>
|
2004-03-08 18:06:30 +01:00
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<h4>Ne pas publier une page tout de suite</h4>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Vous pouvez d<>cider de ne pas faire appara<72>tre dans un
|
2004-03-08 18:06:30 +01:00
|
|
|
|
premier temps vos nouvelles pages dans l'arbre de navigation qui se
|
2007-07-05 14:51:51 +02:00
|
|
|
|
trouve sur la gauche des pages.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Pour cela, le script de g<>n<EFBFBD>ration des pages regarde dans chaque
|
2004-03-08 18:06:30 +01:00
|
|
|
|
r<EFBFBD>pertoire si un fichier <code>nolinks</code> s'y trouve. Ce fichier doit
|
|
|
|
|
|
contenir une liste s<>par<61>e par des espaces ou des retours <20> la ligne de
|
|
|
|
|
|
choses de la forme <20><><code>fichier</code><3E><> ou encore
|
|
|
|
|
|
<EFBFBD><EFBFBD><code>r<>pertoire/</code><3E><>. Cela d<>sactivera les liens <20>ventuels vers
|
|
|
|
|
|
la page <code>fichier.html</code> ou vers l'index de
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<code>r<>pertoire</code>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Par exemple, pour ne pas faire appara<72>tre cette page de documentation
|
2004-03-08 18:06:30 +01:00
|
|
|
|
interne aux tuteurs (et quelques autres) dans l'index, la racine du
|
|
|
|
|
|
<code>CVS</code> contient<6E>:
|
|
|
|
|
|
</p>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
|
|
|
|
|
|
<pre><span class="prompt">clipper ~tuteurs/www $</span><3E>cat nolinks
|
2004-03-08 18:06:30 +01:00
|
|
|
|
doc-interne
|
|
|
|
|
|
aide
|
|
|
|
|
|
404
|
|
|
|
|
|
actualite
|
|
|
|
|
|
plan_site
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
Les fichiers <code>nolinks</code> peuvent <20>tre <20>crits directement, sans
|
|
|
|
|
|
passer par <code>CVS</code>. Comme cela, sur votre copie
|
|
|
|
|
|
de travail, vous avez tous les liens.
|
2004-03-08 18:06:30 +01:00
|
|
|
|
</p>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
|
|
|
|
|
|
<p>Quand vos pages sont pr<70>tes, proc<6F>dez en plusieurs <20>tapes pour faire
|
|
|
|
|
|
dispara<EFBFBD>tre le fichier <code>nolinks</code><3E>:</p>
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li><3E>ditez-le pour qu'<27>l devienne vide<64>;</li>
|
|
|
|
|
|
<li>Reg<65>n<EFBFBD>rez les pages avec <code>rebuild</code><3E>(ou <code>make
|
2004-03-08 18:06:30 +01:00
|
|
|
|
install</code>)<29>;</li>
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<li>Effacez le fichier <code>nolinks</code>.</li>
|
|
|
|
|
|
</ul>
|
2007-07-05 15:32:07 +02:00
|
|
|
|
|
|
|
|
|
|
<p> Vous trouverez des informations plus compl<70>tes sur la page de
|
|
|
|
|
|
<a href="doc-interne-avancee.html">documentation interne avanc<6E>e</a>.
|
|
|
|
|
|
</p>
|
2004-03-08 18:06:30 +01:00
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
<div class="metainformation">
|
|
|
|
|
|
Auteurs : Jo<4A>l Riou, Nicolas George et <20>ric Levieil.
|
2007-07-05 15:32:07 +02:00
|
|
|
|
Derni<EFBFBD>re modification le <date value="$Date: 2007-07-05 13:32:08 $" />.
|
2004-03-08 18:06:30 +01:00
|
|
|
|
</div>
|
|
|
|
|
|
|
2007-07-05 14:51:51 +02:00
|
|
|
|
</body>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</html>
|
