Structure, thème et habillage (esup-3)

Définitions

Structure

Organisation générale d'une page présentée à l'utilisateur et articulation de ses éléments.

Par exemple : présentation en onglets et colonnes avec une en-tête et un pied de page.

Thème

Structure présentée au format XHTML pour être lue par un client.

Habillage

Ensemble de styles (organisés en CSS) et d'images utilisés par un thème pour le rendu des pages.

Processus de rendu d'une page à l'utilisateur

Ceci indique les principes généraux de rendu de page à l'utilisateur. Un article détaillé (en anglais) peut être consulté ici : http://www.ja-sig.org/wiki/display/UPC/Rendering+Process#RenderingProcess-theme

Requête utilisateur

Une requête est faite au portail via l'interface utilisateur

Traitement de la requête

Le portail produit un fichier XML représentant le profil de l'utilisateur (l'ensemble des dossiers et canaux visibles par l'utilisateur et leurs paramètres) en fonction :

• du profil de l'utilisateur en base
• des ses droits sur les fragments
• de ses droits sur les canaux

Ce fichier est appelé fichier de structure XML. Le terme peut être trompeur : Il ne contient pas d'information sur la structure de la page mais c'est le fichier d'entrée pour l'application de la structure

Conversion structurelle

Le fichier structure XML est traité par les feuilles XSLT de transformation de structure pour produire un autre fichier XML selon les normes du type de structure utilisé par le portail (par exemple : présentation en onglets et colonnes avec une en-tête et un pied de page)

La structure utilisée par les packages Esup est : DLM Tabs and columns

Le fichier XSLT utilisé pour la conversion en structure est : /uportal-war/src/main/resources/layout/structure/columns/columns.xsl

La structure DLM Tabs and columns contient les éléments (pas exhaustif, à compléter, article à part ?) :

• en-tête
  • canal
• navigation
  • onglet
    • menu
• contenu
  • colonne
    • canal
• pied de page
  • canal

Le fichier produit est appelé fichier de thème XML : C'est le fichier d'entrée pour l'application du thème

Conversion en thème

Le fichier thème XML est ensuite traité par les feuilles XSLT de transformation de thème pour produire un fichier au format XHTML. Ce fichier contient les références à l'habillage (skin) et aux scripts javascript utilisés.

Le thème par défaut utilisé par uPortal pour les navigateurs Web est : Universality

Les fichiers XSLT utilisés pour la conversion en thèmes sont dans : /uportal-war/src/main/resources/layout/theme/universality

Génération de la page

Les contenus des canaux (portlets...) sont intégrés à ce fichier qui sera envoyé au client (navigateur...)

Habillage

L'habillage est fait par des liens vers les fichiers CSS contenant les styles