Glossaire des Commandes Essentielles
Ce document répertorie les commandes essentielles pour travailler avec le projet Jekyll.
Table des Matières
Création d’articles
Créer un nouvel article (méthode directe)
./scripts/new_post.sh "Titre de votre article"
Créer un nouvel article (via le wrapper)
./scripts/new_article "Titre de votre article"
Créer un nouvel article (via l’alias)
# Configuration préalable des alias
source setup_aliases.sh
# Création de l'article
new_article "Titre de votre article"
Création de projets
Créer un nouveau projet (méthode directe)
./scripts/new_project.sh "Titre de votre projet"
Créer un nouveau projet (via l’alias)
# Configuration préalable des alias
source setup_aliases.sh
# Création du projet
new_project "Titre de votre projet"
Serveur local
Lancer le serveur Jekyll avec rechargement automatique
bundle exec jekyll serve --livereload
Lancer le serveur via l’alias
# Configuration préalable des alias
source setup_aliases.sh
# Lancement du serveur
jekyll_serve
Gestion du projet
Installer les dépendances
bundle install
Mettre à jour les dépendances
bundle update
Vérifier la syntaxe du site
bundle exec jekyll doctor
Autres commandes utiles
Construire le site
bundle exec jekyll build
Nettoyer le cache
bundle exec jekyll clean
Lancer le serveur sur un port spécifique
bundle exec jekyll serve --port 4001
Générer le site en production
JEKYLL_ENV=production bundle exec jekyll build
Configuration des alias
Pour activer les alias dans votre session actuelle :
source setup_aliases.sh
Pour activer les alias automatiquement, ajoutez cette ligne à votre .bashrc ou .zshrc :
echo "source /chemin/vers/le/projet/setup_aliases.sh" >> ~/.bashrc
source ~/.bashrc
Liste des alias disponibles
new_article "Titre": Créer un nouvel articlenew_project "Titre": Créer un nouveau projetjekyll_serve: Lancer le serveur local avec rechargement automatique
Structure du projet
_posts/: Contient tous les articles_projects/: Contient tous les projets_templates/: Contient les templates pour les nouveaux articles et projetsscripts/: Contient les scripts utilitairessetup_aliases.sh: Script pour configurer les alias
Bonnes pratiques
- Toujours vérifier que le serveur est en cours d’exécution avant de créer un nouvel article
- Utiliser les alias pour gagner du temps
- Vérifier régulièrement la syntaxe avec
jekyll doctor - Nettoyer le cache si des problèmes de génération surviennent