o-k-i.net/SEO.md

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)

<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

<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 :

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

# 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

• Robots.txt configuré
• Sitemap.xml créé et soumis
• Meta description sur toutes les pages
• Balises title optimisées
• URL canoniques
• Open Graph tags
• Twitter Cards
• JSON-LD Organization
• 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)