DISTRIBUTION D'UNE BASE de CREATION de site WEB Auteur : Dominique Guebey Version 7 : 13 novembre 2020 *************************************************** CE FICHIER est encodé en UTF-8 *************************************************** SOMMAIRE ======== GENERALITES SCHEMA D'IMPLANTATION METHODE D'INSTALLATION GESTION DES PAGES HTML ANNEXES - MEMENTO POUR CRÉER LE "template" - DIVERS GENERALITES =========== Principe : mise à disposition de la méthode de génération du site web de l'auteur : http://www.dg77.net Versions successives : 1 10 décembre 2015. 2 29 décembre 2015. 3 13 mai 2017. 4 28 septembre 2019. 5 09 novembre 2019. 6 03 février 2020. 7 13 novembre 2020 Il s'agit de transformations xslt appliquées à des fichiers xml standards. Sont fournis : - les transformations XSL (XML/XSL/*), - un style par défaut (design/*.CSS), - un fichier de configuration (design/Config.xml) - des exemples de fichiers XML (XML/XSL/*.xml) et les pages HTML correspondantes. La présence de Java est impérative. Un processeur XSLT (Saxon9) est fourni. Ceci autorise la portabilité sur un maximum de systèmes d'exploitation. Cet ensemble ne prend pas en charge : - la mise en ligne des pages sur le serveur distant, - la sauvegarde - 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 SCHEMA D'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 (Config.xml) - entêtes et menus (facultatifs) - 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 (Saxon9he). - 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) - Génération de la page (ou des pages) : se servir des utilitaires gen.bat (MS Windows) ou gen.sh (Unix/Linux) ssaa-mm-jj xxxxxxxxxxxxxxxxxxxxx ... HTML TAGS / BALISAGE HTML ... Balises et attribut obligatoires : - page - page/@nomfic - page/titre/ ANNEXES ======= MEMENTO POUR CRÉER LE "template" ================================ Se référer au Changelog.txt qui se trouve dans le repertoire normal (wwwrk/design). Dans le répertoire TEMPLATE : - Adapter Lisez_moi.txt au fur et à mesure de son application - design/Config.xml : le mettre à niveau s'il y a eu des améliorations. - adapter/creer les fichiers annexes s'il y a des nouveautés. - Copier les modules XSL modifiés depuis la dernière release. - Tenir à jour les fichiers design/*.css - Enrichir / adapter les pages exemples aux évolutions éventuelles. - Tester et corriger les pages de demo Attention : le CHANGELOG officiel étant dans le répertoire design, le copier dans TEMPLATE à la racine. Inversement, copier Lisez_moi.txt et Read_me.txt de TEMPLATE dans le repertoire design du site standard. (lien dans page sitedoc.htm). Puis mettre en ligne également. Dans le répertoire STANDARD (wwwrk) - Ziper le répertoire www_template dans wwwrk/design/www_template.zip (supprimer au préalable l'existant). - Créer la signature GPG : gpg -b -a -o design\www_template.asc design\www_template.zip - Mettre en ligne design/www_template.asc et design/www_template.zip - Mettre en ligne ces deux derniers fichiers ainsi que le Changelog.txt. DIVERS ------ Somme de contrôle avec 7zip (exemple avec sha256) "C:\Program Files\7-Zip\7z.exe" h -scrcsha256 [nomfic] > sortie.sha