From 1e9ec7824edfd8c02ad64013b8975cb8c2cec53b Mon Sep 17 00:00:00 2001 From: Olivier DOSSMANN Date: Fri, 2 Mar 2012 11:34:20 +0100 Subject: [PATCH] =?UTF-8?q?[AJ]=20Refonte=20des=20derni=C3=A8res=20variabl?= =?UTF-8?q?es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Changement des variables minuscules en majuscule * Mise à jour du fichier configrc.exemple * Adaptation du GNUMakefile en conséquence * Création de nouvelles variables * Réecriture de la documentation en conséquence * Adaptation du script creation_categ.sh * Mise à jour des TACHES --- GNUmakefile | 36 ++++++++++++++++++------------------ LISMOI | 34 +++++++++++++++++++++++++--------- TACHES | 12 ++++++++---- configrc.exemple | 34 ++++++++++++++++++++++------------ creation_categ.sh | 6 +++--- 5 files changed, 76 insertions(+), 46 deletions(-) diff --git a/GNUmakefile b/GNUmakefile index 97de0c0..85a9b05 100644 --- a/GNUmakefile +++ b/GNUmakefile @@ -31,11 +31,11 @@ include configrc.exemple include configrc ## autre configurations ifndef $(MENU) - dependances_css = $(CSS_SANS_MENU_ADDR) + CSS_DEP = $(CSS_SANS_MENU_ADDR) else - dependances_css = $(CSS_AVEC_MENU_ADDR) + CSS_DEP = $(CSS_AVEC_MENU_ADDR) endif -dependances_index = $(entete) $(enqueue) $(contenu_fin) +INDEX_DEP = $(ENTETE_ADDR) $(ENQUEUE_ADDR) $(POST_CONTENU_ADDR) SOURCE = $(CATEGORIES)/*.$(CATEGORIES_EXT) # programmes PROG_ECHO = `which echo` @@ -117,7 +117,7 @@ test: @$(PROG_ECHO) -e " …terminé." # création du fichier CSS -$(CIBLE)/$(CSS_NOM): $(dependances_css) +$(CIBLE)/$(CSS_NOM): $(CSS_DEP) @$(PROG_ECHO) -e "Création du fichier CSS…" $(if $(MENU), @$(PROG_CP) $(CSS_AVEC_MENU_ADDR) $(CIBLE)/$(CSS_NOM), @$(PROG_CP) $(CSS_SANS_MENU_ADDR) $(CIBLE)/$(CSS_NOM)) @$(PROG_ECHO) -e " …terminée." @@ -128,30 +128,30 @@ $(CIBLE)/$(STYLE): $(STYLE_ADDR) @$(PROG_CP) $(STYLE_ADDR) $(CIBLE)/$(STYLE) @$(PROG_ECHO) -e " …terminée." -# création du fichier $(contenu) -$(contenu): $(script_contenu) $(SOURCE) $(DEFAUT_IMG_ADDR) - @$(PROG_SED) -i "s/DEBUG=1/DEBUG=0/g" $(script_contenu) +# création du fichier $(CONTENU_ADDR) +$(CONTENU_ADDR): $(GEN_CATEGORIES) $(SOURCE) $(DEFAUT_IMG_ADDR) + @$(PROG_SED) -i "s/DEBUG=1/DEBUG=0/g" $(GEN_CATEGORIES) @$(PROG_ECHO) -e "Création du contenu avec les valeurs suivantes : " @$(PROG_ECHO) -e "\t\t- Dossier catégorie : $(CATEGORIES)" - @$(PROG_ECHO) -e "\t\t- Destination temporaire du contenu : $(contenu)" + @$(PROG_ECHO) -e "\t\t- Destination temporaire du contenu : $(CONTENU_ADDR)" @$(PROG_ECHO) -e "\t\t- Extension des fichiers à lire : $(CATEGORIES_EXT)" @$(PROG_ECHO) -e "\t\t- Dossier ayant les composants de la page : $(COMPOSANTS)" - @$(PROG_ECHO) -e "\t\t- Entête HTML d'une catégorie : $(categ_deb)" - @$(PROG_ECHO) -e "\t\t- Enqueue HTML d'une catégorie : $(categ_fin)" - @$(PROG_ECHO) -e "\t\t- Code HTML d'un élément : $(elem)" + @$(PROG_ECHO) -e "\t\t- Entête HTML d'une catégorie : $(ENTETE_CAT_ADDR)" + @$(PROG_ECHO) -e "\t\t- Enqueue HTML d'une catégorie : $(ENQUEUE_ADDR)" + @$(PROG_ECHO) -e "\t\t- Code HTML d'un élément : $(ELEMENT_ADDR)" @$(PROG_ECHO) -e "\t\t- Dossier contenant les images sources : $(IMAGES)" @$(PROG_ECHO) -e "\t\t- Dossier de destination des images : $(IMAGES_CIBLE)" @$(PROG_ECHO) -e "\t\t- Image par défaut : $(DEFAUT_IMG_ADDR)" @$(PROG_ECHO) -e "\t\t- Dossier de destination global : $(CIBLE)" - @$(PROG_SH) $(script_contenu) $(CATEGORIES) $(contenu) $(CATEGORIES_EXT) $(COMPOSANTS) $(categ_deb) $(categ_fin) $(elem) $(IMAGES) $(IMAGES_CIBLE) $(DEFAUT_IMG_ADDR) $(CIBLE) + @$(PROG_SH) $(GEN_CATEGORIES) $(CATEGORIES) $(CONTENU_ADDR) $(CATEGORIES_EXT) $(COMPOSANTS) $(ENTETE_CAT_ADDR) $(ENQUEUE_CAT_ADDR) $(ELEMENT_ADDR) $(IMAGES) $(IMAGES_CIBLE) $(DEFAUT_IMG_ADDR) $(CIBLE) # création de la page d'index index: $(INDEX_ADDR) -$(INDEX_ADDR): $(COMPOSANTS) $(CIBLE)/$(CSS_NOM) $(dependances_index) $(contenu) $(CIBLE)/$(STYLE) +$(INDEX_ADDR): $(COMPOSANTS) $(CIBLE)/$(CSS_NOM) $(INDEX_DEP) $(CONTENU_ADDR) $(CIBLE)/$(STYLE) @$(PROG_ECHO) -e "Création de la page de garde…" # entete @$(PROG_ECHO) -e "\t…insertion de l'entête" - @$(PROG_CAT) $(entete) > $(INDEX_ADDR) + @$(PROG_CAT) $(ENTETE_ADDR) > $(INDEX_ADDR) # modification du contenu @$(PROG_ECHO) -e "\t…modification du contenu" @$(PROG_SED) -i \ @@ -166,20 +166,20 @@ $(INDEX_ADDR): $(COMPOSANTS) $(CIBLE)/$(CSS_NOM) $(dependances_index) $(contenu) $(if $(INTRO), @cat $(INTRO_ADDR) >> $(INDEX_ADDR); $(PROG_ECHO) -e "\t…insertion de l'introduction" || exit 1) # contenu @$(PROG_ECHO) -e "\t…insertion du contenu" - @$(PROG_CAT) $(contenu) >> $(INDEX_ADDR) + @$(PROG_CAT) $(CONTENU_ADDR) >> $(INDEX_ADDR) # fin du contenu @$(PROG_ECHO) -e "\t…insertion de la fin du contenu" - @$(PROG_CAT) $(contenu_fin) >> $(INDEX_ADDR) + @$(PROG_CAT) $(POST_CONTENU_ADDR) >> $(INDEX_ADDR) # menu $(if $(MENU), @cat $(MENU_ADDR) >> $(INDEX_ADDR); $(PROG_ECHO) -e "\t…insertion du menu" || exit 1) # enqueue @$(PROG_ECHO) -e "\t…insertion de l'enqueue" - @$(PROG_CAT) $(enqueue) >> $(INDEX_ADDR) + @$(PROG_CAT) $(ENQUEUE_ADDR) >> $(INDEX_ADDR) @$(PROG_ECHO) -e " …terminée." # nettoyage des fichiers générés clean: @$(PROG_ECHO) -e "Nettoyage des fichiers en cours…" @$(PROG_RM) -rf $(CIBLE) - @$(PROG_RM) -f $(contenu) + @$(PROG_RM) -f $(CONTENU_ADDR) @$(PROG_ECHO) -e " …terminé." diff --git a/LISMOI b/LISMOI index 713849e..e81c6dd 100644 --- a/LISMOI +++ b/LISMOI @@ -297,7 +297,7 @@ Configuration basique : Configuration avancée : - ACCUEIL : Titre de la page tel qu'il s'affichera sur un navigateur -- script_contenu : script bash lancé au moment de la création des +- GEN_CATEGORIES : script bash lancé au moment de la création des catégories. C'est ce script qui génère les catégories pour la page finale. - INDEX : nom du fichier final. Par exemple index.xhtml @@ -305,6 +305,20 @@ Configuration avancée : les catégories - DEFAUT_IMG : nom de l'image - contenue par défaut dans le dossier img - par défaut pour un élément qui n'a pas d'image ou n'en a pas trouvé. +- ELEMENT : nom du fichier contenant le code HTML d'un élément. Se trouve +par défaut dans le dossier COMPOSANTS. +- CONTENU : nom du fichier contenu le résultat de la génération des +catégories. +- ENTETE_CAT : nom du fichier contenant le code HTML du début d'une +catégorie. Se trouve par défaut dans le dossier COMPOSANT. +- ENQUEUE_CAT : nom du fichier contenant le code HTML de la fin d'une +catégorie. Se trouve par défaut dans le dossier COMPOSANT. +- POST_CONTENU : nom du fichier contenant le code HTML à utiliser après +le contenu des catégories. Se trouve par défaut dans le dossier COMPOSANT. +- ENTETE : nom du fichier contenant le code HTML à utiliser en début de la + page finale. +- ENQUEUE = nom du fichier contenant le code HTML à utiliser en fin de la +page finale - COMPOSANTS : dossier contenant les éléments qui constitueront la page finale - CATEGORIES : dossier contenant les fichiers sources des catégories. @@ -325,17 +339,19 @@ Configuration avancée : page avec menu - STYLE_ADDR : adresse exacte du second fichier CSS (pour la couleur généralement) -- entete : adresse exacte du fichier contenant le code HTML de l'entête de +- ENTETE_ADDR : adresse exacte du fichier contenant le code HTML de l'entête de la page HTML finale -- enqueue : adresse exacte du fichier contenant le code HTML de l'enqueue de +- ENQUEUE_ADDR : adresse exacte du fichier contenant le code HTML de l'enqueue de la page HTML finale -- contenu_fin : adresse exacte du fichier contenant le code final du contenu. +- POST_CONTENU_ADDR : adresse exacte du fichier contenant le code final du contenu. C'est utile pour la génération des catégories. -- contenu : nom du fichier temporaire dans lequel sera écrit le code HTML du -contenu. -- categ_deb : code HTML du début d'une catégorie -- categ_fin : code HTML de la fin d'une catégorie -- elem : code HTML d'un élément +- ENTETE_CAT_ADDR : adresse exacte du fichier contenant le code HTML du début + d'une catégorie +- ENQUEUE_CAT_ADDR : adresse exacte du fichier contenant le code HTML de la +fin d'une catégorie +- ELEM_ADDR : adresse exacte du fichier contenant le code HTML d'un élément +- CONTENU_ADDR : adresse exacte du fichier contenant le code HTML de l'ensemble + des catégories - DEFAUT_IMG_ADDR : adresse exacte de l'image par défaut utilisée si jamais aucune image n'est trouvée pour un élément donné. diff --git a/TACHES b/TACHES index 3127d69..00659cf 100644 --- a/TACHES +++ b/TACHES @@ -19,11 +19,11 @@ DESTDIR - Simplifier le fichier Makefile au niveau des variables pour réduire leur nombre - Réorganiser les variables du GNUmakefile pour rendre plus simple le choix des variables par l'utilisateur. Afin qu'il n'ai JAMAIS à mettre d'autre variables dans le contenu. Par exemple jamais écrire cela : $(DOSSIER)/fichier.html !!!! - - ne laisser que la variable CSS_COULEUR ? => trouver une solution potable + - FAIT | ne laisser que la variable CSS_COULEUR ? => trouver une solution potable - ne laisser que les variables fondamentales pour l'utilisateur comme le choix du titre, si intro, si menu - - déplacer les variables inutiles à l'utilisateur dans un autre fichier de config qu'on inclue ? Ou bien les mettre avant le include configrc, comme ça l'utilisateur peut les redéfinir si besoin ! - - mettre toutes les variables en majuscules OU en minuscule (peut-être les variables en majuscules pour les principales, et celles du Makefile en minuscule - - renommer les variables correctement ! + - FAIT | déplacer les variables inutiles à l'utilisateur dans un autre fichier de config qu'on inclue ? Ou bien les mettre avant le include configrc, comme ça l'utilisateur peut les redéfinir si besoin ! + - FAIT | mettre toutes les variables en majuscules OU en minuscule (peut-être les variables en majuscules pour les principales, et celles du Makefile en minuscule + - FAIT | renommer les variables correctement ! - activer menu avec une variable du genre "MENU_ACTIVE = 1" (par exemple) @@ -38,6 +38,10 @@ DESTDIR - changer l'utilisation du shell par TXTs = $(shell ls $(dossier)/*$(ext)), par exemple. - Intégrer le script .sh dans le Makefile +>>> Pour la v0.3 : +- Transformer variables en anglais +- Documentation en anglais + =============================================================================== =============================================================================== diff --git a/configrc.exemple b/configrc.exemple index 38c8335..0d40e08 100644 --- a/configrc.exemple +++ b/configrc.exemple @@ -19,13 +19,27 @@ CIBLE = porteail ##--[[ divers ]]--## ACCUEIL = Accueil - $(TITRE) -script_contenu = creation_categ.sh +GEN_CATEGORIES = creation_categ.sh INDEX = index.xhtml # Extension des fichiers à prendre en compte dans le dossier contenant les #+ catégories CATEGORIES_EXT = txt # Image de base si aucune mentionnée (par défaut dans le dossier IMAGES) DEFAUT_IMG = generique.png +# Contenu HTML d'un élément +ELEMENT = element.html +# résultat de la génération des catégories +CONTENU = categories.html +# Contenu HTML à utiliser en début de catégorie +ENTETE_CAT = categ_deb.html +# Contenu HTML à utiliser en fin de catégorie +ENQUEUE_CAT = categ_fin.html +# Contenu HTML à utiliser après le contenu principal de la page +POST_CONTENU = contenu_fin.html +# Contenu HTML à utiliser en début de page finale +ENTETE = entete.html +# Contenu HTML à utiliser en fin de page finale +ENQUEUE = enqueue.html ##--[[ dossiers ]]--## @@ -57,15 +71,11 @@ MENU_ADDR = $(COMPOSANTS)/$(MENU) CSS_SANS_MENU_ADDR = $(CSS)/$(CSS_SANS_MENU) CSS_AVEC_MENU_ADDR = $(CSS)/$(CSS_AVEC_MENU) STYLE_ADDR = $(CSS)/$(STYLE) -entete = $(COMPOSANTS)/entete.html -enqueue = $(COMPOSANTS)/enqueue.html -contenu_fin = $(COMPOSANTS)/contenu_fin.html -# résultat de la génération des catégories -contenu = categories.html -# entête des catégories (contenu dans dossier composants) -categ_deb = categ_deb.html -# enqueue des catégories (contenu dans dossier composants) -categ_fin = categ_fin.html -# code HTML de chaque élément -elem = element.html +ENTETE_ADDR = $(COMPOSANTS)/$(ENTETE) +ENQUEUE_ADDR = $(COMPOSANTS)/$(ENQUEUE) +POST_CONTENU_ADDR = $(COMPOSANTS)/$(POST_CONTENU) +ENTETE_CAT_ADDR = $(COMPOSANTS)/$(ENTETE_CAT) +ENQUEUE_CAT_ADDR = $(COMPOSANTS)/$(ENQUEUE_CAT) +ELEMENT_ADDR = $(COMPOSANTS)/$(ELEMENT) +CONTENU_ADDR = $(COMPOSANTS)/$(CONTENU) DEFAUT_IMG_ADDR = $(IMAGES)/$(DEFAUT_IMG) diff --git a/creation_categ.sh b/creation_categ.sh index 26b96af..a53a997 100755 --- a/creation_categ.sh +++ b/creation_categ.sh @@ -66,9 +66,9 @@ else destination=$2 #"categories.html" extension=$3 # Extension des fichiers à prendre en compte dossier_composants=$4 - categ_deb="${dossier_composants}/$5" - categ_fin="${dossier_composants}/$6" - elem="${dossier_composants}/$7" + categ_deb="$5" + categ_fin="$6" + elem="$7" dossier_image=$8 dest_image=$9 image_defaut=${10}