diff options
| author | Vincent Deffontaines <gryzor@apache.org> | 2009-02-08 11:33:15 +0100 |
|---|---|---|
| committer | Vincent Deffontaines <gryzor@apache.org> | 2009-02-08 11:33:15 +0100 |
| commit | a935d10df371323cc727a10ebac82a63482af79f (patch) | |
| tree | 6962b9e3205b8c32c3ece023e2f6966e330e459d /docs/manual/howto | |
| parent | New translation for the public_html howto (diff) | |
| download | apache2-a935d10df371323cc727a10ebac82a63482af79f.tar.xz apache2-a935d10df371323cc727a10ebac82a63482af79f.zip | |
New french translation for the SSI howto
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@742039 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/howto')
| -rw-r--r-- | docs/manual/howto/ssi.html | 4 | ||||
| -rw-r--r-- | docs/manual/howto/ssi.html.en | 2 | ||||
| -rw-r--r-- | docs/manual/howto/ssi.html.fr | 499 | ||||
| -rw-r--r-- | docs/manual/howto/ssi.xml.fr | 501 | ||||
| -rw-r--r-- | docs/manual/howto/ssi.xml.meta | 1 |
5 files changed, 1007 insertions, 0 deletions
diff --git a/docs/manual/howto/ssi.html b/docs/manual/howto/ssi.html index 477d79cad9..9d97ad7250 100644 --- a/docs/manual/howto/ssi.html +++ b/docs/manual/howto/ssi.html @@ -4,6 +4,10 @@ URI: ssi.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: ssi.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: ssi.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/howto/ssi.html.en b/docs/manual/howto/ssi.html.en index 48b9bc9041..b2e8078b28 100644 --- a/docs/manual/howto/ssi.html.en +++ b/docs/manual/howto/ssi.html.en @@ -19,6 +19,7 @@ <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: Introduction to Server Side Includes</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/howto/ssi.html" title="English"> en </a> | +<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -478,6 +479,7 @@ modified?</a></h3> </div></div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/howto/ssi.html" title="English"> en </a> | +<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/howto/ssi.html.fr b/docs/manual/howto/ssi.html.fr new file mode 100644 index 0000000000..5301816eab --- /dev/null +++ b/docs/manual/howto/ssi.html.fr @@ -0,0 +1,499 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Tutoriel Apache : Introduction aux "Inclusions Côté Serveur" +(Server Side Includes - SSI) - Serveur Apache HTTP</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur Apache HTTP Version 2.3</p> +<img alt="" src="../images/feather.gif" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Recettes et tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Tutoriel Apache : Introduction aux "Inclusions Côté Serveur" +(Server Side Includes - SSI)</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/howto/ssi.html" title="Français"> fr </a> | +<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + +<p>Les SSI permettent d'ajouter du contenu dynamique à des documents +HTML préexistants.</p> +</div> +<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Introduction</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#what">Qu'est-ce que SSI ?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configurer votre serveur pour permettre les SSI</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#basic">Directives SSI de base</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#additionalexamples">Exemples additionnels</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#config">Que puis-je configurer d'autre ?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#exec">Exécution de commandes</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#advanced">Techniques SSI avancées</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#conclusion">Conclusion</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="related" id="related">Introduction</a></h2> + <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code></li><li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li><li><code class="directive"><a href="../mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li></ul></td></tr></table> + + <p>Cet article traite des Inclusions Côté Serveur (Server Side + Includes), plus communément appelés SSI. Vous trouverez ici la + manière de configurer votre serveur pour permettre les SSI, ainsi + qu'une introduction à quelques techniques SSI de base permettant + d'ajouter du contenu dynamique à vos pages HTML préexistantes.</p> + + <p>La dernière partie de cet article sera consacrée aux + configurations SSI plus avancées, telles que les expressions + conditionnelles dans les directives SSI.</p> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="what" id="what">Qu'est-ce que SSI ?</a></h2> + + <p>SSI (Server Side Includes) est constitué de directives placées dans + des pages HTML, et évaluées par le serveur au moment où les pages + sont servies. Elles vous permettent d'ajouter du contenu généré + dynamiquement à une page HTML préexistante, sans avoir à servir la + page entière via un programme CGI, ou toute autre technologie de + contenu dynamique.</p> + + <p>Le choix entre l'utilisation des SSI et la génération entière de + la page par un programme quelconque, est en général dicté par la + proportion de contenu statique et de contenu devant être généré + chaque fois que la page est servie. SSI est idéal pour ajouter de + petites quantités d'information, comme l'heure courante. Mais si la + plus grande partie de votre page est générée au moment où elle est + servie, vous devez vous tourner vers une autre solution.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="configuring" id="configuring">Configurer votre serveur pour permettre les SSI</a></h2> + + + <p>Pour permettre l'utilisation des SSI sur votre serveur, vous + devez ajouter la directive suivante dans votre fichier + <code>httpd.conf</code>, ou dans un fichier <code>.htaccess</code> + :</p> +<div class="example"><p><code> + Options +Includes +</code></p></div> + + <p>Cette directive indique à Apache que vous désirez permettre la + recherche de directives SSI lors de l'interprétation des fichiers. + Notez cependant que la plupart des configurations contiennent de + nombreuses directives <code class="directive"><a href="../mod/core.html#options">Options</a></code> + qui peuvent s'écraser les unes les autres. Vous devrez probablement + appliquer ces directives <code>Options</code> au répertoire + spécifique pour lequel vous voulez activer les SSI, afin d'être sûr + qu'elles y seront bien activées.</p> + + <p>Tout fichier ne fera cependant pas l'objet de recherche de + directives SSI. Vous devez indiquer à Apache quels fichiers seront + concernés. Vous pouvez y parvenir en indiquant une extension, comme + <code>.shtml</code>, à l'aide des directives suivantes :</p> +<div class="example"><p><code> + AddType text/html .shtml<br /> + AddOutputFilter INCLUDES .shtml +</code></p></div> + + <p>Un des désavantages de cette approche réside dans le fait que si + vous voulez ajouter des directives SSI à une page préexistante, vous + devrez changer le nom de cette page, et donc tout lien qui la + contient, de façon à ce qu'elle possède l'extension + <code>.shtml</code>, condition nécessaire pour que les directives + SSI qu'elle contient soient traitées.</p> + + <p>Une autre méthode consiste à utiliser la directive <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code> :</p> +<div class="example"><p><code> + XBitHack on +</code></p></div> + + <p>La directive <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code> + indique à Apache qu'il doit rechercher des directivves SSI dans les + fichiers si leur bit d'exécution est positionné. Il n'est ainsi plus + nécessaire de changer le nom du fichier pour ajouter des directives + SSI à une page préexistante ; vous devez simplement attribuer les + droits d'exécution au fichier à l'aide de <code>chmod</code>.</p> +<div class="example"><p><code> + chmod +x pagename.html +</code></p></div> + + <p>Un bref commentaire sur ce qu'il ne faut pas faire. Certaines + personnes peuvent vous conseiller de tout simplement indiquer à + Apache de rechercher des directives SSI dans tous les fichiers + <code>.html</code>, ce qui vous évite d'avoir à gérer les noms de + fichiers avec extension <code>.shtml</code>. Ils n'ont probablement + pas entendu parler de la directive <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>. En effet, vous devez + garder à l'esprit qu'en faisant ceci, Apache va devoir rechercher + des directives SSI dans chaque fichier qu'il sert, même s'il n'en + contient aucune. Ce n'est donc pas une bonne idée car les + performances peuvent en être sensiblement affectées.</p> + + <p>Bien entendu, sous Windows, il n'y a pas de bit d'exécution à + positionner, ce qui limite un peu vos choix.</p> + + <p>Dans sa configuration par défaut, Apache n'envoie pas la date de + dernière modification ou les en-têtes HTTP relatifs à la taille des + contenus dans les pages SSI, car ses valeurs sont difficiles à + calculer pour les contenus dynamiques. Ceci peut induire une + impression de diminution des performances côté client, en empêchant + la mise en cache de votre document. Il existe deux méthodes pour + résoudre ce problème :</p> + + <ol> + <li>Utilisez la configuration <code>XBitHack Full</code>. Elle + indique à Apache de déterminer la date de dernière modification en + ne regardant que la date du fichier à l'origine de la requête, + tout en ignorant la date de modification de tout fichier inclus.</li> + + <li>Utilisez les directives fournies par le module + <code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> pour définir de manière explicite la + date d'expiration de vos fichiers, laissant par la-même + aux navigateurs et aux mandataires le soin de déterminer s'il est + opportun ou non de les mettre en cache.</li> + </ol> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="basic" id="basic">Directives SSI de base</a></h2> + + <p>Les directives SSI adoptent la syntaxe suivante :</p> +<div class="example"><p><code> + <!--#élément attribut=valeur attribut=valeur ... --> +</code></p></div> + + <p>Le format d'une directive SSI étant similaire à celui d'un + commentaire HTML, si vous n'avez pas activé correctement SSI, le + navigateur l'ignorera, mais elle sera encore visible dans le source + HTML. Si SSI est correctement configuré, la directive sera remplacée + par ses résultats.</p> + + <p>"élément" peut prendre de nombreuses formes, et nous décrirons + plus précisément la plupart d'entre eux dans la prochaine version de + ce document. Pour le moment, voici quelques exemples de ce que vous + pouvez faire avec SSI.</p> + +<h3><a name="todaysdate" id="todaysdate">La date courante</a></h3> + +<div class="example"><p><code> + <!--#echo var="DATE_LOCAL" --> +</code></p></div> + + <p>L'élément <code>echo</code> permet d'afficher la valeur d'une + variable. Il existe un grand nombre de variables standards, y + compris l'ensemble des variables d'environnement disponibles pour + les programmes CGI. De plus, vous pouvez définir vos propres + variables à l'aide de l'élément <code>set</code>.</p> + + <p>Si vous n'aimez pas le format sous lequel la date s'affiche, vous + pouvez utiliser l'élément <code>config</code> avec un attribut + <code>timefmt</code>, pour le modifier.</p> + +<div class="example"><p><code> + <!--#config timefmt="%A %B %d, %Y" --><br /> + Today is <!--#echo var="DATE_LOCAL" --> +</code></p></div> + + +<h3><a name="lastmodified" id="lastmodified">Date de modification du fichier</a></h3> + +<div class="example"><p><code> + Dernière modification du document <!--#flastmod file="index.html" --> +</code></p></div> + + <p>Le format peut là aussi être modifié à l'aide de l'attribut + <code>timefmt</code>.</p> + + +<h3><a name="cgi" id="cgi">Inclusion des résultats d'un programme CGI</a></h3> + + <p>C'est le cas le plus courant d'utilisation des SSI - afficher les + résultats d'un programme CGI, comme l'universellement adoré + "compteur d'accès".</p> + +<div class="example"><p><code> + <!--#include virtual="/cgi-bin/counter.pl" --> +</code></p></div> + + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="additionalexamples" id="additionalexamples">Exemples additionnels</a></h2> + + + <p>Vous trouverez dans ce qui suit quelques exemples spécifiques de + ce que vous pouvez faire de vos documents HTML avec SSI.</p> + +<h3><a name="docmodified" id="docmodified">Quand ce document a-t-il été modifié ?</a></h3> + + <p>Nous avons mentionné plus haut que vous pouviez utiliser SSI pour + informer l'utilisateur de la date de dernière modification du + document. Cependant, la méthode pour y parvenir n'a pas été vraiment + abordée. Placé dans votre document HTML, le code suivant va insérer + un repère de temps dans votre page. Bien entendu, SSI devra avoir + été correctement activé, comme décrit plus haut.</p> +<div class="example"><p><code> + <!--#config timefmt="%A %B %d, %Y" --><br /> + Dernière modification du fichier <!--#flastmod file="ssi.shtml" --> +</code></p></div> + + <p>Bien entendu, vous devez remplacer <code>ssi.shtml</code> par le + nom du fichier auquel vous faites référence. Ceci ne conviendra pas + si vous recherchez un morceau de code générique que vous pourrez + insérer dans tout fichier ; dans ce cas, il est préférable + d'utiliser la variable <code>LAST_MODIFIED</code> :</p> +<div class="example"><p><code> + <!--#config timefmt="%D" --><br /> + This file last modified <!--#echo var="LAST_MODIFIED" --> +</code></p></div> + + <p>Pour plus de détails sur le format <code>timefmt</code>, tapez + <code>strftime</code> dans votre moteur de recherche préferé. La + syntaxe est identique.</p> + + +<h3><a name="standard-footer" id="standard-footer">Inclusion d'un pied de page standard</a></h3> + + + <p>Si le site que vous gérez comporte plus que quelques pages, vous + allez vite vous apercevoir qu'effectuer des modifications sur toutes + ces pages peut devenir très contraignant, en particulier si vous + voulez qu'elles conservent un aspect homogène.</p> + + <p>Inclure un fichier pour un en-tête et/ou un pied de page peut + simplifier cette corvée de mises à jour. Il vous suffit de + confectionner un fichier de pied de page, et de l'inclure dans + chaque page à l'aide de l'élément SSI <code>include</code>. Pour + définir le fichier à inclure, l'élément <code>include</code> peut + utiliser soit l'attribut <code>file</code>, soit l'attribut + <code>virtual</code>. L'attribut <code>file</code> est un chemin de + fichier <em>relatif au répertoire courant</em>. C'est à dire qu'il + ne peut ni avoir pour valeur un chemin absolu (commençant par /), ni + comporter "../" dans son chemin. L'attribut <code>virtual</code> est + probablement plus commode, et peut spécifier une URL relative au + document servi. Elle peut commencer par un /, mais le fichier inclus + et le fichier servi doivent résider sur le même serveur.</p> +<div class="example"><p><code> + <!--#include virtual="/footer.html" --> +</code></p></div> + + <p>Je combinerai souvent ces deux derniers points, en ajoutant une + directive <code>LAST_MODIFIED</code> dans un fichier de pied de page + destiné à être inclus. Le fichier inclus peut contenir des + directives SSI, et les inclusions peuvent être imbriquées - à + savoir, le fichier inclus peut inclure un autre fichier, etc...</p> + + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="config" id="config">Que puis-je configurer d'autre ?</a></h2> + + + <p>En plus du format de date, vous pouvez utiliser l'élément + <code>config</code> pour configurer deux autres choses.</p> + + <p>En général, lorsque quelque chose se passe mal avec votre + directive SSI, vous recevez le message :</p> +<div class="example"><p><code> + [an error occurred while processing this directive] +</code></p></div> + + <p>Pour modifier ce message, vous pouvez utiliser l'attribut + <code>errmsg</code> avec l'élément <code>config</code> :</p> +<div class="example"><p><code> + <!--#config errmsg="[Il semblerait que vous ne sachiez pas + utiliser les SSI]" --> +</code></p></div> + + <p>Il est cependant probable que les utilisateurs finaux ne voient + jamais ce message, car vous aurez résolu tous les problèmes issus de + vos directives SSI avant que votre site ne soit mis en production. + (N'est-ce pas ?)</p> + + <p>Vous pouvez aussi modifier le format sous lequel les tailles de + fichiers sont affichées à l'aide de l'attribut <code>sizefmt</code>. + Vous pouvez spécifier <code>bytes</code> pour un affichage en + octets, ou <code>abbrev</code> pour un affichage plus concis en Ko + ou Mo, selon le cas.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="exec" id="exec">Exécution de commandes</a></h2> + + + <p>J'ai pour projet, dans les prochains mois, d'écrire un article à + propos de l'utilisation des SSI avec des petits programmes CGI. Pour + l'instant, voici ce que vous pouvez faire avec l'élément + <code>exec</code>. Vous pouvez vraiment faire exécuter une commande + par SSI en utilisant le shell (<code>/bin/sh</code>, pour être plus + précis - ou le shell DOS, si vous êtes sous Win32). Par exemple, ce + qui suit vous permet d'afficher le contenu d'un répertoire.</p> +<div class="example"><p><code> + <pre><br /> + <!--#exec cmd="ls" --><br /> + </pre> +</code></p></div> + + <p>ou, sous Windows</p> +<div class="example"><p><code> + <pre><br /> + <!--#exec cmd="dir" --><br /> + </pre> +</code></p></div> + + <p>Vous noterez probablement l'étrange formatage provoqué par cette + directive sous Windows, car la sortie de <code>dir</code> contient + la chaîne de caractères "<<code>dir</code>>", ce qui trompe le + navigateur.</p> + + <p>Notez que cette fonctionnalité est très dangereuse, car elle va + permettre d'exécuter tout code associé à l'élément + <code>exec</code>. Si vous êtes dans la situation où les + utilisateurs peuvent éditer le contenu de vos pages web, dans le cas + d'un "livre d'or" par exemple, assurez-vous de désactiver cette + fonctionnalité. Vous pouvez, tout en permettant les SSI, désactiver + la fonctionnalité <code>exec</code> à l'aide de l'argument + <code>IncludesNOEXEC</code> de la directive + <code>Options</code>.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="advanced" id="advanced">Techniques SSI avancées</a></h2> + + + <p>Outre l'affichage de contenu, les SSI d'Apache vous permettent de + définir des variables, et de les utiliser dans des comparaisons et + des conditions.</p> + +<h3><a name="caveat" id="caveat">Mise en garde</a></h3> + + <p>La plupart des fonctionnalités décrites dans cet article ne sont + disponibles que si vous utilisez la version 1.2 ou supérieure + d'Apache. Bien entendu, si ce n'est pas le cas, vous devez faire une + mise à jour immédiatement, et même plus tôt. Allez-y. Faites-le + maintenant. Nous attendrons.</p> + + +<h3><a name="variables" id="variables">Définition de variables</a></h3> + + <p>Avec l'élément <code>set</code>, vous pouvez définir des + variables pour un usage ultérieur. Comme nous en aurons besoin plus + loin, nous allons en parler tout de suite. La syntaxe se présente + comme suit :</p> +<div class="example"><p><code> + <!--#set var="name" value="Rich" --> +</code></p></div> + + <p>Pour affecter une valeur à vos variables, en plus de la + définition littérale de l'exemple ci-dessus, vous pouvez utiliser + une autre variable, y compris les <a href="../env.html">variables d'environnement</a>, ou les variables + décrites plus haut (comme <code>LAST_MODIFIED</code> par exemple). + Pour indiquer qu'il s'agit d'une variable et non d'une chaîne, vous + devez utiliser le symbole dollar ($) devant le nom de la + variable.</p> + + <div class="example"><p><code> <!--#set var="modified" value="$LAST_MODIFIED" --> + </code></p></div> + + <p>Pour insérer un caractère $ dans la valeur de votre variable, + vous devez l'échapper à l'aide d'un backslash.</p> +<div class="example"><p><code> + <!--#set var="cost" value="\$100" --> +</code></p></div> + + <p>Enfin, si vous voulez insérer une variable dans une chaîne, et + s'il y a une chance pour que le nom de la variable se confonde avec + le reste de la chaîne, vous pouvez l'entourer d'accolades pour + eviter toute confusion (Il est difficile de trouver un bon exemple + pour illustrer ceci, mais j'espère que vous comprendrez).</p> +<div class="example"><p><code> + <!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" --> +</code></p></div> + + +<h3><a name="conditional" id="conditional">Expressions conditionnelles</a></h3> + + + <p>Maintenent que nous avons des variables, et que nous pouvons + définir et comparer leurs valeurs, nous sommes à même de les + utiliser dans des expressions conditionnelles. Ceci confère à SSI le + statut de petit langage de programmation. + <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> fournit une structure <code>if</code>, + <code>elif</code>, <code>else</code>, <code>endif</code> pour la + construction d'expressions conditionnelles, ce qui vous permet de + générer plusieurs pages logiques à partir d'une seule vraie + page.</p> + + <p>La structure de l'expression conditionnelle est :</p> +<div class="example"><p><code> + <!--#if expr="condition" --><br /> + <!--#elif expr="condition" --><br /> + <!--#else --><br /> + <!--#endif --> +</code></p></div> + + <p>Une <em>condition</em> peut revêtir la forme de toute comparaison + logique - soit une comparaison de valeurs avec une autre, soit une + vérification de la "vérité" d'une valeur particulière (Une chaîne + donnée est vraie si elle n'est pas vide). Pour une liste exhaustive + des opérateurs de comparaison disponibles, voir la documentation du + module <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>. Voici quelques exemples + illustrant l'utilisation de ces expressions.</p> + + <p>Vous pouvez ajouter les lignes suivantes dans votre fichier de + configuration :</p> +<div class="example"><p><code> + BrowserMatchNoCase macintosh Mac<br /> + BrowserMatchNoCase MSIE InternetExplorer +</code></p></div> + + <p>Ces lignes définissent les variables d'environnement "Mac" et + "InternetExplorer" à true, si le client utilise InternetExplorer sur + un Macintosh.</p> + + <p>Puis, dans votre document où les SSI sont activées, vous ajoutez + ceci :</p> +<div class="example"><p><code> + <!--#if expr="${Mac} && ${InternetExplorer}" --><br /> + Un texte d'excuses est inséré ici<br /> + <!--#else --><br /> + Ici se trouve du code JavaScipt sympa<br /> + <!--#endif --> +</code></p></div> + + <p>Notez que je n'ai rien contre IE sur Macintosh - J'ai juste + phosphoré quelques heures la semaine dernière pour faire fonctionner + du JavaScript sous IE sur Macintosh, alors qu'il fonctionnait sous + tout autre environnement. Ce qui précède a constitué un + contournement provisoire.</p> + + <p>Toute autre variable (que vous avez définie, ou une variable + d'environnement normale) peut être utilisée dans les expressions + conditionnelles. Associée à la possibilité avec Apache de définir + des variables d'environnement à l'aide de directives + <code>SetEnvIf</code>, ainsi que d'autres directives en rapport, + cette fonctionnalité vous permet d'ajouter des contenus dynamiques + assez évolués sans avoir recours aux programmes CGI.</p> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="conclusion" id="conclusion">Conclusion</a></h2> + + <p>SSI ne remplace certainement pas CGI, ou d'autres technologies + utilisées pour la génération de pages web dynamiques. Mais c'est une + bonne méthode pour ajouter des petits contenus dynamiques à vos + pages, sans devoir fournir un gros effort supplémentaire.</p> +</div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/howto/ssi.html" title="Français"> fr </a> | +<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Authorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/howto/ssi.xml.fr b/docs/manual/howto/ssi.xml.fr new file mode 100644 index 0000000000..68c5075c10 --- /dev/null +++ b/docs/manual/howto/ssi.xml.fr @@ -0,0 +1,501 @@ +<?xml version="1.0" encoding="ISO-8859-1" ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 659902 --> +<!-- French translation : Lucien GENTIS --> +<!-- Reviewed by : Vincent Deffontaines --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<manualpage metafile="ssi.xml.meta"> +<parentdocument href="./">Recettes et tutoriels</parentdocument> + +<title>Tutoriel Apache : Introduction aux "Inclusions Côté Serveur" +(Server Side Includes - SSI)</title> + +<summary> +<p>Les SSI permettent d'ajouter du contenu dynamique à des documents +HTML préexistants.</p> +</summary> + +<section id="related"><title>Introduction</title> + <related> + <modulelist> + <module>mod_include</module> + <module>mod_cgi</module> + <module>mod_expires</module> + </modulelist> + + <directivelist> + <directive module="core">Options</directive> + <directive module="mod_include">XBitHack</directive> + <directive module="mod_mime">AddType</directive> + <directive module="core">SetOutputFilter</directive> + <directive module="mod_setenvif">BrowserMatchNoCase</directive> + </directivelist> +</related> + + <p>Cet article traite des Inclusions Côté Serveur (Server Side + Includes), plus communément appelés SSI. Vous trouverez ici la + manière de configurer votre serveur pour permettre les SSI, ainsi + qu'une introduction à quelques techniques SSI de base permettant + d'ajouter du contenu dynamique à vos pages HTML préexistantes.</p> + + <p>La dernière partie de cet article sera consacrée aux + configurations SSI plus avancées, telles que les expressions + conditionnelles dans les directives SSI.</p> + +</section> + +<section id="what"><title>Qu'est-ce que SSI ?</title> + + <p>SSI (Server Side Includes) est constitué de directives placées dans + des pages HTML, et évaluées par le serveur au moment où les pages + sont servies. Elles vous permettent d'ajouter du contenu généré + dynamiquement à une page HTML préexistante, sans avoir à servir la + page entière via un programme CGI, ou toute autre technologie de + contenu dynamique.</p> + + <p>Le choix entre l'utilisation des SSI et la génération entière de + la page par un programme quelconque, est en général dicté par la + proportion de contenu statique et de contenu devant être généré + chaque fois que la page est servie. SSI est idéal pour ajouter de + petites quantités d'information, comme l'heure courante. Mais si la + plus grande partie de votre page est générée au moment où elle est + servie, vous devez vous tourner vers une autre solution.</p> +</section> + +<section id="configuring"> +<title>Configurer votre serveur pour permettre les SSI</title> + + <p>Pour permettre l'utilisation des SSI sur votre serveur, vous + devez ajouter la directive suivante dans votre fichier + <code>httpd.conf</code>, ou dans un fichier <code>.htaccess</code> + :</p> +<example> + Options +Includes +</example> + + <p>Cette directive indique à Apache que vous désirez permettre la + recherche de directives SSI lors de l'interprétation des fichiers. + Notez cependant que la plupart des configurations contiennent de + nombreuses directives <directive module="core">Options</directive> + qui peuvent s'écraser les unes les autres. Vous devrez probablement + appliquer ces directives <code>Options</code> au répertoire + spécifique pour lequel vous voulez activer les SSI, afin d'être sûr + qu'elles y seront bien activées.</p> + + <p>Tout fichier ne fera cependant pas l'objet de recherche de + directives SSI. Vous devez indiquer à Apache quels fichiers seront + concernés. Vous pouvez y parvenir en indiquant une extension, comme + <code>.shtml</code>, à l'aide des directives suivantes :</p> +<example> + AddType text/html .shtml<br /> + AddOutputFilter INCLUDES .shtml +</example> + + <p>Un des désavantages de cette approche réside dans le fait que si + vous voulez ajouter des directives SSI à une page préexistante, vous + devrez changer le nom de cette page, et donc tout lien qui la + contient, de façon à ce qu'elle possède l'extension + <code>.shtml</code>, condition nécessaire pour que les directives + SSI qu'elle contient soient traitées.</p> + + <p>Une autre méthode consiste à utiliser la directive <directive + module="mod_include">XBitHack</directive> :</p> +<example> + XBitHack on +</example> + + <p>La directive <directive module="mod_include">XBitHack</directive> + indique à Apache qu'il doit rechercher des directivves SSI dans les + fichiers si leur bit d'exécution est positionné. Il n'est ainsi plus + nécessaire de changer le nom du fichier pour ajouter des directives + SSI à une page préexistante ; vous devez simplement attribuer les + droits d'exécution au fichier à l'aide de <code>chmod</code>.</p> +<example> + chmod +x pagename.html +</example> + + <p>Un bref commentaire sur ce qu'il ne faut pas faire. Certaines + personnes peuvent vous conseiller de tout simplement indiquer à + Apache de rechercher des directives SSI dans tous les fichiers + <code>.html</code>, ce qui vous évite d'avoir à gérer les noms de + fichiers avec extension <code>.shtml</code>. Ils n'ont probablement + pas entendu parler de la directive <directive + module="mod_include">XBitHack</directive>. En effet, vous devez + garder à l'esprit qu'en faisant ceci, Apache va devoir rechercher + des directives SSI dans chaque fichier qu'il sert, même s'il n'en + contient aucune. Ce n'est donc pas une bonne idée car les + performances peuvent en être sensiblement affectées.</p> + + <p>Bien entendu, sous Windows, il n'y a pas de bit d'exécution à + positionner, ce qui limite un peu vos choix.</p> + + <p>Dans sa configuration par défaut, Apache n'envoie pas la date de + dernière modification ou les en-têtes HTTP relatifs à la taille des + contenus dans les pages SSI, car ses valeurs sont difficiles à + calculer pour les contenus dynamiques. Ceci peut induire une + impression de diminution des performances côté client, en empêchant + la mise en cache de votre document. Il existe deux méthodes pour + résoudre ce problème :</p> + + <ol> + <li>Utilisez la configuration <code>XBitHack Full</code>. Elle + indique à Apache de déterminer la date de dernière modification en + ne regardant que la date du fichier à l'origine de la requête, + tout en ignorant la date de modification de tout fichier inclus.</li> + + <li>Utilisez les directives fournies par le module + <module>mod_expires</module> pour définir de manière explicite la + date d'expiration de vos fichiers, laissant par la-même + aux navigateurs et aux mandataires le soin de déterminer s'il est + opportun ou non de les mettre en cache.</li> + </ol> +</section> + +<section id="basic"><title>Directives SSI de base</title> + + <p>Les directives SSI adoptent la syntaxe suivante :</p> +<example> + <!--#élément attribut=valeur attribut=valeur ... --> +</example> + + <p>Le format d'une directive SSI étant similaire à celui d'un + commentaire HTML, si vous n'avez pas activé correctement SSI, le + navigateur l'ignorera, mais elle sera encore visible dans le source + HTML. Si SSI est correctement configuré, la directive sera remplacée + par ses résultats.</p> + + <p>"élément" peut prendre de nombreuses formes, et nous décrirons + plus précisément la plupart d'entre eux dans la prochaine version de + ce document. Pour le moment, voici quelques exemples de ce que vous + pouvez faire avec SSI.</p> + +<section id="todaysdate"><title>La date courante</title> + +<example> + <!--#echo var="DATE_LOCAL" --> +</example> + + <p>L'élément <code>echo</code> permet d'afficher la valeur d'une + variable. Il existe un grand nombre de variables standards, y + compris l'ensemble des variables d'environnement disponibles pour + les programmes CGI. De plus, vous pouvez définir vos propres + variables à l'aide de l'élément <code>set</code>.</p> + + <p>Si vous n'aimez pas le format sous lequel la date s'affiche, vous + pouvez utiliser l'élément <code>config</code> avec un attribut + <code>timefmt</code>, pour le modifier.</p> + +<example> + <!--#config timefmt="%A %B %d, %Y" --><br /> + Today is <!--#echo var="DATE_LOCAL" --> +</example> +</section> + +<section id="lastmodified"><title>Date de modification du fichier</title> + +<example> + Dernière modification du document <!--#flastmod file="index.html" --> +</example> + + <p>Le format peut là aussi être modifié à l'aide de l'attribut + <code>timefmt</code>.</p> +</section> + +<section id="cgi"><title>Inclusion des résultats d'un programme CGI</title> + + <p>C'est le cas le plus courant d'utilisation des SSI - afficher les + résultats d'un programme CGI, comme l'universellement adoré + "compteur d'accès".</p> + +<example> + <!--#include virtual="/cgi-bin/counter.pl" --> +</example> + +</section> +</section> + +<section id="additionalexamples"> +<title>Exemples additionnels</title> + + <p>Vous trouverez dans ce qui suit quelques exemples spécifiques de + ce que vous pouvez faire de vos documents HTML avec SSI.</p> + +<section id="docmodified"><title>Quand ce document a-t-il été modifié ?</title> + + <p>Nous avons mentionné plus haut que vous pouviez utiliser SSI pour + informer l'utilisateur de la date de dernière modification du + document. Cependant, la méthode pour y parvenir n'a pas été vraiment + abordée. Placé dans votre document HTML, le code suivant va insérer + un repère de temps dans votre page. Bien entendu, SSI devra avoir + été correctement activé, comme décrit plus haut.</p> +<example> + <!--#config timefmt="%A %B %d, %Y" --><br /> + Dernière modification du fichier <!--#flastmod file="ssi.shtml" --> +</example> + + <p>Bien entendu, vous devez remplacer <code>ssi.shtml</code> par le + nom du fichier auquel vous faites référence. Ceci ne conviendra pas + si vous recherchez un morceau de code générique que vous pourrez + insérer dans tout fichier ; dans ce cas, il est préférable + d'utiliser la variable <code>LAST_MODIFIED</code> :</p> +<example> + <!--#config timefmt="%D" --><br /> + This file last modified <!--#echo var="LAST_MODIFIED" --> +</example> + + <p>Pour plus de détails sur le format <code>timefmt</code>, tapez + <code>strftime</code> dans votre moteur de recherche préferé. La + syntaxe est identique.</p> +</section> + +<section id="standard-footer"> +<title>Inclusion d'un pied de page standard</title> + + <p>Si le site que vous gérez comporte plus que quelques pages, vous + allez vite vous apercevoir qu'effectuer des modifications sur toutes + ces pages peut devenir très contraignant, en particulier si vous + voulez qu'elles conservent un aspect homogène.</p> + + <p>Inclure un fichier pour un en-tête et/ou un pied de page peut + simplifier cette corvée de mises à jour. Il vous suffit de + confectionner un fichier de pied de page, et de l'inclure dans + chaque page à l'aide de l'élément SSI <code>include</code>. Pour + définir le fichier à inclure, l'élément <code>include</code> peut + utiliser soit l'attribut <code>file</code>, soit l'attribut + <code>virtual</code>. L'attribut <code>file</code> est un chemin de + fichier <em>relatif au répertoire courant</em>. C'est à dire qu'il + ne peut ni avoir pour valeur un chemin absolu (commençant par /), ni + comporter "../" dans son chemin. L'attribut <code>virtual</code> est + probablement plus commode, et peut spécifier une URL relative au + document servi. Elle peut commencer par un /, mais le fichier inclus + et le fichier servi doivent résider sur le même serveur.</p> +<example> + <!--#include virtual="/footer.html" --> +</example> + + <p>Je combinerai souvent ces deux derniers points, en ajoutant une + directive <code>LAST_MODIFIED</code> dans un fichier de pied de page + destiné à être inclus. Le fichier inclus peut contenir des + directives SSI, et les inclusions peuvent être imbriquées - à + savoir, le fichier inclus peut inclure un autre fichier, etc...</p> +</section> + +</section> + +<section id="config"> +<title>Que puis-je configurer d'autre ?</title> + + <p>En plus du format de date, vous pouvez utiliser l'élément + <code>config</code> pour configurer deux autres choses.</p> + + <p>En général, lorsque quelque chose se passe mal avec votre + directive SSI, vous recevez le message :</p> +<example> + [an error occurred while processing this directive] +</example> + + <p>Pour modifier ce message, vous pouvez utiliser l'attribut + <code>errmsg</code> avec l'élément <code>config</code> :</p> +<example> + <!--#config errmsg="[Il semblerait que vous ne sachiez pas + utiliser les SSI]" --> +</example> + + <p>Il est cependant probable que les utilisateurs finaux ne voient + jamais ce message, car vous aurez résolu tous les problèmes issus de + vos directives SSI avant que votre site ne soit mis en production. + (N'est-ce pas ?)</p> + + <p>Vous pouvez aussi modifier le format sous lequel les tailles de + fichiers sont affichées à l'aide de l'attribut <code>sizefmt</code>. + Vous pouvez spécifier <code>bytes</code> pour un affichage en + octets, ou <code>abbrev</code> pour un affichage plus concis en Ko + ou Mo, selon le cas.</p> + </section> + +<section id="exec"> + <title>Exécution de commandes</title> + + <p>J'ai pour projet, dans les prochains mois, d'écrire un article à + propos de l'utilisation des SSI avec des petits programmes CGI. Pour + l'instant, voici ce que vous pouvez faire avec l'élément + <code>exec</code>. Vous pouvez vraiment faire exécuter une commande + par SSI en utilisant le shell (<code>/bin/sh</code>, pour être plus + précis - ou le shell DOS, si vous êtes sous Win32). Par exemple, ce + qui suit vous permet d'afficher le contenu d'un répertoire.</p> +<example> + <pre><br /> + <!--#exec cmd="ls" --><br /> + </pre> +</example> + + <p>ou, sous Windows</p> +<example> + <pre><br /> + <!--#exec cmd="dir" --><br /> + </pre> +</example> + + <p>Vous noterez probablement l'étrange formatage provoqué par cette + directive sous Windows, car la sortie de <code>dir</code> contient + la chaîne de caractères "<<code>dir</code>>", ce qui trompe le + navigateur.</p> + + <p>Notez que cette fonctionnalité est très dangereuse, car elle va + permettre d'exécuter tout code associé à l'élément + <code>exec</code>. Si vous êtes dans la situation où les + utilisateurs peuvent éditer le contenu de vos pages web, dans le cas + d'un "livre d'or" par exemple, assurez-vous de désactiver cette + fonctionnalité. Vous pouvez, tout en permettant les SSI, désactiver + la fonctionnalité <code>exec</code> à l'aide de l'argument + <code>IncludesNOEXEC</code> de la directive + <code>Options</code>.</p> + </section> + +<section id="advanced"> +<title>Techniques SSI avancées</title> + + <p>Outre l'affichage de contenu, les SSI d'Apache vous permettent de + définir des variables, et de les utiliser dans des comparaisons et + des conditions.</p> + +<section id="caveat"><title>Mise en garde</title> + + <p>La plupart des fonctionnalités décrites dans cet article ne sont + disponibles que si vous utilisez la version 1.2 ou supérieure + d'Apache. Bien entendu, si ce n'est pas le cas, vous devez faire une + mise à jour immédiatement, et même plus tôt. Allez-y. Faites-le + maintenant. Nous attendrons.</p> +</section> + +<section id="variables"><title>Définition de variables</title> + + <p>Avec l'élément <code>set</code>, vous pouvez définir des + variables pour un usage ultérieur. Comme nous en aurons besoin plus + loin, nous allons en parler tout de suite. La syntaxe se présente + comme suit :</p> +<example> + <!--#set var="name" value="Rich" --> +</example> + + <p>Pour affecter une valeur à vos variables, en plus de la + définition littérale de l'exemple ci-dessus, vous pouvez utiliser + une autre variable, y compris les <a + href="../env.html">variables d'environnement</a>, ou les variables + décrites plus haut (comme <code>LAST_MODIFIED</code> par exemple). + Pour indiquer qu'il s'agit d'une variable et non d'une chaîne, vous + devez utiliser le symbole dollar ($) devant le nom de la + variable.</p> + + <example> <!--#set var="modified" value="$LAST_MODIFIED" --> + </example> + + <p>Pour insérer un caractère $ dans la valeur de votre variable, + vous devez l'échapper à l'aide d'un backslash.</p> +<example> + <!--#set var="cost" value="\$100" --> +</example> + + <p>Enfin, si vous voulez insérer une variable dans une chaîne, et + s'il y a une chance pour que le nom de la variable se confonde avec + le reste de la chaîne, vous pouvez l'entourer d'accolades pour + eviter toute confusion (Il est difficile de trouver un bon exemple + pour illustrer ceci, mais j'espère que vous comprendrez).</p> +<example> + <!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" --> +</example> +</section> + +<section id="conditional"> +<title>Expressions conditionnelles</title> + + <p>Maintenent que nous avons des variables, et que nous pouvons + définir et comparer leurs valeurs, nous sommes à même de les + utiliser dans des expressions conditionnelles. Ceci confère à SSI le + statut de petit langage de programmation. + <module>mod_include</module> fournit une structure <code>if</code>, + <code>elif</code>, <code>else</code>, <code>endif</code> pour la + construction d'expressions conditionnelles, ce qui vous permet de + générer plusieurs pages logiques à partir d'une seule vraie + page.</p> + + <p>La structure de l'expression conditionnelle est :</p> +<example> + <!--#if expr="condition" --><br /> + <!--#elif expr="condition" --><br /> + <!--#else --><br /> + <!--#endif --> +</example> + + <p>Une <em>condition</em> peut revêtir la forme de toute comparaison + logique - soit une comparaison de valeurs avec une autre, soit une + vérification de la "vérité" d'une valeur particulière (Une chaîne + donnée est vraie si elle n'est pas vide). Pour une liste exhaustive + des opérateurs de comparaison disponibles, voir la documentation du + module <module>mod_include</module>. Voici quelques exemples + illustrant l'utilisation de ces expressions.</p> + + <p>Vous pouvez ajouter les lignes suivantes dans votre fichier de + configuration :</p> +<example> + BrowserMatchNoCase macintosh Mac<br /> + BrowserMatchNoCase MSIE InternetExplorer +</example> + + <p>Ces lignes définissent les variables d'environnement "Mac" et + "InternetExplorer" à true, si le client utilise InternetExplorer sur + un Macintosh.</p> + + <p>Puis, dans votre document où les SSI sont activées, vous ajoutez + ceci :</p> +<example> + <!--#if expr="${Mac} && ${InternetExplorer}" --><br /> + Un texte d'excuses est inséré ici<br /> + <!--#else --><br /> + Ici se trouve du code JavaScipt sympa<br /> + <!--#endif --> +</example> + + <p>Notez que je n'ai rien contre IE sur Macintosh - J'ai juste + phosphoré quelques heures la semaine dernière pour faire fonctionner + du JavaScript sous IE sur Macintosh, alors qu'il fonctionnait sous + tout autre environnement. Ce qui précède a constitué un + contournement provisoire.</p> + + <p>Toute autre variable (que vous avez définie, ou une variable + d'environnement normale) peut être utilisée dans les expressions + conditionnelles. Associée à la possibilité avec Apache de définir + des variables d'environnement à l'aide de directives + <code>SetEnvIf</code>, ainsi que d'autres directives en rapport, + cette fonctionnalité vous permet d'ajouter des contenus dynamiques + assez évolués sans avoir recours aux programmes CGI.</p> +</section> +</section> + +<section id="conclusion"><title>Conclusion</title> + + <p>SSI ne remplace certainement pas CGI, ou d'autres technologies + utilisées pour la génération de pages web dynamiques. Mais c'est une + bonne méthode pour ajouter des petits contenus dynamiques à vos + pages, sans devoir fournir un gros effort supplémentaire.</p> +</section> + +</manualpage> diff --git a/docs/manual/howto/ssi.xml.meta b/docs/manual/howto/ssi.xml.meta index d56f940fc1..f5e0c66572 100644 --- a/docs/manual/howto/ssi.xml.meta +++ b/docs/manual/howto/ssi.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant>ko</variant> </variants> |