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>
|
|
|
|
|
|
|
|
|
|
|
|
<h1>Comment mettre <20> jour le site des tuteurs ou y ajouter du contenu</h1>
|
|
|
|
|
|
|
|
|
|
|
|
|
2002-12-21 07:11:47 +01:00
|
|
|
|
<p> Comme vous le savez, le site des tuteurs subit un lifting.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
Marie-Lan et Nicolas ont notamment choisi les couleurs et la pr<70>sentation
|
|
|
|
|
|
du <a href="&url.tuteurs;">nouveau site</a>, et Nicolas a impl<70>ment<6E> un
|
|
|
|
|
|
certain nombre de scripts (ceux-ci se trouvent dans la branche
|
|
|
|
|
|
<code>utilitaires/tml</code> du <code>cvstuteurs</code>). </p>
|
|
|
|
|
|
|
|
|
|
|
|
<div class="attention">
|
|
|
|
|
|
<h1>&icone.attention;<3B>Attention<6F>&icone.attention;</h1>
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Ne pas modifier la branche <code>utilitaires/tml</code> du
|
|
|
|
|
|
<code>cvstuteurs</code> <20> moins de savoir vraiment ce que vous faites,
|
|
|
|
|
|
puisque tout le site Web en d<>pend.</p>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Cette page a pour but<75>:</p>
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li>non seulement d'expliquer comment modifier le site;</li>
|
|
|
|
|
|
<li><em>mais aussi</em> de servir de fichier d'exemple pour l'<27>laboration des
|
|
|
|
|
|
pages.</li>
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Un bref r<>sum<75> des choses <20> ne pas faire se trouve dans les dix
|
|
|
|
|
|
<a href="#commandements">commandements</a>.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
2002-11-11 10:28:58 +01:00
|
|
|
|
<h2>Comment tout cela fonctionne<6E>?</h2>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
|
|
|
|
|
<p> Tout est g<>r<EFBFBD> depuis l'arborescence <code>web</code> du
|
|
|
|
|
|
<code>cvstuteurs</code>. (NDjriou: l'ancien site est toujours dans
|
|
|
|
|
|
l'arborescence <code>www</code> dudit <code>cvs</code>) </p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Dans ce <code>cvs</code> figurent uniquement des fichiers
|
|
|
|
|
|
<code>.tml</code> et des fichiers t<>l<EFBFBD>chargeables (icones, screenshots,
|
|
|
|
|
|
illustrations du hublot, PostScripts gzipp<70>s d'icelui)
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Le site Web en lui-m<>me se trouve <20> l'adresse <a
|
2004-06-10 18:05:54 +02:00
|
|
|
|
href="&url.tuteurs;"><code>http://www.tuteurs.ens.fr/</code></a>.
|
2003-09-19 22:48:03 +02:00
|
|
|
|
Pour des raisons de compatibilit<69> avec l'ancien site Web des tuteurs et
|
|
|
|
|
|
la phase transitoire, les adresses
|
|
|
|
|
|
<code>http://www.eleves.ens.fr/tuteurs/ancien-site/</code> sont
|
2004-06-10 18:05:54 +02:00
|
|
|
|
redirig<EFBFBD>es vers <code>http://www.tuteurs.ens.fr/</code> et les
|
2003-09-19 22:48:03 +02:00
|
|
|
|
noms sous lesquels les pages existaient avant sont redirig<69>es vers leur
|
|
|
|
|
|
nouvelle position.
|
|
|
|
|
|
</p>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
2002-11-11 10:28:58 +01:00
|
|
|
|
<h3>Les fichiers <code>tml</code></h3>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
2002-11-16 19:28:04 +01:00
|
|
|
|
<h4>Th<54>oriquement</h4>
|
|
|
|
|
|
|
2002-11-11 10:13:36 +01:00
|
|
|
|
<p>Pour faire une nouvelle page Web, il faut <20>crire un fichier
|
|
|
|
|
|
<code>foobar.tml</code>. C'est presque du HTML, mais il y a quelques
|
|
|
|
|
|
nuances. En effet, ces fichiers sont pass<73>s dans une moulinette qui
|
|
|
|
|
|
s'appelle <code>xsltproc</code> quand vous <20>x<EFBFBD>cutez la commande :</p>
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web/docs/hublot $</span><3E>~tuteurs/bin/build hublot12.tml
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Il en ressort normalement (s'il n'y a pas trop d'erreurs de syntaxe) un
|
|
|
|
|
|
fichier <code>html</code> tr<74>s joli. Ce dernier utilise une feuille de
|
|
|
|
|
|
style <code>tuteurs.css</code>, contient une bande de navigation <20> gauche
|
|
|
|
|
|
pr<EFBFBD>sentant notamment un arbre du site et un sommaire de la page en cours
|
|
|
|
|
|
de lecture, le tout g<>n<EFBFBD>r<EFBFBD> automatiquement gr<67>ce <20> la patience du
|
|
|
|
|
|
concepteur de la nouvelle charte graphique.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<div class="encadre">
|
|
|
|
|
|
<p>Les scripts prennent en compte le <em>titre</em> des pages pour g<>n<EFBFBD>rer
|
|
|
|
|
|
l'arborescence. Il convient donc de les faire courts.</p>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<p>La moulinette et la feuille de style permettent de faire tr<74>s simplement
|
2002-11-11 10:31:41 +01:00
|
|
|
|
beaucoup choses<65>: des encadr<64>s, des jolis prompts, des
|
2002-11-11 10:13:36 +01:00
|
|
|
|
tableaux...</p>
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Par ailleurs, dans les fichiers <code>.tml</code>, tous les liens
|
|
|
|
|
|
internes <20> la page des tuteurs doivent <20>tre relatifs, mais il y a une
|
|
|
|
|
|
astuce<EFBFBD>: la racine de l'arborescence du site a pour synonyme
|
|
|
|
|
|
<code>&url.tuteurs;</code>. Ainsi, dans
|
|
|
|
|
|
<code>logiciels/latex/astuces.tml</code>, on trouve le lien
|
|
|
|
|
|
suivant<EFBFBD>:</p>
|
|
|
|
|
|
|
|
|
|
|
|
<blockquote>
|
2002-11-11 10:16:30 +01:00
|
|
|
|
<p><p> Mais cela ne doit pas vous emp<6D>cher de prendre de <a
|
|
|
|
|
|
href="&url.tuteurs;docs/hublot/typo.html">bonnes
|
|
|
|
|
|
habitudes</a> quand vous tapez avec d'autres logiciels ou que vous
|
|
|
|
|
|
r<EFBFBD>digez un courrier toutes les ponctuations sont suivies d'un espace,
|
|
|
|
|
|
seules les ponctuations doubles sont pr<70>c<EFBFBD>d<EFBFBD>es d'un espace.</p></p>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</blockquote>
|
|
|
|
|
|
|
2002-11-16 19:28:04 +01:00
|
|
|
|
|
|
|
|
|
|
<h4>Concr<63>tement...</h4>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Pour faire un fichier <code>page.tml</code>, r<>cup<75>rez l'en-t<>te d'un
|
|
|
|
|
|
autre fichier <code>.tml</code> du site, et modifiez les titres:
|
|
|
|
|
|
</p>
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
|
|
|
|
<!DOCTYPE html
|
|
|
|
|
|
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
|
|
|
|
|
|
"tuteurs://DTD/tml.dtd">
|
|
|
|
|
|
<html>
|
|
|
|
|
|
<head>
|
|
|
|
|
|
<title>Les tuteurs</title>
|
|
|
|
|
|
</head>
|
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
|
|
<h1>Le site des tuteurs</h1>
|
|
|
|
|
|
|
2002-12-21 03:59:47 +01:00
|
|
|
|
<p> Bienvenue sur la page Web des tuteurs informatique de l'<27>cole
|
2002-11-16 19:28:04 +01:00
|
|
|
|
Normale sup<75>rieure. Le contenu de ce site est organis<69> en grands
|
|
|
|
|
|
th<EFBFBD>mes| :</p>
|
|
|
|
|
|
</pre>
|
2002-12-06 18:19:11 +01:00
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Il est <20>galement possible d'utiliser la commande <code>tmltemplate
|
|
|
|
|
|
<em>fichier.tml</em> [<em>titre</em>] [<em>titre long</em>]</code>.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
2002-11-16 19:28:04 +01:00
|
|
|
|
<p>
|
|
|
|
|
|
Le titre de la page (ici <20> Les tuteurs <20>) doit <20>tre le plus court
|
|
|
|
|
|
possible car c'est lui qui est pris en compte pour faire l'arbre de
|
|
|
|
|
|
navigation qui se trouvent sur la gauche lors de l'affichage par un
|
|
|
|
|
|
navigateur en mode graphique de la page Web une fois g<>n<EFBFBD>r<EFBFBD>e par les
|
|
|
|
|
|
scripts.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Le titre qui s'affiche en gros tout en haut de la page doit <20>tre indiqu<71>
|
|
|
|
|
|
avec une balise <code><h1></code>, les diff<66>rentes sections avec
|
|
|
|
|
|
<code><h2></code>, etc... Enfin, un paragraphe doit se trouver <20>
|
|
|
|
|
|
l'int<6E>rieur d'une balise <code><p></code>
|
|
|
|
|
|
</p>
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Lorsque l'on <20>x<EFBFBD>cute le script <code>build</code> sur un fichier
|
|
|
|
|
|
<code>.tml</code>, le fichier <code>.html</code> produit contient un
|
|
|
|
|
|
sommaire en dessous du gros titre, celui-ci est g<>n<EFBFBD>r<EFBFBD> <20> partir des
|
|
|
|
|
|
balises <code><h2></code> et <code><h3></code> se trouvant
|
|
|
|
|
|
dans le fichier <code>.tml</code>.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
2003-05-24 07:13:12 +02:00
|
|
|
|
<h4><a name="date" />Les dates de derni<6E>re modification</h4>
|
|
|
|
|
|
|
|
|
|
|
|
<p><3E> partir de l'instant o<> vous lisez ces lignes, quand vous <20>crirez une
|
|
|
|
|
|
page pour le site des tuteurs ou que vous en modifierez une, vous devrez
|
|
|
|
|
|
<strong>obligatoirement</strong> (de toute fa<66>on, vous ne pourrez pas
|
2004-03-08 17:33:20 +01:00
|
|
|
|
faire autrement, h<>, h<>...) mettre <20> la fin des lignes du type:
|
2003-05-24 07:13:12 +02:00
|
|
|
|
</p>
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<div class="metainformation">
|
|
|
|
|
|
Auteur<EFBFBD>: Comptes tuteurs.
|
|
|
|
|
|
Derni<EFBFBD>re modification le <date value="$Date$" />.
|
|
|
|
|
|
</div>
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
2004-03-08 17:33:20 +01:00
|
|
|
|
<p>Quand vous commiterez vos modifications avec <code>CVS</code>,
|
|
|
|
|
|
ce dernier modifiera votre fichier pour ins<6E>rer la vraie date <20> c<>t<EFBFBD> de
|
|
|
|
|
|
<code>$Date$</code>. N'y touchez-plus, <code>CVS</code> et les
|
|
|
|
|
|
scripts de g<>n<EFBFBD>ration des fichiers <code>html</code> s'occupent de tout.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
2002-11-11 10:28:58 +01:00
|
|
|
|
<h3>Les fichiers <code>html</code></h3>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
|
|
|
|
|
<p>Les scripts transforment les <code>.tml</code> en <code>.html</code>. Ces
|
|
|
|
|
|
derniers doivent <20>tre du <strong>XHTML 1.0 Strict</strong>. Pour le
|
2002-11-11 16:33:38 +01:00
|
|
|
|
v<EFBFBD>rifier, passez les pages que vous modifiez au <a
|
2002-11-11 10:13:36 +01:00
|
|
|
|
href="http://validator.w3.org/">validateur</a>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Quelles sont les diff<66>rences entre le HTML usuel et le XHTML 1.0
|
|
|
|
|
|
Strict ?</p>
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li><strong>Toutes</strong> les balises doivent <20>tre referm<72>es. Ainsi,
|
|
|
|
|
|
pour faire un paragraphe on fait
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<p>
|
|
|
|
|
|
En utilisant la suite spectrale de coniveau, on peut d<>montrer le
|
|
|
|
|
|
th<EFBFBD>or<EFBFBD>me [...].
|
|
|
|
|
|
</p>
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>On <20>vite au maximum les retours <20> la ligne sauvages avec
|
|
|
|
|
|
<code><br></code>. D'ailleurs, ce genre de balises sont <20>crire
|
|
|
|
|
|
sous la forme <code><br<62>/></code> pour se conformer <20> la premi<6D>re
|
|
|
|
|
|
exigence<EFBFBD>;
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Tous les param<61>tres doivent <20>tre mis entre guillements et les images
|
|
|
|
|
|
doivent avoir un param<61>tre alternatif :
|
|
|
|
|
|
<pre>
|
2004-02-01 02:26:54 +01:00
|
|
|
|
<img src="docs/hublot/hublot01/logoAI.png" alt="[Logo de l'Atelier Internet]"/>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</pre>
|
|
|
|
|
|
</li>
|
2002-11-14 07:12:22 +01:00
|
|
|
|
<li>
|
|
|
|
|
|
Toutes les balises doivent <20>tre mises en minuscules.
|
|
|
|
|
|
</li>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</ul>
|
|
|
|
|
|
|
2002-11-11 16:33:38 +01:00
|
|
|
|
<p>Apr<70>s que le repository du <code>cvstuteurs</code> est modifi<66>
|
|
|
|
|
|
<em>via</em> la commande <a href="#makeinstall"><code>make
|
|
|
|
|
|
install</code></a> dans la racine de son r<>pertoire de travail (ou celui
|
|
|
|
|
|
d'un autre)), les fichiers <code>.tml</code> figurant dans
|
|
|
|
|
|
<code>~tuteurs/www/web</code> sont mis-<2D>-jour, et le script
|
|
|
|
|
|
<code>rebuild</code> est lanc<6E> dedans<6E>: ce script <20>x<EFBFBD>cute
|
2002-11-11 10:13:36 +01:00
|
|
|
|
<code>build</code> sur tous les fichiers <code>.tml</code> qui en ont
|
2002-11-11 16:33:38 +01:00
|
|
|
|
besoin, ce qui permet de mettre <20> jour les fichiers <code>.html</code> du
|
|
|
|
|
|
site.</p>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
|
|
|
|
|
|
2002-11-11 10:28:58 +01:00
|
|
|
|
<h2>Comment modifier le site<74>?</h2>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
|
|
|
|
|
<p>Comme le site est g<>r<EFBFBD> via <code>cvs</code>, il convient de conna<6E>tre
|
|
|
|
|
|
le minimum n<>cessaire pour utiliser ce logiciel, nous allons le voir
|
|
|
|
|
|
ci-dessous.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
2002-11-11 10:28:58 +01:00
|
|
|
|
<h3>Se cr<63>er un r<>pertoire de travail</h3>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
|
|
|
|
|
<p>Pour utiliser <code>cvs</code>, il faut se cr<63>er un r<>pertoire de
|
|
|
|
|
|
travail <em>chez soi</em>, c'est-<2D>-dire r<>cup<75>rer les fichiers se
|
|
|
|
|
|
trouvant dans le <em>repository</em>, <20> savoir
|
|
|
|
|
|
<code>~tuteurs/cvs/web</code>. Pour cela, il suffit de taper la commande
|
|
|
|
|
|
suivante dans votre r<>pertoire <code>~/tuteurs/cvs</code> par
|
|
|
|
|
|
exemple<EFBFBD>:</p>
|
|
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs $</span><3E>cvstuteurs checkout web
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Il est imp<6D>ratif d'utiliser <code>cvstuteurs</code> <20> la place de
|
|
|
|
|
|
<code>cvs</code><3E>: ce permet de faire travailler <code>cvs</code>
|
|
|
|
|
|
directement dans le repository des tuteurs et de le faire travailler en
|
|
|
|
|
|
tant que membre du groupe tuteurs, ce qui est tr<74>s important pour <20>viter
|
|
|
|
|
|
de tout casser (comme c'est arriv<69> le premier jour). Par cons<6E>quent, je
|
|
|
|
|
|
vous recommande vivement d'ins<6E>rer la ligne suivante dans votre
|
|
|
|
|
|
<code>.zshrc</code></p>
|
|
|
|
|
|
<pre>
|
2002-11-14 07:12:22 +01:00
|
|
|
|
alias cvs='echo "Non, tu ne veux pas utiliser cvs directement, utilise cvstuteurs"'
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Vous voyez appara<72>tre quelques fichiers <code>.tml</code> dans votre
|
|
|
|
|
|
r<EFBFBD>pertoire de travail. Pour les transformer en <code>.html</code>,
|
|
|
|
|
|
faites<EFBFBD>:
|
|
|
|
|
|
</p>
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web $</span><3E>~tuteurs/bin/rebuild .
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
2002-11-11 10:28:58 +01:00
|
|
|
|
<h3>Contribuer au nouveau site</h3>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
|
|
|
|
|
|
<p>Prenons un exemple. Supposons que vous souhaitiez <20>crire la page
|
|
|
|
|
|
<code>unix/accents.html</code>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<ol>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Commencez par synchroniser votre r<>pertoire de travail avec le repository
|
|
|
|
|
|
(bien s<>r, si un fichier de votre r<>pertoire est plus r<>cent que la
|
|
|
|
|
|
version du repository, il n'y a pas de moficiation). Faites sans
|
|
|
|
|
|
danger<EFBFBD>:
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web $</span><3E>cvstuteurs update
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
Il arrive souvent que <code>cvs</code> vous demande de faire cette
|
2002-11-13 17:13:49 +01:00
|
|
|
|
manœuvre avant de faire un commit (i.e. de prendre en compte vos
|
2002-11-11 10:13:36 +01:00
|
|
|
|
modifications).
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li>Pour commencer <20> travailler sur ce nouveau fichier, faites<65>:<br />
|
|
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web $</span><3E>cd unix
|
2004-02-11 23:34:48 +01:00
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web/unix $</span> tmltemplate accents.tml <em>"titre court"</em><3E><em>"titre long"</em><3E>
|
|
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web/unix $</span><3E>cvstuteurs add accents.tml
|
2002-11-11 10:13:36 +01:00
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web/unix $</span><3E>vim accents.tml
|
|
|
|
|
|
</pre>
|
2004-02-11 23:34:48 +01:00
|
|
|
|
La troisi<73>me commande permet de dire <20> <code>cvs</code> que vous pr<70>parez
|
|
|
|
|
|
un fichier <code>unix/accents.tml</code>, il faut que ce fichier existe
|
|
|
|
|
|
avant de lancer cette commande, c'est <20> cela que sert le script
|
|
|
|
|
|
<code>tmltemplate</code>.
|
|
|
|
|
|
Le <em>titre court</em> est celui qui appara<72>tra dans l'arborescence du
|
|
|
|
|
|
site <20> gauche des pages, le <em>titre long</em> sera <20>crit en gros en
|
|
|
|
|
|
haut de la page.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
<EFBFBD>crivez le contenu de la page Web, c'est-<2D>-dire dans ce cas en mettant <20>
|
|
|
|
|
|
jour la page figurant sur l'ancien site et en le rendant conforme au
|
|
|
|
|
|
standard XHTML 1.0 Strict.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
2002-12-06 18:19:11 +01:00
|
|
|
|
<li>
|
|
|
|
|
|
V<EFBFBD>rifiez votre page avec <code>tmlcheck accents.tml</code>. La commande
|
|
|
|
|
|
<code>tmlcheck</code> est un peu plus stricte que build. S'il y a des
|
|
|
|
|
|
erreurs d'<27>quilibrage entre les balises ouvrantes et fermantes, il peut <20>tre
|
|
|
|
|
|
difficile de trouver la balise ouvrante coupable. Pour <20>a, on peut utiliser
|
|
|
|
|
|
<code>xmlbalance</code>, qui indique la position des balises incrimin<69>es (en
|
|
|
|
|
|
caract<EFBFBD>res, utiliser <code>go</code> avec Vim).
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
2002-11-11 10:13:36 +01:00
|
|
|
|
<li>
|
|
|
|
|
|
Lancez le script de conversion en <code>.html</code> en faisant
|
|
|
|
|
|
<code>:!<21>build<6C>accents.tml</code>.
|
|
|
|
|
|
Notez que si d'autres fichiers <code>tml</code> se trouvent dans le
|
|
|
|
|
|
r<EFBFBD>pertoire courant, leur syntaxe sera aussi v<>rifi<66>e (pour cr<63>er
|
|
|
|
|
|
l'arborescence dans <code>accents.tml</code>).
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Corrigez les fautes de syntaxe.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li>Si vous avez fait beaucoup de modifications, il peut <20>tre utile de
|
|
|
|
|
|
faire<EFBFBD>:
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web $</span><3E>rebuild .
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Passer la page que vous venez de cr<63>er au <a
|
|
|
|
|
|
href="http://validator.w3.org/">validateur</a>. Pour cela, il peut <20>tre
|
|
|
|
|
|
pratique de faire un lien symbolique permettant d'acc<63>der par le Web <20>
|
|
|
|
|
|
votre r<>pertoire de travail<69>:<br />
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">bireme ~/www</span><3E>ln -s ../tuteurs/cvs/web<65>tuteurs
|
|
|
|
|
|
</pre>
|
2003-12-12 13:17:47 +01:00
|
|
|
|
Cependant, il faudrait <20>viter que votre copie de travail se retrouve
|
|
|
|
|
|
r<EFBFBD>pertori<EFBFBD>e dans un moteur de recherche comme Google par exemple (cela
|
|
|
|
|
|
pourrait arriver si vous cliquez sur un lien depuis votre page). Donc,
|
|
|
|
|
|
essayez d'utiliser un fichier <a
|
|
|
|
|
|
href="&url.tuteurs;internet/web/htaccess.html"><code>.htaccess</code></a>
|
|
|
|
|
|
adapt<EFBFBD> pour limiter l'acc<63>s <20> votre copie du site depuis l'ext<78>rieur.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</li>
|
|
|
|
|
|
|
2002-12-21 07:11:47 +01:00
|
|
|
|
<li>
|
2003-12-12 13:17:47 +01:00
|
|
|
|
Un d<>mon mensuel fait une liste des liens cass<73>s sur le site, tenez-en
|
|
|
|
|
|
compte.
|
2002-12-21 07:11:47 +01:00
|
|
|
|
</li>
|
|
|
|
|
|
|
2002-11-11 10:13:36 +01:00
|
|
|
|
<li><a name="makeinstall"/>
|
|
|
|
|
|
Quand tout est au point, vous pouvez <20><>commiter<65><72> en faisant<6E>:
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">bireme ~/tuteurs/cvs/web $</span><3E>make install
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
|
|
Pour information, voici le contenu du <code>Makefile</code>
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
install:
|
|
|
|
|
|
cvstuteurs commit
|
|
|
|
|
|
su-tuteurs cvstuteurs update -d /users/staffs/tuteurs/www/web
|
|
|
|
|
|
su-tuteurs /users/staffs/tuteurs/share/tml/bin/rebuild /users/staffs/tuteurs/www/web
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
La premi<6D>re ligne int<6E>ressante met <20> jour le repository compte tenu de
|
|
|
|
|
|
vos modifications et cr<63>ations. La deuxi<78>me met <20> jour met <20> jour entre
|
|
|
|
|
|
autres les fichiers <code>tml</code> de la page Web en fonction du
|
|
|
|
|
|
repository nouveau et la troisi<73>me ligne met <20> jour les fichiers
|
|
|
|
|
|
<code>html</code> et en cr<63>e <20>ventuellement de nouveaux.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
|
2002-11-11 16:16:22 +01:00
|
|
|
|
<li>
|
|
|
|
|
|
Pendant l'<27>x<EFBFBD>cution de <code>cvstuteurs commit</code>, on vous demande
|
2002-11-11 16:53:58 +01:00
|
|
|
|
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
|
|
|
|
|
|
<pre>Correction d'un probl<62>me important dans foobar.tml</pre>
|
|
|
|
|
|
</li>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</ol>
|
|
|
|
|
|
|
2004-03-08 18:06:30 +01:00
|
|
|
|
<h3>Quelques astuces</h3>
|
|
|
|
|
|
|
|
|
|
|
|
<h4>Ne pas publier une page tout de suite</h4>
|
|
|
|
|
|
|
|
|
|
|
|
<p>Imaginons que vous avez commenc<6E> <20> travailler une nouvelle section du
|
|
|
|
|
|
site, que les pages que vous venez de faire ne soient pas tout-<2D>-fait au
|
|
|
|
|
|
point. Vous pouvez alors d<>cider de ne pas faire appara<72>tre dans un
|
|
|
|
|
|
premier temps vos nouvelles pages dans l'arbre de navigation qui se
|
|
|
|
|
|
trouve sur la gauche des pages.
|
|
|
|
|
|
</p>
|
2002-11-11 17:29:30 +01:00
|
|
|
|
|
|
|
|
|
|
<p>
|
2004-03-08 18:06:30 +01:00
|
|
|
|
Pour cela, le script de g<>n<EFBFBD>ration des pages regarde dans chaque
|
|
|
|
|
|
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
|
|
|
|
|
|
<code>r<>pertoire</code>.
|
2002-11-11 17:29:30 +01:00
|
|
|
|
</p>
|
|
|
|
|
|
|
2004-03-08 18:06:30 +01:00
|
|
|
|
<p>
|
|
|
|
|
|
Par exemple, pour ne pas faire appara<72>tre cette page de documentation
|
|
|
|
|
|
interne aux tuteurs (et quelques autres) dans l'index, la racine du
|
|
|
|
|
|
<code>CVS</code> contient<6E>:
|
|
|
|
|
|
</p>
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<span class="prompt">clipper ~tuteurs/www $</span><3E>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 <20> 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;<3B>Attention<6F>&icone.attention;</h1>
|
|
|
|
|
|
<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
|
|
|
|
|
|
install</code>)<29>;</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<65>n<EFBFBD>ration ne refabriquera pas les
|
|
|
|
|
|
pages et les liens vers les nouvelles pages ne seront pas ins<6E>r<EFBFBD>s.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<h2>Quoi faire<72>?</h2>
|
|
|
|
|
|
|
2002-11-11 17:29:30 +01:00
|
|
|
|
<p>
|
|
|
|
|
|
L'arborescence voulue 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.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
Il est important que ces le fichier <code>00TODO</code> soit mis-<2D>-jour
|
|
|
|
|
|
assez r<>guli<6C>rement.
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
2002-11-11 16:16:22 +01:00
|
|
|
|
<p>Pour finir, voici quelques recommandations concernant la modification du
|
|
|
|
|
|
site Web.</p>
|
|
|
|
|
|
|
2002-11-11 10:13:36 +01:00
|
|
|
|
<div class="attention">
|
|
|
|
|
|
<h1>&icone.attention;<3B><a name="commandements">Les dix commandements de
|
|
|
|
|
|
cvstuteurs/web</a><3E>&icone.attention;</h1>
|
|
|
|
|
|
<ol>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Tu n'utiliseras pas <code>cvs</code> mais <code>cvstuteurs</code>.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Tu ne modifieras jamais directement ce qui se trouve dans
|
|
|
|
|
|
<code>~tuteurs/cvs/</code> et en particulier <code>~tuteurs/cvs/web/</code>.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Tu ne modifieras pas non plus directement <code>~tuteurs/www/web/</code>.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Pour commiter, tu ne feras point <code>cvstuteurs commit</code>,
|
|
|
|
|
|
mais <code>make<6B>install</code> dans la racine de ton r<>pertoire de travail.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Tu ajouteras des fichiers binaires en faisant <code>cvstuteurs add -kb
|
|
|
|
|
|
foobar.png</code>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
De fichiers <code>.gif</code> tu ne cr<63>eras point, parce que c'est <a
|
|
|
|
|
|
href="http://www.gnu.org/philosophy/gif.html">mal</a>.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Tu liras et upgraderas <code>00TODO</code> et <code>00INDEX</code>.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
Des liens relatifs tu utiliseras.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
2002-11-11 16:16:22 +01:00
|
|
|
|
Des commentaires pr<70>cis tu indiqueras lors d'un commit.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</li>
|
2002-12-21 07:11:47 +01:00
|
|
|
|
<li>
|
2004-03-08 17:33:20 +01:00
|
|
|
|
Pour ne point laisser tra<72>ner des liens cass<73>s, tu examineras les logs
|
|
|
|
|
|
du d<>mon v<>rifieur qui se manifeste au d<>but de chaque mois.
|
2002-12-21 07:11:47 +01:00
|
|
|
|
</li>
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</ol>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<p><em>Je vous prie de bien vouloir excuser les anglicismes
|
|
|
|
|
|
scandaleusement pr<70>sents dans cette page.</em></p>
|
|
|
|
|
|
|
|
|
|
|
|
<div class="metainformation">
|
2003-05-24 07:13:12 +02:00
|
|
|
|
Auteur<75>: Jo<4A>l Riou et Nicolas George.
|
2004-06-10 18:05:54 +02:00
|
|
|
|
Derni<EFBFBD>re modification le <date value="$Date: 2004-06-10 16:05:54 $" />.
|
2002-11-11 10:13:36 +01:00
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
