[AJ] Variables du fichier GNUMakefile sont désormais externalisées

This commit is contained in:
Olivier DOSSMANN 2012-02-09 15:38:05 +01:00
parent 1e2b79b381
commit 0c30bf5697
4 changed files with 50 additions and 36 deletions

View File

@ -25,30 +25,8 @@
.PHONY: clean .PHONY: clean
## VARIABLES ## ## VARIABLES ##
## configuration # configuration
DESTINATION = porteail include configrc
INDEX = $(DESTINATION)/index.xhtml
CSS_SANS_MENU = bicolore_sans_menu.css
CSS_AVEC_MENU = bicolore_avec_menu.css
CSS_NOM = defaut.css
TITRE = Titre par défaut
ACCUEIL = Accueil - $(TITRE)
DOSSIER_HTML = composants
## divers
#MENU = $(DOSSIER_HTML)/menu.html
INTRO = $(DOSSIER_HTML)/introduction.html
## utiles pour le makefile
ifndef $(MENU)
dependances_css = style/$(CSS_SANS_MENU)
else
dependances_css = style/$(CSS_AVEC_MENU)
endif
entete = $(DOSSIER_HTML)/entete.html
enqueue = $(DOSSIER_HTML)/enqueue.html
contenu_fin = $(DOSSIER_HTML)/contenu_fin.html
dependances_index = $(entete) $(enqueue) $(contenu_fin)
script_contenu = creation_categ.sh
contenu = categories.html
# programmes # programmes
PROG_ECHO = `which echo` PROG_ECHO = `which echo`
PROG_TEST = `which test` PROG_TEST = `which test`

32
LISMOI
View File

@ -70,10 +70,17 @@ Normalement ces éléments sont inclus de base dans une distribution GNU/Linux
Le programme ne requièrt aucune installation particulière. Placez le où vous Le programme ne requièrt aucune installation particulière. Placez le où vous
voudrez. voudrez.
### CONFIGURATION ###
Copiez le fichier 'configrc.exemple' (ou bien renommez le) en 'configrc'.
Sans ce fichier 'configrc' le programme ne peut pas fonctionner.
### UTILISATION ### ### UTILISATION ###
Dans sa version 0.1 le programme s'utilise via plusieurs entrées minimales : Dans sa version 0.1 le programme s'utilise via plusieurs entrées minimales :
- le fichier GNUmakefile - le fichier GNUmakefile
- le fichier configrc
- le dossier categ - le dossier categ
- le fichier composants/introduction.html - le fichier composants/introduction.html
- le fichier composants/menu.html - le fichier composants/menu.html
@ -108,6 +115,11 @@ de la page.
#--[[ GNUmakefile ]]--# #--[[ GNUmakefile ]]--#
Ce fichier contient les éléments de base pour lancer PorteAil. Aucun
changement particulier ne doit être effectué sur celui-ci.
#--[[ configrc ]]--#
Ce fichier vous permettra de changer le titre de la page PorteAil et Ce fichier vous permettra de changer le titre de la page PorteAil et
le titre affiché dans un navigateur. Ceci se fait via les deux le titre affiché dans un navigateur. Ceci se fait via les deux
lignes suivantes : lignes suivantes :
@ -117,7 +129,7 @@ Ce fichier vous permettra de changer le titre de la page PorteAil et
Par exemple pour afficher "Mon super site" sur la page PorteAil et Par exemple pour afficher "Mon super site" sur la page PorteAil et
avoir "Accueil - Mon super site" dans l'onglet du navigateur, il avoir "Accueil - Mon super site" dans l'onglet du navigateur, il
suffit de changer les lignes suivantes du fichier GNUmakefile : suffit de changer les lignes suivantes du fichier 'configrc' :
TITRE = Mon super site TITRE = Mon super site
ACCUEIL = Accueil - $(TITRE) ACCUEIL = Accueil - $(TITRE)
@ -193,7 +205,7 @@ insérer en début de la page PorteAil, il faut donc connaître un peu le
langage HTML pour permettre un affichage correct de ce que vous voulez. 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 'GNUmakefile' : changer la ligne suivante dans le fichier 'configrc' :
#INTRO = $(DOSSIER_HTML)/introduction.html #INTRO = $(DOSSIER_HTML)/introduction.html
@ -211,7 +223,7 @@ d'insérer un menu dans la page du PorteAil. Ceci est très utile si vous
voulez agrémenter le portail de tout un tas d'autres pages. voulez agrémenter le portail de tout un tas d'autres pages.
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 el fichier 'GNUmakefile' : changer la ligne suivante dans el fichier 'configrc' :
#MENU = $(DOSSIER_HTML)/menu.html #MENU = $(DOSSIER_HTML)/menu.html
@ -253,11 +265,11 @@ des éléments.
- test : fait quelques tests sur l'existence des ficheirs nécessaires pour - test : fait quelques tests sur l'existence des ficheirs nécessaires pour
la compilation de la page. la compilation de la page.
#--[[ GNUmakefile ]]--# #--[[ configrc ]]--#
Le fichier GNUmakefile contient un ensemble de variables qui sont utiles pour 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 'GNUmakefile' : 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 DESTINATION : nom du dossier dans lequel ira le résultat de la génération
@ -274,9 +286,9 @@ avec un menu. À noter que le fichier doit se trouver dans le dossier
CSS_NOM : nom de la feuille de style dans le résultat final CSS_NOM : nom de la feuille de style dans le résultat final
TITRE : Cf. Chapitre 'GNUmakefile' ci-avant. TITRE : Cf. Chapitre 'configrc' ci-avant.
ACCUEIL : Cf. Chapitre 'GNUmakefile' ci-avant. ACCUEIL : Cf. Chapitre 'configrc' ci-avant.
DOSSIER_HTML : nom du dossier contenant l'ensemble des composants. Cf Chapitre DOSSIER_HTML : nom du dossier contenant l'ensemble des composants. Cf Chapitre
sur les composants 'Les composants'. sur les composants 'Les composants'.
@ -321,7 +333,7 @@ Le fichier 'creation_categ.sh' permet de générer le corps de la page.
et les éléments associés, puis il va tout déposer dans un fichier HTML et les éléments associés, puis il va tout déposer dans un fichier HTML
prévu à cet effet. prévu à cet effet.
Comme pour le fichier 'GNUmakefile', il y a des lignes à changer si vous Comme pour le fichier 'configrc', il y a des lignes à changer si vous
voulez personnaliser le script. voulez personnaliser le script.
Par exemple on peut changer le dossier d'entrée (la source) et le fichier Par exemple on peut changer le dossier d'entrée (la source) et le fichier
@ -352,7 +364,7 @@ Le dossier 'style' est prévu pour contenir l'ensemble des feuilles de style
disponible pour l'apparence de notre page PorteAil. disponible pour l'apparence de notre page PorteAil.
Déposez donc ici vos feuille de style et changez la variable 'CSS_AVEC_MENU' Déposez donc ici vos feuille de style et changez la variable 'CSS_AVEC_MENU'
et 'CSS_SANS_MENU' du fichier 'GNUmakefile' (Cf. Chapitre 'GNUmakefile'). et 'CSS_SANS_MENU' du fichier 'configrc' (Cf. Chapitre 'configrc').
#--[[ Le dossier img ]]--# #--[[ Le dossier img ]]--#

2
TACHES
View File

@ -29,7 +29,6 @@ DESTDIR
- compléter l'adresse des images pour l'insertion dans le contenu - compléter l'adresse des images pour l'insertion dans le contenu
- vérifier l'existence de l'image avant de l'ajouter - vérifier l'existence de l'image avant de l'ajouter
- si pas d'image ou image inexistante, mettre une image générique - si pas d'image ou image inexistante, mettre une image générique
- voir si possibilité de faire un "source configrc" pour inclure les variables modifiables du programme, histoire de n'éditer que le fichier 'configrc' du programme
- trouver une méthode qui permet de récupérer toujours les dernières versions sources sans écraser la version que nous avons. configrc.exemple par exemple, à copier en configrc ;) - trouver une méthode qui permet de récupérer toujours les dernières versions sources sans écraser la version que nous avons. configrc.exemple par exemple, à copier en configrc ;)
- Prévoir un script d'export des données entrées par l'utilisateur s'il utilise un dépôt git OU trouver un système de mise à jour du logiciel - Prévoir un script d'export des données entrées par l'utilisateur s'il utilise un dépôt git OU trouver un système de mise à jour du logiciel
@ -97,3 +96,4 @@ des éléments
- créer un site internet parlant de PorteAil avec une page générée par PorteAil comportant l'ensemble des sites utilisant Porteail - créer un site internet parlant de PorteAil avec une page générée par PorteAil comportant l'ensemble des sites utilisant Porteail
- Essayer de faire en sorte que le lien soit écarté jusqu'aux bords de tout l'élément afin que le clic sur l'élément renvoie sur la page - Essayer de faire en sorte que le lien soit écarté jusqu'aux bords de tout l'élément afin que le clic sur l'élément renvoie sur la page
- Faire la feuille de style bleue pour le site avec un menu - Faire la feuille de style bleue pour le site avec un menu
- Voir si possibilité de faire un "source configrc" pour inclure les variables modifiables du programme, histoire de n'éditer que le fichier 'configrc' du programme

24
configrc.exemple Normal file
View File

@ -0,0 +1,24 @@
## CONFIGURATION
DESTINATION = porteail
INDEX = $(DESTINATION)/index.xhtml
CSS_SANS_MENU = bicolore_sans_menu.css
CSS_AVEC_MENU = bicolore_avec_menu.css
CSS_NOM = defaut.css
TITRE = Titre par défaut
ACCUEIL = Accueil - $(TITRE)
DOSSIER_HTML = composants
## divers
#MENU = $(DOSSIER_HTML)/menu.html
INTRO = $(DOSSIER_HTML)/introduction.html
## utiles pour le makefile
ifndef $(MENU)
dependances_css = style/$(CSS_SANS_MENU)
else
dependances_css = style/$(CSS_AVEC_MENU)
endif
entete = $(DOSSIER_HTML)/entete.html
enqueue = $(DOSSIER_HTML)/enqueue.html
contenu_fin = $(DOSSIER_HTML)/contenu_fin.html
dependances_index = $(entete) $(enqueue) $(contenu_fin)
script_contenu = creation_categ.sh
contenu = categories.html