Le site Web est généré à l'aide de Hugo. Hugo est un générateur de sites statiques, utilisant des sites et des modèles Markdown pour compiler des sites Web statiques.
Clonez le projet : git clone https://github.com/judaicalink/judaicalink-site.git
.
Allez dans le répertoire : cd judaicalink-site
.
Installez Hugo (voir ci-dessous).
Téléchargez simplement l'exécutable Hugo (Version actuellement utilisée sur le serveur : 0.104.3).
Vous devez ajouter Hugo dans vos variables d'environnement sous PATH :
Par exemple : C:UtilisateursVotreNomhugo_0.31.1_Windows-64bit
Pour vérifier si l'installation a fonctionné, vous pouvez taper hugo help
dans votre invite de commande. Vous devriez obtenir une réponse contenant plusieurs commandes que Hugo est capable d'exécuter.
-> Pour des instructions plus détaillées, consultez le guide fourni par Hugo dans le guide d'installation pour Windows.
Dans votre invite de commande, accédez au répertoire principal du référentiel cloné (où se trouve ce fichier README.md) et exécutez la commande hugo server
.
Par exemple : C:UtilisateursVotreNomjudaicalink-site>hugo serveur
Ensuite, vous pouvez parcourir le site Web localement sous http://localhost:1313
Ubuntu : sudo apt update && sudo apt install hugo
.
Arch : sudo pacman -S hugo
.
Fedora, RedHat : sudo pacman -S hugo
Vérifiez l'installation avec : hugo --version
.
Installez Hugo avec Brew brew install hugo
.
Vérifiez l'installation avec : hugo --version
.
Servez Hugo directement sur votre machine locale avec hugo serve
. Il ouvre un serveur Web. Vérifiez le terminal pour le lien et le chemin.
Vérifiez également les erreurs.
Si vous souhaitez compiler la source et générer un site en direct, exécutez simplement hugo
.
Cela génère les fichiers static
et le dossier public
.
Si vous souhaitez compiler les sites dans un dossier spécifique, utilisez simplement : hugo -d <your-destination>
.
Vous pouvez désormais servir les pages avec un serveur Web comme Apache2 ou NGINX.
Copiez les dossiers public
et static
dans le répertoire de service ou ajoutez les répertoires dans sites-available
à la directive d'emplacement.
N'oubliez pas non plus de servir le dossier static
.
Récupérez et extrayez simplement la dernière version du site, git fetch
et git pull
. Ensuite, compilez à nouveau le site.
Si vous souhaitez créer une image Docker, clonez le référentiel et exécutez docker build -t judaicalink-site .
dans le répertoire racine du référentiel.
Pour exécuter l'image, utilisez docker run -d -p 80:80 judaicalink-site
.
Vérifiez si la syntaxe Markdown est correcte.
Surveillez la console pour détecter les erreurs si vos modifications ne s'affichent pas comme prévu.
Servez le site localement et vérifiez les modifications.
Videz le cache de votre navigateur.
Lorsque vous avez terminé, validez vos modifications dans votre référentiel forké et envoyez la pull request.