« FrankizII » : différence entre les versions

De WikiBR
Aucun résumé des modifications
Ligne 1 : Ligne 1 :
[[Configuration:FrankizII]] (privé)
==Présentation==
==Présentation==


Ligne 64 : Ligne 66 :


[http://www.w3schools.com/css/default.asp Documentation CSS]
[http://www.w3schools.com/css/default.asp Documentation CSS]
==Pages d'administration==
==Structure du site: Arborescence des fichiers==
/bin                Scripts qui génèrent du code pour le site (Cron)
/binets            Répertoire contenant les sites des binets
/cache              Fichiers temporaires
/data
  /data/affiches          Images des activités
  /data/annonces          Images des annonces
  /data/binets            Logos des binets en attente de validation
  /data/faq              Fichiers de la [[FAQ]]
  /data/mailpromo        Logs d'envoi de mails promo
  /data/photos            Photos du trombi
  /data/trombino          Photos trombi en attente de validation
  /data/xshare            Fichiers du [[XShare]]
/doc                Documentation
/etc                Fichiers de configuration
/htdocs
  /htdocs/admin          Pages d'administration
  /htdocs/binets        Répertoire contenant des liens symboliques vers les sites des binets visibles depuis l'extérieur
  /htdocs/gestion        Pages de gestion pour les utilisateurs (kès, bob, binets)
  /htdocs/include        Fichiers contenant des fonctions ou des entètes utilisées dans plusieurs pages
  /htdocs/migration      Fichiers de migration du site (Pour convertir les bases de données de Frankiz vers Frankiz2, inutile à ce jour)
  /htdocs/modules        Répertoire contenant tous les modules du site.
  /htdocs/profil        Préférences de l'utilisateur
  /htdocs/proposition    Fichiers pour proposer des annonces, activités, mails promo...
  /htdocs/skins          Répertoire contenant les différentes skins (voir la section skins)
  /htdocs/stats          Génération de graphiques statistiques
  /htdocs/webperso      Répertoire contenant des liens symboliques vers les sites perso visibles depuis l'extérieur
/webperso          Répertoire contenant les sites perso
==Ajouter des modules==
----
Retour : [[Accueil]]

Version du 19 septembre 2005 à 15:54

Configuration:FrankizII (privé)

Présentation

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

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 pour 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

Note: Actuellement les fichiers se trouvent dans htdocs/skins/pico/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