189 lines
5.5 KiB
Markdown
189 lines
5.5 KiB
Markdown
# 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)
|