[MàJ] Changements dans le fichier de configuration :

* Ajout de INTRO_ADDR pour l'adresse exacte du fichier d'introduction
  * INTRO est désormais uniquement le nom du fichier
  * DESTINATION -> CIBLE
  * categ -> CATEGORIES
  * Adaptation du Makefile en fonction des changements effectués
  * Mise à jour de la documentation
master
Olivier DOSSMANN 2012-02-20 16:42:29 +01:00
parent 0904ebabcd
commit 60306fdb2a
3 changed files with 43 additions and 39 deletions

View File

@ -29,7 +29,7 @@
include configrc include configrc
## autre configurations ## autre configurations
dependances_index = $(entete) $(enqueue) $(contenu_fin) dependances_index = $(entete) $(enqueue) $(contenu_fin)
SOURCE = $(categ)/*.$(ext) SOURCE = $(CATEGORIES)/*.$(ext)
# programmes # programmes
PROG_ECHO = `which echo` PROG_ECHO = `which echo`
PROG_TEST = `which test` PROG_TEST = `which test`
@ -93,39 +93,39 @@ test:
$(if $(error_find), @$(PROG_ECHO) -e "\t\tfind : MANQUANT." ; exit 1) $(if $(error_find), @$(PROG_ECHO) -e "\t\tfind : MANQUANT." ; exit 1)
$(if $(error_sort), @$(PROG_ECHO) -e "\t\tsort : 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) $(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 img || mkdir img
@$(PROG_TEST) -d $(categ) || mkdir $(categ) @$(PROG_TEST) -d $(CATEGORIES) || mkdir $(CATEGORIES)
@$(PROG_TEST) -d style || mkdir style @$(PROG_TEST) -d style || mkdir style
@$(PROG_ECHO) -e "\t…option introduction dans la page" @$(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") $(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)" @$(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_TEST) -f $(MENU) || exit 1)
$(if $(MENU), @$(PROG_ECHO) -e "\t\t-> activée", @$(PROG_ECHO) -e "\t\t-> désactivée") $(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_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_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é." @$(PROG_ECHO) -e " …terminé."
# création du fichier CSS # création du fichier CSS
$(DESTINATION)/$(CSS_NOM): $(dependances_css) $(CIBLE)/$(CSS_NOM): $(dependances_css)
@$(PROG_ECHO) -e "Création du fichier 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." @$(PROG_ECHO) -e " …terminée."
# création du fichier CSS de couleur # 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_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." @$(PROG_ECHO) -e " …terminée."
# création du fichier $(contenu) # création du fichier $(contenu)
$(contenu): $(script_contenu) $(SOURCE) $(image_defaut) $(contenu): $(script_contenu) $(SOURCE) $(image_defaut)
@$(PROG_SED) -i "s/DEBUG=1/DEBUG=0/g" $(script_contenu) @$(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 "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- Destination temporaire du contenu : $(contenu)"
@$(PROG_ECHO) -e "\t\t- Extension des fichiers à lire : $(ext)" @$(PROG_ECHO) -e "\t\t- Extension des fichiers à lire : $(ext)"
@$(PROG_ECHO) -e "\t\t- Dossier ayant les composants de la page : $(composants)" @$(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 contenant les images sources : $(image)"
@$(PROG_ECHO) -e "\t\t- Dossier de destination des images : $(dest_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- Image par défaut : $(image_defaut)"
@$(PROG_ECHO) -e "\t\t- Dossier de destination global : $(DESTINATION)" @$(PROG_ECHO) -e "\t\t- Dossier de destination global : $(CIBLE)"
@$(PROG_SH) $(script_contenu) $(categ) $(contenu) $(ext) $(composants) $(categ_deb) $(categ_fin) $(elem) $(image) $(dest_image) $(image_defaut) $(DESTINATION) @$(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 # création de la page d'index
index: $(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…" @$(PROG_ECHO) -e "Création de la page de garde…"
# entete # entete
@$(PROG_ECHO) -e "\t…insertion de l'entête" @$(PROG_ECHO) -e "\t…insertion de l'entête"
@ -156,7 +156,7 @@ $(INDEX): $(COMPOSANTS) $(DESTINATION)/$(CSS_NOM) $(dependances_index) $(contenu
$(INDEX) $(INDEX)
@$(PROG_ECHO) -e "\t …contenu modifié avec succès !" @$(PROG_ECHO) -e "\t …contenu modifié avec succès !"
# introduction (SI la variable INTRO est remplie) # 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 # contenu
@$(PROG_ECHO) -e "\t…insertion du contenu" @$(PROG_ECHO) -e "\t…insertion du contenu"
@$(PROG_CAT) $(contenu) >> $(INDEX) @$(PROG_CAT) $(contenu) >> $(INDEX)
@ -173,6 +173,6 @@ $(INDEX): $(COMPOSANTS) $(DESTINATION)/$(CSS_NOM) $(dependances_index) $(contenu
# nettoyage des fichiers générés # nettoyage des fichiers générés
clean: clean:
@$(PROG_ECHO) -e "Nettoyage des fichiers en cours…" @$(PROG_ECHO) -e "Nettoyage des fichiers en cours…"
@$(PROG_RM) -rf $(DESTINATION) @$(PROG_RM) -rf $(CIBLE)
@$(PROG_RM) -f $(contenu) @$(PROG_RM) -f $(contenu)
@$(PROG_ECHO) -e " …terminé." @$(PROG_ECHO) -e " …terminé."

17
LISMOI
View File

@ -180,7 +180,7 @@ où :
- TITRE_IMG : est le titre de notre image (si jamais l'image ne s'affiche pas) - 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 - 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. 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 : 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 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 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 Par défaut cet élément n'est pas activé. Pour l'activer il suffit de
changer la ligne suivante dans le fichier 'configrc' : changer la ligne suivante dans le fichier 'configrc' :
#INTRO = $(COMPOSANTS)/introduction.html #INTRO = introduction.html
par par
INTRO = $(COMPOSANTS)/introduction.html INTRO = introduction.html
Vous l'aurez compris, il suffit d'enlever le premier dièse '#' du début de Vous l'aurez compris, il suffit d'enlever le premier dièse '#' du début de
ligne. 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 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' : 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 INDEX : adresse, à partir du répertoire dans lequel est contenu le fichier
'GNUmakefile', dans lequel se trouvera le fichier résultant. Cela donne une '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 : 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 Quelques autres éléments sont modifiables : les composants. Les valeurs
attachées à ces composants sont les suivantes : attachées à ces composants sont les suivantes :
@ -324,8 +327,8 @@ attachées à ces composants sont les suivantes :
- contenu_fin : fichier contenu_fin.html - contenu_fin : fichier contenu_fin.html
- script_contenu : script bash permettant de générer les catégories - script_contenu : script bash permettant de générer les catégories
- contenu : fichier temporaire possédant le contenu à insérer dans la page - 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 - 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 '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'" - 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 - 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) - 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 - image_defaut : image par défaut utilisée si aucune autre image n'est trouvée

View File

@ -9,8 +9,8 @@ STYLE = noir.css
# Code HTML du menu (par défaut dans le dossier COMPOSANTS) # Code HTML du menu (par défaut dans le dossier COMPOSANTS)
#MENU = $(COMPOSANTS)/menu.html #MENU = $(COMPOSANTS)/menu.html
# Code HTML de l'introduction (par défaut dans le dossier COMPOSANTS) # Code HTML de l'introduction (par défaut dans le dossier COMPOSANTS)
INTRO = $(COMPOSANTS)/introduction.html INTRO = introduction.html
DESTINATION = porteail CIBLE = porteail
########################### ###########################
## Configuration avancée ## ## Configuration avancée ##
@ -26,6 +26,19 @@ ext = txt
# image par défaut (au cas où aucune ne serait trouvée) # image par défaut (au cas où aucune ne serait trouvée)
image_defaut = generique.png 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 ]]--## ##--[[ style ]]--##
CSS_SANS_MENU = sans_menu.css CSS_SANS_MENU = sans_menu.css
@ -37,22 +50,10 @@ else
dependances_css = style/$(CSS_AVEC_MENU) dependances_css = style/$(CSS_AVEC_MENU)
endif 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 ]]--## ##--[[ adresses ]]--##
INDEX = $(DESTINATION)/index.xhtml INTRO_ADDR = $(COMPOSANTS)/$(INTRO)
INDEX = $(CIBLE)/index.xhtml
entete = $(COMPOSANTS)/entete.html entete = $(COMPOSANTS)/entete.html
enqueue = $(COMPOSANTS)/enqueue.html enqueue = $(COMPOSANTS)/enqueue.html
contenu_fin = $(COMPOSANTS)/contenu_fin.html contenu_fin = $(COMPOSANTS)/contenu_fin.html