 DISTRIBUTION D'UNE BASE de CREATION de site WEB
  
  Auteur : Dominique Guebey
  Version 25 : 1er juillet 2026
  
  ***************************************************
           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 :
    25 : 1er juillet 2026
    24 : 1er octobre 2025
    23 : 22 avril 2025
    22 : 01 janvier 2025
    21 : 06 octobre 2024
    20 : 26 juillet 2024
    19 : 27 mai 2024
    18 : 05 avril 2024
    17 : 25 février 2024
    16 : 07 janvier 2024
    15 : 27 juin 2023
    14 : 08 novembre 2022
    13 : 06 octobre 2022
    12 : 06 mai 2022
    11 : 22 septembre 2021.
    10 : 13 avril 2021.
    09 : 30 décembre 2020.
    08 : 15 décembre 2020.
    07 : 13 novembre 2020.
    06 : 03 février 2020.
    05 : 09 novembre 2019.
    04 : 28 septembre 2019.
    03 : 13 mai 2017.
    02 : 29 décembre 2015.
    01 : 10 décembre 2015.
  
  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/SRC/*.xml) et les pages HTML 
      correspondantes.
  
  Un processeur XSLT (Saxon) est fourni. Son fonctionnement suppose 
  la présence de Java. 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 sous système 
        Microsoft Windows.
    - un script bash équivalent qui fonctionne sous système LINUX, 
        UNIX (ou avec Cygwin sous Microsoft Windows).
    - le générateur utilisé par la génération (Saxon).
  
  - 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: <!DOCTYPE www SYSTEM "../XSL/listent.ent">
  
  - 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
  
  - script/ : contient un module javascript utilisé dans certains cas, 
    notamment pour la fonction "Contact".
  - 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_model.xml :
      - 1ère installation : le renommer Config.xml
      - Pour une implantation existante : sélectionner les lignes repérées 
        par "!!nn" où nn suivant deux point d'exclamation est la version 
        nouvelle (la première indiquée dans Changelog.txt - exemple : 
        ## [09] - 30 décembre 2020 pour la version 09). Reporter les 
        nouveautés ou changements dans le Config.xml déjà existant.
    - 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)
  
  <page nomfic="demo/%%%%%%.htm" retour="index.html" e="">
  <description>
      <cre>ssaa-mm-jj</cre>
      <upd></upd>
      <titre>xxxxxxxxxxxxxxxxxxxxx</titre>
      <description></description>
      <keywords></keywords>
  	<style css=""></style>
          <docu></docu>
          <lang></lang>
  </description>
              ...
              HTML TAGS / BALISAGE HTML
              ...
  </page>
  
  Balises et attribut obligatoires :
  - page
  - page/@nomfic
  - page/titre/