https://consultation.etalab.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.
https://consultation.etalab.gouv.fr s'adresse avant tout aux administrations française susceptibles de lancer des consulations.
Le nom de domaine consultation.etalab.gouv.fr
pointe vers un catalogue d'outils et de cas d'usage.
Les sous-domaines en *.consultation.etalab.gouv.fr
hébergent les outils catalogués sur consultation.etalab.gouv.fr
et maintenus par la DINSIC.
Il est nécessaire de récupérer les sources avec la commande :
git clone https://github.com/consultation-gouv/consultation.gouv.fr
cd consultation.gouv.fr
Il existe ensuite deux manières de lancer le site sur sa machine :
Ces deux méthodes sont indépendantes et détaillées ci-dessous.
Le site utilise Jekyll, un générateur de site statique en Ruby.
2.3
gem install bundle
bundle install
pour installer toutes les dépendances nécessairesbundle 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-compose up
. Il suffit de se rendre sur l'URL indiquée à l'exécution de la commande.Le site est hébergé sur un VPS.
La gestion du contenu du site se fait manuellement, en clonant le dépôt et en éditant les fichiers nécessaires (l'outil en ligne Forestry.io ne supporte plus, depuis mi-2018, l'édition en ligne de contenu HTML).
Les déploiements sont quant à eux automatisés via CircleCI: ce dernier démarre un build dès qu'une modification est poussée sur GitHub. Après avoir construit le site statique, il est potentiellement déployé :
Les modifications centrales, n'ayant pas trait à du contenu, doivent donc être préférentiellement réalisées sur master, afin de bénéficier de la validation automatique.
Une fois le contenu et l'aspect du site validés sur le site de pré-production, les mises en production s'effectuent simplement en créant une PullRequest GitHub, depuis la branche pprod vers la branche production :
2017-2019 DINSIC/Etalab
Le code source de ce dépôt est publié sous licence MIT (voir LICENSE), à l'exception du module JSunidecode qui est publié sous licence GNU GPL.