Cosmetic-Vie-Publique

  1. Cosmetic-Vie-Publique
    1. Licence et copyright
    2. Téléchargement
    3. Installation
    4. Utilisation
      1. Téléchargement des pages HTML de Vie publique
      2. Conversion des fichiers HTML en HTML sémantique
      3. Résultat
    5. Plus d'informations

Cosmetic-Vie-Publique est le module de Cosmetic qui télécharge les pages HTML de  Vie-publique.fr et les convertit en pages HTML adaptées au comarquage.

Licence et copyright

Cosmetic-Vie-Publique 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 :

Attention : L'application Cosmetic-Vie-Publique évolue fréquemment pour s'adapter aux changements qui surviennent dans les pages HTML de  Vie-publique.fr. Il est donc nécessaire de la mettre à jour régulièrement, de préférence quotidiennement.

Installation

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

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-Vie-Publique se fait de la manière suivante : 

cd cosmetic-vie-publique
sudo ./setup.py install

Utilisation

Attention: Les traitements énumérés ci-dessous doivent être effectués quotidiennement, afin que les fichiers HTML produits par Cosmetic soient à jour.

Téléchargement des pages HTML de Vie publique

Création d'un répertoire destiné à recevoir les pages HTML du site  Vie-publique.fr: 

mkdir vie-publique-html
cd vie-publique-html
export VIE_PUBLIQUE_HTML_PATH=`pwd`
cd -

Téléchargement des fichiers : 

python -m cosmetic2.viepublique.scripts.download_vie_publique ${VIE_PUBLIQUE_HTML_PATH}

Conversion des fichiers HTML en HTML sémantique

Cette étape, la plus importante de Cosmetic-Vie-Publique, consiste à convertir les fichiers HTML de Vie-publique.fr en fichiers HTML valides, sémantiques et d'un format adapté à Cosmetic-Web-Front. Les fichiers HTML produits sont "nus" : ils contiennent toutes les informations importantes figurant dans les fichiers HTML originaux, mais sans aucune information de mise en forme (pas de CSS), ni de JavaScript?, ni de contenu local.

Avant de convertir les fichiers, il est nécessaire de créer un répertoire destiné à contenir les fichiers HTML sémantiques : 

mkdir vie-publique-html-semantique
cd vie-publique-html-semantique
export VIE_PUBLIQUE_HTML_SEMANTIQUE_PATH=`pwd`
cd -

La conversion proprement dite peut alors être lancée : 

python -m cosmetic2.viepublique.scripts.convert_vie_publique ${VIE_PUBLIQUE_HTML_PATH} ${VIE_PUBLIQUE_HTML_SEMANTIQUE_PATH}

Résultat

Une fois toutes ses étapes terminées vous obtenez une arborescence de fichiers HTML, auxquels il manque encore :

  • la personnalisation finale
  • la mise en page et les CSS
  • etc

Tous ces traitements sont faits dans Cosmetic-Web-Front, module d'affichage des pages web.

Plus d'informations

Pour plus d'informations, vous pouvez consulter et/ou participer à la liste de diffusion Infos-Pratiques.