# Guide SEO - o-k-i.net

Ce document décrit l'optimisation SEO mise en place sur le site o-k-i.net V2.

## 📋 Fichiers SEO

### 1. robots.txt
**Emplacement :** `src/robots.txt`

Permet aux moteurs de recherche d'indexer tout le contenu du site et indique l'emplacement du sitemap.

```
User-agent: *
Allow: /
Sitemap: https://o-k-i.net/sitemap.xml
```

### 2. sitemap.xml
**Emplacement :** `src/sitemap.xml`

Liste toutes les pages du site avec leurs priorités et fréquences de mise à jour.

**Pages incluses :**
- Page d'accueil (priorité 1.0, hebdomadaire)
- Mentions légales (priorité 0.3, mensuelle)

**À mettre à jour :** Lors de l'ajout de nouvelles pages.

## 🏷️ Meta Tags

### Meta Tags de base
Définis dans `src/_includes/layouts/base.njk` :

- **Title** : Dynamique selon la page
- **Description** : Personnalisable par page via front matter
- **Keywords** : OKI, Fédiverse, PeerTube, Pleroma, Funkwhale, Castopod, Guadeloupe, logiciel libre, GAFAM
- **Author** : Organisation Ka Internationale
- **Canonical URL** : Évite le contenu dupliqué

### Open Graph (Facebook, LinkedIn)
```html
<meta property="og:type" content="website">
<meta property="og:url" content="https://o-k-i.net">
<meta property="og:title" content="...">
<meta property="og:description" content="...">
<meta property="og:image" content="https://o-k-i.net/assets/images/logo-512x512.png">
<meta property="og:locale" content="fr_FR">
```

### Twitter Cards
```html
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="...">
<meta name="twitter:description" content="...">
<meta name="twitter:image" content="...">
```

## 📊 Structured Data (JSON-LD)

### Organization Schema
Données structurées conformes à Schema.org pour améliorer l'affichage dans les résultats de recherche.

**Type :** Organization

**Informations incluses :**
- Nom : ORGANISATION KA INTERNATIONALE
- Nom alternatif : OKI
- URL : https://o-k-i.net
- Logo
- Description
- Adresse physique (Basse-Terre, Guadeloupe)
- Email de contact
- Liens vers les plateformes sociales (GADE, BOKANTAJ, MIZIK, KUTE, Codeberg, Liberapay)
- Statut : Organisation à but non lucratif

## 🔍 Optimisations par page

### Page d'accueil
- **Title :** "ORGANISATION KA INTERNATIONALE | OKI"
- **Description :** Reprend site.description
- **Keywords :** Fédiverse, logiciel libre, alternatives GAFAM, Guadeloupe

### Mentions légales
- **Title :** "Mentions Légales | ORGANISATION KA INTERNATIONALE"
- **Description :** "Mentions légales et informations juridiques de l'Organisation Ka Internationale (OKI) - Hébergement, RGPD, licence AGPL-V3"

## 🎯 Bonnes pratiques

### Ajouter une nouvelle page
1. Créer le fichier `.njk` dans `src/`
2. Ajouter le front matter avec title et description personnalisés
3. Mettre à jour `src/sitemap.xml`
4. Ajouter un lien dans la navigation si nécessaire

### Personnaliser les meta tags
Dans le front matter de la page :
```yaml
---
layout: layouts/base.njk
title: Titre de la page
description: Description spécifique à cette page
---
```

## 🚀 Tests et validation

### Outils recommandés
1. **Google Search Console** - Soumettre le sitemap
2. **Facebook Sharing Debugger** - Tester les meta Open Graph
   - URL : https://developers.facebook.com/tools/debug/
3. **Twitter Card Validator** - Tester les Twitter Cards
   - URL : https://cards-dev.twitter.com/validator
4. **Schema Markup Validator** - Valider le JSON-LD
   - URL : https://validator.schema.org/
5. **Google Rich Results Test** - Tester les données structurées
   - URL : https://search.google.com/test/rich-results

### Commandes utiles
```bash
# Vérifier robots.txt
curl http://localhost:8080/robots.txt

# Vérifier sitemap.xml
curl http://localhost:8080/sitemap.xml

# Vérifier les meta tags
curl http://localhost:8080/ | grep -E "(og:|twitter:)"
```

## 📈 Suivi et amélioration

### Métriques à surveiller
- Position dans les résultats de recherche Google
- Taux de clics (CTR) depuis les résultats de recherche
- Nombre de pages indexées
- Erreurs d'exploration

### Améliorations futures possibles
- [ ] Ajouter un blog/actualités avec articles optimisés SEO
- [ ] Créer des pages dédiées pour chaque service Fédiverse
- [ ] Ajouter des FAQ avec Schema.org FAQPage
- [ ] Optimiser les images avec attributs alt descriptifs
- [ ] Ajouter breadcrumbs avec données structurées
- [ ] Implémenter AMP (Accelerated Mobile Pages) si nécessaire
- [ ] Ajouter hreflang pour versions multilingues (créole, anglais, etc.)

## 🌍 Mots-clés ciblés

### Primaires
- Organisation Ka Internationale
- OKI
- Fédiverse Guadeloupe
- PeerTube Guadeloupe
- Alternatives GAFAM

### Secondaires
- Pleroma
- Funkwhale
- Castopod
- Logiciel libre Antilles
- Médias libres Caraïbes
- Hébergement éthique
- Langues créoles
- Réseau social libre

### Longue traîne
- "alternative libre à YouTube Guadeloupe"
- "hébergement PeerTube Martinique"
- "réseau social décentralisé Antilles"
- "promotion langues créoles numérique"

## 📝 Checklist SEO

- [x] Robots.txt configuré
- [x] Sitemap.xml créé et soumis
- [x] Meta description sur toutes les pages
- [x] Balises title optimisées
- [x] URL canoniques
- [x] Open Graph tags
- [x] Twitter Cards
- [x] JSON-LD Organization
- [x] Logo haute résolution (512x512)
- [ ] Images avec attributs alt
- [ ] Performance optimale (Lighthouse score)
- [ ] Mobile-friendly (déjà responsive)
- [ ] HTTPS activé (à configurer en production)
- [ ] Google Search Console configuré
- [ ] Analytics installé (optionnel, respectueux RGPD)
