Contribuer au site web

installation

Nécessite un terminal. Pour windows, windows subsystem for linux est conseillé.

Dépendances

Note : avec WSL, suivre les procédures "installations pour Ubuntu"

Certains paquets sont disponibles dans le "package manager" :

sudo apt install imagemagick git libvips-tools

Installer manuellement si nécessaire :

• rvm
• nodejs (version 12 recommandée)
• git lfs

Mise en place

Cloner le dépôt (prévoir une clé ssh ) :

git clone --filter=blob:none [email protected]:holusion/holusion.com

La copie peut être relativement longue (~3Go). c'est pour cette raison qu'on utilise un "blobless clone"

Ensuite, se déplacer dans le nouveau répertoire

cd holusion.com

si rvm est correctement installé, il devrait prévenir que ruby-x.x n'est pas installé. Lancer la commande proposée, puis cd ../holusion.com pour actualiser rvm.

Enfin, installer les dernières dépendances :

gem install bundler
bundle
npm install

Si ces commandes ne fonctionnent pas, vérifier l'installation des dépendances.

Modifier

Note : n'hésitez pas à étudier attentivement la structure du site si vous ne savez pas quels fichiers modifier.

Publier des modifications

holusion.com est développé sur git : un système de source control management moderne et open source. Assurez-vous d'en maitriser les principaux concepts avant tout.

Les guides de github sont très complets et faciles d'accès.

Vérification des modifications

Avant d'envoyer toute modification, il est important de vérifier les changements localement. Il existe pour cela 2 outils :

Rendu local

Il est possible de construire une réplique locale complète du site web avec la commande : ./build.sh --watch (abréviée en ./build.sh -w).

Cette commande va créer une copie locale complète de holusion.com, intégrant vos modifications locales, visible sur localhost:4000.

L'option --watch garde la commande active et va automatiquement mettre à jour le rendu quand un changement est enregistré.

Tests d'intégration

Ces tests sont automatiquement lancés côté serveur avant déploiement. Il peut être utile de les lancer localement pour vérifier si les modifications sont conformes :

./build.sh -i local
# en version étendue, plus longue :
./build.sh -i local -e