« FrankizII » : différence entre les versions

De WikiBR
mAucun résumé des modifications
mAucun résumé des modifications
Ligne 1 : Ligne 1 :
==Présentation==
==Présentation==


Frankiz est le portail des élèves hébergé par [[Frankiz|Frankiz]].
Frankiz est le portail des élèves hébergé par [[Admin:Frankiz|Frankiz]] (privé).


Il a été recodé entièrement par les [[BR2002]] et [[BR2003]].
Il a été recodé entièrement par les [[BR2002]] et [[BR2003]].

Version du 7 janvier 2006 à 15:43

Présentation

Frankiz est le portail des élèves hébergé par Frankiz (privé).

Il a été recodé entièrement par les BR2002 et BR2003.

Le site a été conçu pour être:

modulaire
La majorité des informations sont présentées sous forme de modules que l'utilisateur peut choisir d'afficher ou d'effacer.
skinnable
La page est générée en XML avant d'être transformée au niveau du serveur par une feuille de style XSLT afin d'obtenir le format voulu ( HTML, WAP...) Puis le html est retravaillé au niveau du client par l'intermédiaire d'une feuille de style CSS.
extensible
Il est facile de rajouter un module.


De plus, il contient une interface de gestion du site, des utilisateurs et d'administration du réseau.

Réalisation de skins

Frankiz a été conçu pour pouvoir être entièrement skinné. Ainsi toutes les pages php génèrent un code XML.

Il existe alors 2 catégories de skins:

  • les skins XSL, qui vont convertir le XML dans un autre langage: XHTML, WML, RSS, DocBook...
  • les skins CSS, qui vont mettre en forme le XHTML dans le navigateur.

Note: Initialement il était prévu de n'avoir qu'une seule XSLT par langage de sortie, mais pendant le développement, plusieurs XSLT générant du XHTML sont apparues, nous sommmes en train d'essayer de les fusionner. (05/2005)


Réalisation de skin XSLT

Attention à ne pas multiplier les skins XSL, une par langage de sortie suffit.

Les templates XSLT se trouvent dans

htdocs/skins/nom_du_format_de_sortie/xsl

La template racine doit se nommer

skin.xsl

Structure de base d'un template xslt:

<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" indent="yes" encoding="utf-8"
       doctype-public="-//W3C//DTD XHTML 1.1//EN"
       doctype-system="http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"/>

... mon contenu ...

</xsl:stylesheet>

Documentation XSLT

TODO La DTD du XML Frankiz est à compléter :-(

Réalisation de skin CSS

Le répertoire où on place les fichiers est:

htdocs/skins/xhtml/nom_de_la_css


Pour commencer la création d'une nouvelle css, vous pouvez utiliser vous baser sur la CSS par défaut qui se trouve dans:

htdocs/skins/xhtml/default

Une CSS doit contenir:

  • un fichier style.css qui contient la feuille de style proprement dite.
  • un fichier description.txt qui contient la description de la skin, qui apparaitra sur le site.

Documentation CSS