consultation.gouv.fr catalogue les outils de consultations offerts aux administrations. À chaque outil est associée une courte description fonctionnelles, une documentation technique, d'éventuelles ressources supplémentaires et des cas d'usages.

Public visé

consultation.gouv.fr s'adresse avant tout aux administrations française susceptibles de lancer des consulations NG.md#ajouter-un-service) !

Sous-domaines

Le nom de domaine consultation.gouv.fr héberge un catalogue d'outils et de cas d'usage.

Les sous-domaines en *.consultation.gouv.fr hébergent les outils cataloguées sur consultation.gouv.fr et maintenues par la DINSIC.

Installation locale

Il est nécessaire de récupérer les sources avec la commande :

git clone https://github.com/etalab/consultation-site.git
cd consultation-site

Il existe ensuite deux manières de lancer le site sur sa machine :

• Utiliser Jekyll directement.
• Utiliser Docker.

Ces deux méthodes sont indépendantes et détaillées ci-dessous.

Jekyll

Le site utilise Jekyll, un générateur de site statique en Ruby.

Dépendances

• Ruby. Il est recommandé d'utiliser un système de virtualisation comme RVM ou RbEnv. La version à utiliser est : 2.2.3
• bundle. La commande a lancer est : gem install bundle

Commandes

• bundle install pour installer toutes les dépendances nécessaires
• bundle exec jekyll serve pour lancer un serveur de développement. Il suffit de se rendre sur l'URL indiquée à l'exécution de la commande.
• bundle exec jekyll build pour générer le site dans le répertoire _site.
• bundle update pour mettre à jour les dépendances et le Gemfile.lock

Docker

Dépendances

• Docker (version > 1.10)
• docker-compose (version > 1.6)

Commandes

• docker-compose up. Il suffit de se rendre sur l'URL indiquée à l'exécution de la commande.

Hébergement

Le site est hébergé sur un VPS.

Déploiement

La gestion et le déploiement du contenu du site se fait via l'outil en ligne Forestry.io.

Forestry utilise la branche "master" du repository comme source de données pour construire un CMS à la volée.

A chaque publication de contenu depuis le CMS, Forestry compile les fichiers et les pousse dans la branche "hosting" du repository.

Voir la documentation de Forestry : http://forestry.io/docs/