Cheick Oumar D
3dbacc94d3
- Created a new layout for projects with sections for hero, projects, roadmap, selection criteria, and a call to action. - Added a single page layout for individual project details, including a hero section and content area. - Introduced a brand highlight partial to emphasize "TheAfriForge" in text. - Implemented an icon partial for reusable SVG icons across the site. - Developed a site header and footer with navigation and legal links, adapting for language variations. - Enhanced the index layout with sections for hero, stats, pillars, projects, and members. - Added a development script to load environment variables and run Hugo with optional arguments.
187 lines
3 KiB
Markdown
187 lines
3 KiB
Markdown
# TheAfriForge - Guide Local et Production
|
|
|
|
Ce projet est un site statique Hugo multilingue :
|
|
- Francais par defaut sur /
|
|
- Anglais sur /en/
|
|
|
|
## 1) Prerequis
|
|
|
|
Installe les outils suivants :
|
|
- Hugo Extended (recommande: version recente)
|
|
- Git
|
|
|
|
Verification rapide :
|
|
|
|
```bash
|
|
hugo version
|
|
git --version
|
|
```
|
|
|
|
## 2) Lancer le site en local
|
|
|
|
Depuis le dossier du projet :
|
|
|
|
```bash
|
|
cd /home/choudi/Bureau/Projets/Open-Ivoire/Clients/TheAfricaForge
|
|
hugo server --config ./hugo.toml -D
|
|
```
|
|
|
|
Ensuite ouvre :
|
|
- http://localhost:1313/
|
|
- http://localhost:1313/en/
|
|
|
|
Notes :
|
|
- L'option -D permet d'afficher aussi les contenus draft.
|
|
- Si tu ne veux pas les drafts, retire -D.
|
|
|
|
## 3) Erreur frequente: hugo server exit code 255
|
|
|
|
Si le serveur ne demarre pas et retourne 255, verifie :
|
|
|
|
1. Un processus Hugo deja lance
|
|
|
|
```bash
|
|
pkill -f "hugo server" || true
|
|
```
|
|
|
|
2. Presence du lock file dans le dossier projet
|
|
|
|
```bash
|
|
rm -f .hugo_build.lock
|
|
```
|
|
|
|
3. Relance ensuite le serveur
|
|
|
|
```bash
|
|
hugo server --config ./hugo.toml -D
|
|
```
|
|
|
|
## 4) Build de production
|
|
|
|
Genere les fichiers statiques optimises dans public/ :
|
|
|
|
```bash
|
|
hugo --config ./hugo.toml --environment production --minify
|
|
```
|
|
|
|
Le dossier de sortie a deployer est :
|
|
- public/
|
|
|
|
## 5) Tester la build de production en local
|
|
|
|
Option A (Python, simple) :
|
|
|
|
```bash
|
|
python3 -m http.server 8080 --directory public
|
|
```
|
|
|
|
Option B (Node) :
|
|
|
|
```bash
|
|
npx serve public
|
|
```
|
|
|
|
Puis ouvre :
|
|
- http://localhost:8080/ (Python)
|
|
- URL affichee par serve (Node)
|
|
|
|
## 6) Deploiement en production
|
|
|
|
### Option 1 - VPS + Nginx (recommande pour controle complet)
|
|
|
|
1. Build local :
|
|
|
|
```bash
|
|
hugo --config ./hugo.toml --environment production --minify
|
|
```
|
|
|
|
2. Copier public/ vers le serveur :
|
|
|
|
```bash
|
|
rsync -avz --delete public/ user@ton-serveur:/var/www/theafriforge/
|
|
```
|
|
|
|
3. Config Nginx minimale :
|
|
|
|
```nginx
|
|
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 via Certbot (recommande).
|
|
|
|
### Option 2 - Netlify (ultra rapide)
|
|
|
|
Build command :
|
|
|
|
```bash
|
|
hugo --config ./hugo.toml --environment production --minify
|
|
```
|
|
|
|
Publish directory :
|
|
- public
|
|
|
|
Important :
|
|
- Selectionne Hugo Extended dans les settings de build si necessaire.
|
|
|
|
### Option 3 - Cloudflare Pages
|
|
|
|
Build command :
|
|
|
|
```bash
|
|
hugo --config ./hugo.toml --environment production --minify
|
|
```
|
|
|
|
Build output directory :
|
|
- public
|
|
|
|
### Option 4 - Vercel (site statique)
|
|
|
|
Framework preset :
|
|
- Hugo
|
|
|
|
Build command :
|
|
|
|
```bash
|
|
hugo --config ./hugo.toml --environment production --minify
|
|
```
|
|
|
|
Output directory :
|
|
- public
|
|
|
|
## 7) Workflow recommande
|
|
|
|
1. Developpement local avec hugo server
|
|
2. Verification FR/EN sur / et /en/
|
|
3. Build production avec minify
|
|
4. Test rapide du dossier public/
|
|
5. Deploiement sur hebergeur cible
|
|
|
|
## 8) Commandes utiles
|
|
|
|
Build standard :
|
|
|
|
```bash
|
|
hugo --config ./hugo.toml --minify
|
|
```
|
|
|
|
Nettoyage cache Hugo (si comportement etrange) :
|
|
|
|
```bash
|
|
rm -rf resources/_gen
|
|
```
|
|
|
|
Forcer un autre port local :
|
|
|
|
```bash
|
|
hugo server --config ./hugo.toml -D --port 1314
|
|
```
|