o-k-i.net/CONTRIBUTING.md

Guide de contribution

Merci de votre intérêt pour contribuer au site de l'ORGANISATION KA INTERNATIONALE !

Ajouter du contenu

Ajouter un service hébergé

Éditez src/_data/i18n/fr/services.json (et la version en/) :

{
  "name": "NOM_DU_SERVICE",
  "platform": "Nom de la plateforme",
  "description": "Description du service",
  "url": "https://service.o-k-i.net/",
  "linkText": "Accéder à SERVICE"
}

Ajouter un projet web

Éditez src/_data/i18n/fr/projects.json (et la version en/) :

{
  "name": "NOM.PROJET",
  "icon": "📱",
  "domain": "nom.projet",
  "description": "Description du projet",
  "url": "https://nom.projet/"
}

Ajouter un client ou partenaire

Pour les logos, privilégiez une image locale dans src/assets/images/ et utilisez le filtre | cdn dans les templates. Les URLs distantes fonctionnent mais ne passent pas par le CDN.

Ajouter une valeur

Éditez src/_data/i18n/fr/values.json (et la version en/) :

{
  "icon": "🌟",
  "title": "Titre",
  "description": "Description de la valeur"
}

Modifier la navigation

Éditez src/_data/i18n/fr/navigation.json (et la version en/) :

{
  "text": "Texte du lien",
  "url": "#section",
  "external": false
}

Pour un lien externe, mettez "external": true.

Modifier les informations de contact

Les liens de contact sont regroupés par section dans src/_data/i18n/fr/contact.json (et la version en/). L'icône affichée est déterminée automatiquement à partir du texte du lien (whatsapp, telegram, discord, labola, kontak/mail).

{
  "title": "💬 Communauté",
  "links": [
    { "text": "Discord", "url": "https://discord.gg/DPvUCA8dD" }
  ]
}

Modifier les styles

Les styles sont dans src/assets/css/styles.css.

Variables CSS principales

--or-oki: #E8A625;
--noir-oki: #000000;
--vert-oki: #00A854;
--rouge-oki: #ED1C4C;
--blanc-creme: #F7F7F2;
--noir-profond: #1A1A1A;
--gris-sombre: #2A2A2A;
--or-clair: #F5BD4F;
--vert-clair: #00C569;
--rouge-clair: #FF2D5F;

Créer une nouvelle page

1. Créez un fichier .njk dans src/ :

---
layout: layouts/base.njk
title: Titre de la page
description: Description pour le SEO
---

<section>
  <h1>{{ title }}</h1>
  <p>Contenu de votre page</p>
</section>

2. Ajoutez le lien dans src/_data/i18n/fr/navigation.json (et en/) si nécessaire.

3. Mettez à jour src/sitemap.xml.

4. Reconstruisez le site : npm run build.

Modifier un partial

Les partials sont dans src/_includes/partials/ :

• nav.njk - Navigation
• hero.njk - Section hero (accueil)
• services.njk - Services hébergés
• projects.njk - Projets web
• mission.njk - Mission et valeurs
• hosting.njk - Services d'hébergement
• support.njk - Section dons
• clients.njk - Clients / organisations ayant fait confiance
• partners.njk - Partenaires
• faq.njk - Questions fréquentes
• engagement.njk - Appels à l'action
• contact.njk - Informations de contact
• footer.njk - Pied de page

Workflow de développement

1. Créez une branche pour votre fonctionnalité :

   git checkout -b feature/ma-fonctionnalite
   

2. Faites vos modifications.

3. Testez localement :

   npm start
   

4. Buildez pour vérifier :

   npm run build
   

5. Commitez vos changements :

   git add .
   git commit -m "Description de vos changements"
   

6. Poussez et créez une merge request :

   git push origin feature/ma-fonctionnalite
   

Standards de code

HTML/Nunjucks

• Indentation : 4 espaces
• Toujours fermer les balises
• Attributs entre guillemets doubles

CSS

• Indentation : 4 espaces
• Utiliser les variables CSS quand possible
• Mobile-first pour le responsive

JavaScript

• Indentation : 4 espaces
• Vanilla JS (pas de framework)
• Commentaires en français
• Gestion des erreurs

Sécurité

• Ne pas ajouter de scripts inline sans ajuster la CSP dans src/.htaccess.
• Conserver les headers de sécurité lors d'une modification du serveur.

Questions ?

Contactez-nous à kontak@o-k-i.net ou ouvrez une issue sur Labola.