Pages statiques

Comment générer une page statique

Les pages statiques d’une édition sont écrites en XHTML et se placent dans le dossier [projet]-max/editions/[mon-edition]/fragments/[langue-locale]. Chaque fichier a pour extension .frag.html. Le dossier [langue-locale] sera nommé fr, pour du français, en pour de l’anglais, etc.

graph LR; A-->B B-->C C-->D D-->E E-->F A["projet-max"] B["editions"] C["mon-edition"] D["fragments"] E["[langue-locale]"] F("page_html.frag.html")

Exemple du fichier fr/accueil.frag.html, page d’accueil en français de l’édition de démontration EAD de max :

<div id="demo_presentation" class="page">
    <h3>Édition de démonstration [XML-EAD]</h3>
    <p>On trouve ici une édition de démonstration pour des corpus de textes en EAD</p>
    <p>Ceci est la page d’accueil correspondant à la fin d’URL max_ead_demo/accueil.html</p>
</div>

Notez que la déclaration de type de document doit être omise. Un fichier de fragment commence directement par une <div> contenant le texte à afficher.

Comment lier une url de consultation à une page statique

Si la page statique d'accueil est directement accessible dans l'interface par défaut en cliquant sur le bouton accueil du menu d'une page HTML de votre édition, il faudra en revanche lier manuellement un bouton à une autre page statique que vous pourrez générer. Pour ce faire, il faut agir conjointement sur les fichiers menu.xml et i18n.xml de l'édition (cf. fichier menu.xml et fichier i18n).

Dans le fichier menu.xml, le contenu de l’élément <target> détermine la cible du lien : cet élément doit comprend le nom de la page statique HTML, mais en omettant la chaîne de caractères .frag dans le nom de la page statique. Par exemple :

<menu>
    <entry>
        <id>presentation</id>
        <target>presentation.html</target>
    </entry>
</menu>

Ici, le contenu de l'élément <target> est presentation.html. Le fichier presentation.frag.html qui se trouve dans le dossier [projet]-max/editions/[mon-edition]/fragments pourra être consulté à l’adresse suivante : http://[host]:[port]/[mon-edition]/introduction_oeuvre.html. Si le fichier ciblé n’existe pas, le navigateur retourne une erreur.

L’élément <id>, ici presentation, est un identifiant qui doit correspondre à celui déclaré dans le fichier i18n-[langue_courante].xml afin de permettre d'accéder à la page statique par un clic sur un bouton de la barre de menu. Ce fichier se trouve dans le répertoire ui/i18n/ de chaque édition.

Nota bene :
Le fichier i18n-[langue_courante].xml peut être absent de la version packagée de MaX. Auquel cas, vous devrez le créer en remplaçant [langue_courante] par l'abréviation de la langue en deux caractères, comme : i18n-fr.xml ou i18n-en.xml

Le fichier i18n-[langue_courante].xml comprend autant d'éléments <entry> que de boutons à activer dans le menu. L'attribut @key a pour valeur menu. suivi de l'identifiant défini dans l'élément <id> du fichier menu.xml. Le contenu de l'élément <entry> permet d'associer à ce bouton du menu une chaîne de caractère à afficher dans la langue choisie. Par exemple :

<entry key="menu.presentation">Présentation</entry>

Voir d’autres exemples dans les sections Menu et i18n