DISTRIBUTION D'UNE BASE de DEVELOPPEMENT de site WEB ==================================================== Auteur : Dominique Guebey GENERALITES =========== Principe : mise à disposition de la méthode de génération du site web de l'auteur : http://www.dg77.net Il s'agit de transformations xslt appliquées à des fichiers xml standardisés. Un style par défaut, des fichiers et des pages d'exemples sont fournis. Le bon fonctionnement suppose la présence de Java sur votre système. Le processeur Saxon9 est fourni en même temps. Ceci autorise la portabilité sur un maximum de systèmes d'exploitation. Il est néanmoins conseillé d'effectuer les tests en local sur une machine sensible à la casse (distinction majuscule/minuscule) comme Linux ou UNIX/BSD. Cela évite des erreurs dans les noms des fichiers et répertoires une fois mis en ligne sur un serveur distant. Cet ensemble ne prend pas en charge la mise en ligne des pages, leur sauvegarde ni la gestion des versions. Ces tâches sont laissées à la responsabilité de chacun. Une documentation technique en français figure à l'URL suivante : http://www.dg77.net/tekno/sitedoc.htm La distribution peut être téléchargée ici (quelques informations complémentaires sont affichées) : http://www.dg77.net/tekno/sitedoc.htm#distrib IMPLANTATION ============ Description de l'implantation minimale Principaux répertoires : - bin : les programmes et scripts - design : éléments communs - feuilles de style - fichiers de paramétrage et configuration - entêtes et menus - XML/XSL : les transformations XSLT - XML/SRC : corps des pages html - Répertoires autres, laissés à la liberté du concepteur. Composition détaillée : ----------------------- - bin/ - le programme "batch" (.bat) de génération - le programme Java utilisé par la génération (Saxon9). - design/ : Config.xml et root_index doivent impérativement exister sous ce nom et à cet emplacement. - le fichier Config.xml qui indique des noms et emplacements (nom de domaine, feuilles de style, le bandeau d'entête,) - le fichier root_index.xml, indiquant le libellé d'en-tête et le fichier d'entête avec liens, en fonction du répertoire ou sous-répertoire. root_index contient une "cartographie" du site. - des feuilles de style par défaut (modification possible dans Config.xml). - le bandeau d'entête par défaut (root_bando.xml) - l'entête avec des liens par défaut (menu_root.xml) - design/images/ - Icones et images utilisées par le site - XML/XSL/ : contient les modules de transformation XSLT, en particulier : - x8_o_utf8 : lancement (appelle dg8_3.xml) - dg8_3.xsl : charge les variables, intègre l'ensemble des fichiers xsl. * reçoit en parametres externes : - horodatage - nom du fichier source XML en entree - nom de la page html à sortir (si ce paramêtre est absent ou nul ou "x" : par défaut toutes les pages du fichier xml son générées) * charge les variables à  partir de design/Config.xml * charge (par "include") l'ensemble des autres modules xslt - dg8_h.xsl : module principal de traîtement - listent.ent : fichier des entités, appelé en tête [note 1] exemple: - XML/XSL_spec/ : permet d'ajouter des modules xslt spécifiques., veiller à ne pas toucher à son contenu lors des mises-à-jour - XML/SRC/ : - les fichiers xml "sources", chacun pouvant contenir plusieurs pages html - fichiers d'exemple templatexxx.xml fournissent des pages utilisables comme exemples - Autres : répertoires et sous-répertoires de pages exemples et leurs accessoires (images). METHODE D'INSTALLATION ====================== a) extraction Extraire le contenu du fichier "zip". Il contient un répertoire www_template. Copier ce répertoire dans un emplacement à votre guise, conçu pour vos propres besoins (ex: www_perso). Si vous récupérez ultérieurement une version plus récente de la distribution, celà évitera le risque d'écrasements intempestifs de données. b) préparation - Adapter le fichier design/Config.xml - Adapter également design/root_index.xml en fonction de l'arborescence (répertoires) projetée. - Adapter le fichier "bandeau" d'entête - Adapter le menu d'entête, éventuellement en créer de nouveaux (spécifiés dans root_index.xml). GESTION DES PAGES HTML ====================== - Créer un fichier source à partir de sample.xml - Créer une page nouvelle par insertion (voir exemples fournis) ssaa-mm-jj xxxxxxxxxxxxxxxxxxxxx ... HTML TAGS / BALISAGE HTML ... Balises et attribut obligatoires : - page - page/@nomfic - page/titre/ NOTES ===== [note 1] Utilisation d'entités (ex: é pour le caractère "é" e accent aigu). L'intérêt est que le fichier source ne contient que des caractères ASCII. L'avantage est qu'il n'y aura aucune difficulté si un jour on décide de changer d'encodage: les caractères accentués et autres symboles seront convertis en fonction de l'encodage spécifié.