---

TheAfriForge

TheAfriForge est un site statique multilingue (Français/Anglais) construit avec Hugo, dédié à la valorisation des initiatives africaines, à la transparence et à la collaboration.

🌍 Présentation

• Site principal : theafriforge.org
• Organisation : TheAfriForge
• Langues : Français (par défaut), Anglais (/en/)
• Code source : GitForge
• Contact : @theafriforge

🚀 Prérequis

• Hugo Extended (version récente recommandée)
• Git
• (Optionnel) Python 3 ou Node.js pour tester la build

🔧 Installation & Lancement local

git clone https://gitforge.africa/TheAfriForge/website.git
cd website
hugo server --config ./hugo.toml -D

⚙️ Configuration de l'environnement

Avant de lancer le projet, copie le fichier .env.example en .env et adapte les variables à ton contexte :

cp .env.example .env
# puis édite .env selon tes besoins

Exemple de variables (remplace par tes propres valeurs) :

# Endpoint du formulaire d’adhésion
HUGO_MEMBERSHIP_FORM_ACTION=https://exemple-endpoint

# Formbricks SDK (recommandé)
HUGO_FORMBRICKS_API_HOST=https://exemple-formbricks
HUGO_FORMBRICKS_ENV_ID=xxxxxxx
HUGO_FORMBRICKS_EVENT=membership_form_submitted
HUGO_FORMBRICKS_SDK_URL=https://exemple-formbricks/js/formbricks.umd.cjs

# Redirection après succès (optionnel)
HUGO_MEMBERSHIP_FORM_SUCCESS_PATH=/chemin-de-redirection

🐳 Utilisation avec Docker

Pour lancer le site localement avec Docker :

docker build -t theafriforge .
docker run -p 1313:1313 theafriforge

Le site sera accessible sur http://localhost:1313/.

Pour la production, adapte la commande de build selon tes besoins (voir le Dockerfile).

• Accès local : http://localhost:1313/ (FR), http://localhost:1313/en/ (EN)
• L’option -D affiche aussi les contenus en brouillon.

🏗️ Structure du projet

• content/fr/ et content/en/ : Contenus en français et anglais
• layouts/ : Templates Hugo
• static/ : Fichiers statiques (images, etc.)
• public/ : Build de production générée
• hugo.toml : Configuration principale

🛠️ Commandes utiles

• Build de production :

  hugo --config ./hugo.toml --environment production --minify
  

• Nettoyage du cache Hugo :

  rm -rf resources/_gen
  

• Forcer un autre port local :

  hugo server --config ./hugo.toml -D --port 1314
  

🐞 Dépannage

• Si hugo server retourne le code 255 :
  • Arrêter les processus Hugo : pkill -f "hugo server" || true
  • Supprimer .hugo_build.lock : rm -f .hugo_build.lock
  • Relancer le serveur.

🚢 Déploiement

Option 1 : VPS + Nginx

1. Générer la build :

   hugo --config ./hugo.toml --environment production --minify
   

2. Copier le dossier public/ sur le serveur :

   rsync -avz --delete public/ user@serveur:/var/www/theafriforge/
   

3. Configurer Nginx (voir exemple ci-dessous) :

   server {
           listen 80;
           server_name theafriforge.org www.theafriforge.org;
   
           root /var/www/theafriforge;
           index index.html;
   
           location / {
                   try_files $uri $uri/ =404;
           }
   }
   

4. Activer HTTPS (Certbot recommandé).

Option 2 : Netlify / Cloudflare Pages / Vercel

• Build command : hugo --config ./hugo.toml --environment production --minify
• Output/Publish directory : public
• Sélectionner Hugo Extended si nécessaire.

📄 Licence

Ce projet est open source, voir le dépôt pour plus d’informations. server_name theafriforge.org www.theafriforge.org;