Glossaire des Commandes Essentielles

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 et hackathons

Créer un nouveau projet (méthode directe)

./scripts/new_project.sh "Titre de votre projet"

Créer un nouveau hackathon (méthode directe)

./scripts/new_hackathon.sh "Titre du hackathon"

Créer via les alias

# Configuration préalable des alias
source setup_aliases.sh

# Création du projet
new_project "Titre de votre projet"

# Création du hackathon
new_hackathon "Titre du hackathon"

Création de contenus Formation IA

Créer un nouveau mini-cours Formation IA (méthode directe)

./scripts/new_formation_module.sh "Titre du mini-cours"

Créer un nouveau mini-cours Formation IA depuis PowerShell

.\scripts\new_formation_module.ps1 "Titre du mini-cours"

Créer un nouveau mini-cours Formation IA (via l’alias)

# Configuration préalable des alias
source setup_aliases.sh

# Création du mini-cours
new_formation_module "Titre du mini-cours"

Ce que fait la commande

  • crée un fichier daté dans _formation_ia/
  • génère un slug à partir du titre
  • utilise le template _templates/new_formation_module.md
  • remplit automatiquement title, date et translation_key
  • initialise le contenu comme mini-cours francophone avec content_type: mini-cours

Traduction FR → EN (semi-automatique)

Générer le squelette EN depuis un article FR

python scripts/generate_en_translation.py _posts/AAAA-MM-JJ-titre-fr.md

Générer le squelette EN depuis un projet FR

python scripts/generate_en_translation.py _projects/AAAA-MM-JJ-titre-fr.md

Vérifier sans écrire de fichier (dry-run)

python scripts/generate_en_translation.py _posts/AAAA-MM-JJ-titre-fr.md --dry-run

Ce que fait la commande

  • crée le fichier EN correspondant dans le bon dossier (_posts ou _projects)
  • conserve les métadonnées utiles
  • force lang: en
  • conserve/génère translation_key
  • génère un permalink sous /en/...
  • bloque si une traduction EN existe déjà (doublon fichier ou translation_key)

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 article
  • new_project "Titre" : Créer un nouveau projet
  • new_formation_module "Titre" : Créer un mini-cours Formation IA
  • jekyll_serve : Lancer le serveur local avec rechargement automatique

Structure du projet

  • _posts/ : Contient tous les articles
  • _projects/ : Contient tous les projets
  • _formation_ia/ : Contient les modules et ressources Formation IA
  • _templates/ : Contient les templates pour les nouveaux articles et projets
  • scripts/ : Contient les scripts utilitaires
  • setup_aliases.sh : Script pour configurer les alias

Bonnes pratiques

  1. Toujours vérifier que le serveur est en cours d’exécution avant de créer un nouvel article
  2. Utiliser les alias pour gagner du temps
  3. Vérifier régulièrement la syntaxe avec jekyll doctor
  4. Nettoyer le cache si des problèmes de génération surviennent