diff --git a/GNUmakefile b/GNUmakefile index 890c850..df3f762 100644 --- a/GNUmakefile +++ b/GNUmakefile @@ -29,7 +29,7 @@ include configrc ## autre configurations dependances_index = $(entete) $(enqueue) $(contenu_fin) -SOURCE = $(categ)/*.$(ext) +SOURCE = $(CATEGORIES)/*.$(ext) # programmes PROG_ECHO = `which echo` PROG_TEST = `which test` @@ -93,39 +93,39 @@ test: $(if $(error_find), @$(PROG_ECHO) -e "\t\tfind : MANQUANT." ; exit 1) $(if $(error_sort), @$(PROG_ECHO) -e "\t\tsort : MANQUANT." ; exit 1) $(if $(error_wc), @$(PROG_ECHO) -e "\t\twc : MANQUANT." ; exit 1) - @$(PROG_ECHO) -e "\t…existence des dossiers img, categ et style" + @$(PROG_ECHO) -e "\t…existence des dossiers 'img', '$(CATEGORIES)' et 'style'" @$(PROG_TEST) -d img || mkdir img - @$(PROG_TEST) -d $(categ) || mkdir $(categ) + @$(PROG_TEST) -d $(CATEGORIES) || mkdir $(CATEGORIES) @$(PROG_TEST) -d style || mkdir style @$(PROG_ECHO) -e "\t…option introduction dans la page" - $(if $(INTRO), @$(PROG_TEST) -f $(INTRO) || exit 1) + $(if $(INTRO), @$(PROG_TEST) -f $(INTRO_ADDR) || exit 1) $(if $(INTRO), @$(PROG_ECHO) -e "\t\t-> activée", @$(PROG_ECHO) -e "\t\t-> désactivée") @$(PROG_ECHO) -e "\t…option ajout d'un menu (vérification de l'existence)" $(if $(MENU), @$(PROG_TEST) -f $(MENU) || exit 1) $(if $(MENU), @$(PROG_ECHO) -e "\t\t-> activée", @$(PROG_ECHO) -e "\t\t-> désactivée") @$(PROG_ECHO) -e "\t…création de la destination" - @$(PROG_TEST) -d $(DESTINATION) || mkdir $(DESTINATION) + @$(PROG_TEST) -d $(CIBLE) || mkdir $(CIBLE) @$(PROG_ECHO) -e "\t…création du dossier '$(dest_image)'" - @$(PROG_TEST) -d $(DESTINATION)/$(dest_image) || mkdir $(DESTINATION)/$(dest_image) + @$(PROG_TEST) -d $(CIBLE)/$(dest_image) || mkdir $(CIBLE)/$(dest_image) @$(PROG_ECHO) -e " …terminé." # création du fichier CSS -$(DESTINATION)/$(CSS_NOM): $(dependances_css) +$(CIBLE)/$(CSS_NOM): $(dependances_css) @$(PROG_ECHO) -e "Création du fichier CSS…" - $(if $(MENU), @$(PROG_CP) style/$(CSS_AVEC_MENU) $(DESTINATION)/$(CSS_NOM), @$(PROG_CP) style/$(CSS_SANS_MENU) $(DESTINATION)/$(CSS_NOM)) + $(if $(MENU), @$(PROG_CP) style/$(CSS_AVEC_MENU) $(CIBLE)/$(CSS_NOM), @$(PROG_CP) style/$(CSS_SANS_MENU) $(CIBLE)/$(CSS_NOM)) @$(PROG_ECHO) -e " …terminée." # création du fichier CSS de couleur -$(DESTINATION)/$(STYLE): style/$(STYLE) +$(CIBLE)/$(STYLE): style/$(STYLE) @$(PROG_ECHO) -e "Création du fichier CSS pour les couleurs…" - @$(PROG_CP) style/$(STYLE) $(DESTINATION)/$(STYLE) + @$(PROG_CP) style/$(STYLE) $(CIBLE)/$(STYLE) @$(PROG_ECHO) -e " …terminée." # création du fichier $(contenu) $(contenu): $(script_contenu) $(SOURCE) $(image_defaut) @$(PROG_SED) -i "s/DEBUG=1/DEBUG=0/g" $(script_contenu) @$(PROG_ECHO) -e "Création du contenu avec les valeurs suivantes : " - @$(PROG_ECHO) -e "\t\t- Dossier catégorie : $(categ)" + @$(PROG_ECHO) -e "\t\t- Dossier catégorie : $(CATEGORIES)" @$(PROG_ECHO) -e "\t\t- Destination temporaire du contenu : $(contenu)" @$(PROG_ECHO) -e "\t\t- Extension des fichiers à lire : $(ext)" @$(PROG_ECHO) -e "\t\t- Dossier ayant les composants de la page : $(composants)" @@ -135,12 +135,12 @@ $(contenu): $(script_contenu) $(SOURCE) $(image_defaut) @$(PROG_ECHO) -e "\t\t- Dossier contenant les images sources : $(image)" @$(PROG_ECHO) -e "\t\t- Dossier de destination des images : $(dest_image)" @$(PROG_ECHO) -e "\t\t- Image par défaut : $(image_defaut)" - @$(PROG_ECHO) -e "\t\t- Dossier de destination global : $(DESTINATION)" - @$(PROG_SH) $(script_contenu) $(categ) $(contenu) $(ext) $(composants) $(categ_deb) $(categ_fin) $(elem) $(image) $(dest_image) $(image_defaut) $(DESTINATION) + @$(PROG_ECHO) -e "\t\t- Dossier de destination global : $(CIBLE)" + @$(PROG_SH) $(script_contenu) $(CATEGORIES) $(contenu) $(ext) $(composants) $(categ_deb) $(categ_fin) $(elem) $(image) $(dest_image) $(image_defaut) $(CIBLE) # création de la page d'index index: $(INDEX) -$(INDEX): $(COMPOSANTS) $(DESTINATION)/$(CSS_NOM) $(dependances_index) $(contenu) $(DESTINATION)/$(STYLE) +$(INDEX): $(COMPOSANTS) $(CIBLE)/$(CSS_NOM) $(dependances_index) $(contenu) $(CIBLE)/$(STYLE) @$(PROG_ECHO) -e "Création de la page de garde…" # entete @$(PROG_ECHO) -e "\t…insertion de l'entête" @@ -156,7 +156,7 @@ $(INDEX): $(COMPOSANTS) $(DESTINATION)/$(CSS_NOM) $(dependances_index) $(contenu $(INDEX) @$(PROG_ECHO) -e "\t …contenu modifié avec succès !" # introduction (SI la variable INTRO est remplie) - $(if $(INTRO), @cat $(INTRO) >> $(INDEX); $(PROG_ECHO) -e "\t…insertion de l'introduction" || exit 1) + $(if $(INTRO), @cat $(INTRO_ADDR) >> $(INDEX); $(PROG_ECHO) -e "\t…insertion de l'introduction" || exit 1) # contenu @$(PROG_ECHO) -e "\t…insertion du contenu" @$(PROG_CAT) $(contenu) >> $(INDEX) @@ -173,6 +173,6 @@ $(INDEX): $(COMPOSANTS) $(DESTINATION)/$(CSS_NOM) $(dependances_index) $(contenu # nettoyage des fichiers générés clean: @$(PROG_ECHO) -e "Nettoyage des fichiers en cours…" - @$(PROG_RM) -rf $(DESTINATION) + @$(PROG_RM) -rf $(CIBLE) @$(PROG_RM) -f $(contenu) @$(PROG_ECHO) -e " …terminé." diff --git a/LISMOI b/LISMOI index 600d136..0408dec 100644 --- a/LISMOI +++ b/LISMOI @@ -180,7 +180,7 @@ où : - TITRE_IMG : est le titre de notre image (si jamais l'image ne s'affiche pas) - DESC_IMG : est la description de l'image au passage de la souris -Des exemples sont donnés dans le dossier categ. À vous de les modifier comme +Des exemples sont donnés dans le dossier 'categ'. À vous de les modifier comme bon vous semble. Astuce : Pour ordonner les catégories dans la page résultante, ajouter des chiffres devant chacun de vos fichiers catégories. Par exemple : @@ -207,7 +207,7 @@ Dans un fichier catégorie, on donnera donc l'adresse suivante comme adresse de apps/clock.png -Pour un exemple plus criant, je vous propose de lire le fichier suivante : +Pour un exemple plus criant, je vous propose de lire le fichier suivant : categ/education.txt @@ -222,11 +222,11 @@ langage HTML pour permettre un affichage correct de ce que vous voulez. Par défaut cet élément n'est pas activé. Pour l'activer il suffit de changer la ligne suivante dans le fichier 'configrc' : - #INTRO = $(COMPOSANTS)/introduction.html + #INTRO = introduction.html par - INTRO = $(COMPOSANTS)/introduction.html + INTRO = introduction.html Vous l'aurez compris, il suffit d'enlever le premier dièse '#' du début de ligne. @@ -286,7 +286,7 @@ Le fichier 'configrc' contient un ensemble de variables qui sont utiles pour personnaliser la page de résultat. Voici une liste et la description attachée pour chacun des éléments modifiable/utilisable dans le fichier 'configrc' : -DESTINATION : nom du dossier dans lequel ira le résultat de la génération +CIBLE : nom du dossier dans lequel ira le résultat de la génération INDEX : adresse, à partir du répertoire dans lequel est contenu le fichier 'GNUmakefile', dans lequel se trouvera le fichier résultant. Cela donne une @@ -316,6 +316,9 @@ MENU : Cf. Chapitre 'Le fichier menu.html' INTRO : Cf. Chapitre 'Le fichier introduction.html' +INTRO_ADDR : Adresse exacte du fichier d'introduction de la future page +PorteAil. + Quelques autres éléments sont modifiables : les composants. Les valeurs attachées à ces composants sont les suivantes : @@ -324,8 +327,8 @@ attachées à ces composants sont les suivantes : - contenu_fin : fichier contenu_fin.html - script_contenu : script bash permettant de générer les catégories - contenu : fichier temporaire possédant le contenu à insérer dans la page -- categ : désigne le dossier dans lequel se trouve l'ensemble des descriptions des catégories et des éléments se trouvant à l'intérieur de chacune d'elle -- ext : extension des fichiers contenus dans le dossier 'categ' (précédemment renseigné) qui contiendra la description de base de chacune des catégories et de ses éléments. Cf. Chapitre "Le dossier 'categ'" +- CATEGORIES : désigne le dossier dans lequel se trouve l'ensemble des descriptions des catégories et des éléments se trouvant à l'intérieur de chacune d'elle +- ext : extension des fichiers contenus dans le dossier CATEGORIES (précédemment renseigné) qui contiendra la description de base de chacune des catégories et de ses éléments. Cf. Chapitre "Le dossier 'categ'" - image : dossier contenant quelques images pour les éléments de chaque catégorie. Toutes les images ne seront pas utilisées - dest_image : dossier dans lequel seront mises les images choisies dans chacune des catégories (fichiers décrivant les catégories) - image_defaut : image par défaut utilisée si aucune autre image n'est trouvée diff --git a/configrc.exemple b/configrc.exemple index d03f7a0..47138cd 100644 --- a/configrc.exemple +++ b/configrc.exemple @@ -9,8 +9,8 @@ STYLE = noir.css # Code HTML du menu (par défaut dans le dossier COMPOSANTS) #MENU = $(COMPOSANTS)/menu.html # Code HTML de l'introduction (par défaut dans le dossier COMPOSANTS) -INTRO = $(COMPOSANTS)/introduction.html -DESTINATION = porteail +INTRO = introduction.html +CIBLE = porteail ########################### ## Configuration avancée ## @@ -26,6 +26,19 @@ ext = txt # image par défaut (au cas où aucune ne serait trouvée) image_defaut = generique.png +##--[[ dossiers ]]--## + +# Dossier contenant les éléments composants votre page +COMPOSANTS = composants +# dossier contenant le détail des catégories +CATEGORIES = categ +# dossier contenant les images +image = img +# dossier de destination des images +dest_image = image +# dossier contenant les morceaux de la page résultante +composants = ./$(COMPOSANTS) + ##--[[ style ]]--## CSS_SANS_MENU = sans_menu.css @@ -37,22 +50,10 @@ else dependances_css = style/$(CSS_AVEC_MENU) endif -##--[[ dossiers ]]--## - -# Dossier contenant les éléments composants votre page -COMPOSANTS = composants -# dossier contenant le détail des catégories -categ = categ -# dossier contenant les images -image = img -# dossier de destination des images -dest_image = image -# dossier contenant les morceaux de la page résultante -composants = ./$(COMPOSANTS) - ##--[[ adresses ]]--## -INDEX = $(DESTINATION)/index.xhtml +INTRO_ADDR = $(COMPOSANTS)/$(INTRO) +INDEX = $(CIBLE)/index.xhtml entete = $(COMPOSANTS)/entete.html enqueue = $(COMPOSANTS)/enqueue.html contenu_fin = $(COMPOSANTS)/contenu_fin.html