Cosmetic-Web-Front

Cosmetic-Web-Front est le module de Cosmetic qui affiche les pages web générées par d'autres modules de Cosmetic (comme Cosmetic-Vos-Droits, Cosmetic-Vie-Publique, Cosmetic-Your-Europe?)

Licence et copyright

Cosmetic-Web-Front est un logiciel libre sous licence  GNU Affero General Public License version 3 ou supérieure.

Copyright © 2008, 2009  Easter-eggs

Téléchargement

Vous pouvez récupérer les sources de la dernière version :

• soit en utilisant  Mercurial : hg clone http://hg.infos-pratiques.org/cosmetic-web-front
• soit en naviguant dans  l'interface web du dépôt Mercurial
• soit en récupérant une archive ("snapshot") depuis cette même interface web.

Attention : L'application Cosmetic-Web-Front évolue fréquemment pour s'adapter aux changements qui surviennent dans les fichiers produits par les différentes sources de données publiques. Il est donc nécessaire de la mettre à jour régulièrement, de préférence quotidiennement.

Installation

Cosmetic-Web-Front dépend des logiciels suivants, qui doivent être installés séparément :

• Comarquage
• Cosmetic2
• Cosmetic-Vos-Droits
• Cosmetic-Vie-Publique
• Cosmetic-Your-Europe?
•  lxml
•  Mako
• Metanol
•  PostgreSQL
•  Pylons
•  Python
•  PyStemmer
•  setuptools
•  simplejson
•  SQLAlchemy
• Territoria

Pour connaître la liste précise des dépendances, ainsi que les versions nécessaires, consulter le  fichier setup.py (variable install_requires notamment).

Après avoir téléchargé les sources et installé les logiciels ci-dessus, l'installation de Cosmetic-Web-Front se fait de la manière suivante :

cd cosmetic-web-front
sudo ./setup.py install

Configuration

Modifier le fichier de configuration development.ini en fonction de la base de données utilisée pour Cosmetic.

Par exemple, si la base de données utilisée est PostgreSQL et que la base de données s'appelle cosmetic, que l'utilisateur s'appelle cosmetic et que son mot de passe est cosmetic, il faut remplacer cette ligne par :

sqlalchemy.url = postgresql://cosmetic:cosmetic@localhost:5432/cosmetic
sqlalchemy.convert_unicode = 1

Modifier le même fichier development.ini pour s'assurer que les chemins vers les répertoires contenant les fichiers HTML sont corrects :

vie_publique_dir = %(here)s/../vie-publique-html-semantique
vos_droits_dir = %(here)s/../vosdroits-html

Création des tables propres à Cosmetic-Web-Front dans la base de données :

paster setup-app development.ini

Lancement de l'application web :

paster serve --reload development.ini

Utilisation

Initilisation des variables :

cd vos-droits-xml
export VOS_DROITS_XML_PATH=`pwd`
cd -
cd cosmetic-web-front
export WEB_CONFIG_PATH=`pwd`/development.ini
cd -

Récupération des redirections

Quand des dossiers importants de  Service-public.fr sont refondus et changent d'URL, la Documentation française met en place des redirections, afin que les utilisateurs n'arrivent pas sur un message d'erreur "404: Page non trouvée".

Ces redirections ne figurent pas dans les fichiers XML et Cosmetic les recherche donc directement sur le site  Service-public.fr :

python -m cosmetic2.vosdroits.scripts.find_vos_droits_redirections ${WEB_CONFIG_PATH} ${VOS_DROITS_XML_PATH}

Importation des fichiers "Vos droits" en base

L'application Cosmetic-Vos-Droits a auparavant converti les fichiers XML "Vos droits" en pages HTML. Il est maintenant nécessaire de les indexer en base (notamment pour permettre la recherche textuelle) :

python -m cosmeticwebfront.scripts.import_vos_droits_html ${WEB_CONFIG_PATH}

Idem pour les pages HTML converties par Cosmetic-Vie-Publique :

python -m cosmeticwebfront.scripts.import_vie_publique_html ${WEB_CONFIG_PATH}

Test

C'est terminé, il ne reste plus qu'à tester l'application avec son serveur web à l'URL indiquée au lancement de l'application web (cf ci-dessus).