moscova.inria.fr
est brion
.http://moscova.inria.fr/
correspond à /net/brion/infosystems/www/moscova/
, qui est un lien symbolique vers /net/yquem/infosystems/www/moscova/moscova/
.http://moscova.inria.fr/
, et non par un nom de machine.Les pages ont pour suffixe .shtml
, pour que le serveur web Apache interprète les commandes qui lui sont destinées (insertion de fichiers annexes et datation de la derniere modification).
Idéalement, les pages respectent la norme XHTML 1.1, dont voici les caracteristiques principales:
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type" />
<br>
en html. On écrit à la place <br/>
.alt
.id
au lieu de l'attribut name
.Une page type contient un menu en haut de page, qui permet de naviguer dans les différentes pages du site et un bas de page avec les icones de validation css et la date de la dernière modification de la page. Elle a également plusieurs feuilles de style, qui peuvent être changées soit en utilisant les liens en bas de page (qui utilisent le fichier de scripts include/styleswitcher.js
), soit en passant par le menu de certains navigateurs (sous Firefox: View→Page Style).
Pour inclure des fichiers annexes dans la page web demandée par l'utilisateur, le serveur Apache utilise des Server Side Includes (SSI). Ces fichiers sont insérés dans le code html lors du chargement de la page.
Pour que ces intructions puissent être exécutées, les fichiers doivent avoir le suffixe .shtml
. Si les SSI ne fonctionnent pas, voir la configuration du serveur Apache.
Les fichiers inclus sont dans le répertoire include
situé dans le répertoire racine du site web.
head
du document, la ligne <!--#include virtual="/include/header.shtml"-->
insère le fichier "header.shtml" dans la page lors de son chargement./include/menu.js
) et celui qui permet de changer le style de la page (/include/styleswitcher.js
)./styles/common.css
qui contient les éléments communs à tous les styles,/styles/style-moscova.css
: le style Moscova par défaut,/styles/menu.css
: le style du menu,<div id="container">
, on trouve les deux lignes suivantes:
<!--#include virtual="/include/footer.shtml"-->
<!--#include virtual="/include/menu.shtml"-->
include/footer.shtml
permet de faire apparaître en bas de page les icones de validation xhtml et css ainsi que la date de la dernière mise à jour de la page. Les icones de validation sont des liens vers le validateur du w3c. Il y a également des liens qui appellent la fonction de changement de style.include/menu.shtml
définit l'arborescence du menu. Le script est dans le fichier include/menu.js
.
Il a besoin d'être initialisé en remplaçant la balise <body>
simple par <body onload="initMenu('menu','mh');">
.
Il faut aussi placer une ancre pour qu'il puisse être placé dans la page. Comme il est situé en haut de page, on place la ligne <p id="ancre_menu"></p>
au tout début de la section <body>
.
Le script associé au changement de style est situé dans le fichier include/styleswitcher.js
.
La fonction la plus utile dans ce fichier est setActiveStyleSheet
qui change le style de la page. Cette fonction prend pour argument le titre du style à afficher, qu'on peut trouver dans le fichier include/header.shtml
, et non le nom du fichier décrit cette feuille de style.
Dans le fichier styleswitcher.js
, une grande partie a été commentée. En effet, ce script est à l'origine conçu pour conserver le style choisi par l'utilisateur pendant toute sa navigation dans le site. Mais cela nécessite l'utilisation de cookies. En commentant cette partie, il n'y a plus de cookies et l'utilisateur se retrouve avec le style par défaut (style-moscova.css
) chaque fois qu'il charge une page. Pour revenir à une utilisation des cookies, il faut décommenter toutes les fonctions et la balise <body>
devient <body onload="initMenu('menu','mh');initPage();">
.
À l'exception de l'ancre du menu, tout le document est compris entre les balises <div id="container">
et </div>
.
Les paragraphes sont contenus dans des sections délimitées par les balises <div class="section">
et </div>
. Il est tout à fait possible que le document ne comporte qu'une section.
Il y a également diverses balises définies dans le fichier common.css :
<span class="warning">
met en gras et rouge le texte.<sup class="hevea">
, <sup class="latex">
et <sub class="latex"<
servent à écrire:
H<sup class="hevea">E</sup>V<sup class="hevea">E</sup>A
,L<sup class="latex">A</sup>T<sub class="latex">E</sub>X
.<code>
pour passer en police Monospace
. La présentaion est préformattée (comme avec les balises <pre>
en HTML).<ul class="mini">
permet de construire une liste très simplifiée, où n'apparaissent ni les puces ni les retraits.En plus de la configuration minimale permettant à Apache de charger des pages html "simples", les deux éléments suivants sont indispensable pour afficher les pages web du projet. Les fichiers de configuration se trouvent sur brion (le serveur correspondant à moscova.inria.fr).
/etc/apache2/apache2.conf
:index.shtml
doit figurer dans la ligne commençant par DirectoryIndex
, et avant index.html
pour qu'il soir chargé en priorité./etc/apache2/sites-available/moscova
:#include
lors du chargement des pages web.Pour cela, dans la section <Directory>
correspondant aux dossiers dans lesquels figurent les pages web shtml, la ligne Options
doit contenir Includes
ou IncludeNoExec
. Ce dernier est plus sûr, car il ne permet pas d'exécuter des programmes.Les adresses pointant sur la machine pauillac.inria.fr
sont a éviter, car cette machine est plus lente que brion
et passer par pauillac pose un problème lorsqu'on veut utliser des adresses locales absolues (commençant par /), notamment pour les #include
.
Pour remédier à cela, le mieux est d'effectuer une redirection permanente. Pour cela dans le fichier /net/pauillac/infosystems/apache_1.2.6/conf/http.conf
on place la ligne: RewriteRule ^/moscova(.*) http://moscova.inria.fr$1 [L,R=permanent]
, dans laquelle L
veut dire last et R
redirection. permanent
est le type de redirection. Cette ligne indique que toutes les adresses de la forme http://pauillac.inria.fr/moscova/{suite}
seront redirigées de façon définitive (redirection code 301) vers http://moscova.inria.fr/{suite}
.
Les pages personnelles doivent être placées dans le répertoire public_html
de chaque utilisateur.
A titre de suggestion et pour éviter de partir de zéro, un modèle de page personnelle est disponible : /net/yquem/infosystems/www/moscova/moscova/doc-site/template.shtml
. Il respecte les instuctions décrites précédemment.
Il y a des pages spécifiques pour les logiciels téléchargeables. Elles se trouvent dans le répertoire soft
, et chacune d'entre elles regroupe de façon synthétique une description brève du logiciel, le numéro de la dernière version ainsi que des liens vers la documentation et le téléchargement du code source et éventuellement de binaires pour différentes plateformes. On peut aussi trouver un lien vers une page qui décrit l'application plus conséquente. Le but est de faire gagner du temps au visteur qui souhaite obtenir le logiciel.
Vu le contenu, le style pour ces pages n'est pas le style moscova par défaut, mais Fallen Leaf. Pour cela, la balise <body>
est <body onload="initMenu('menu','mh');setActiveStyleSheet('Fallen Leaf');">
.
Comme pour les pages personnelles, un modèle est disponible sur /net/yquem/infosystems/www/moscova/moscova/doc-site/template-soft.shtml
.