docs: mise à jour de la documentation suite aux évolutions récentes

- README.md : services, projets, liens sociaux, structure, sécurité et copyright 2026
- CHANGELOG.md : ajout d'une section Unreleased (headers HTTP, HTTPS, CSP, FEDIVERSE.OKI, réseaux sociaux, o2switch)
- CONTRIBUTING.md : correction des exemples, ajout du filtre CDN et note sécurité
- SEO.md : plateformes sociales et checklist HTTPS/hreflang à jour
This commit is contained in:
2026-07-09 03:37:51 +04:00
parent d3afa0ca1d
commit 1644d2606f
4 changed files with 107 additions and 54 deletions
+43 -30
View File
@@ -1,17 +1,16 @@
# Guide de contribution
Merci de votre intérêt pour contribuer au site dE l'ORGANISATION KA INTERNATIONALE !
Merci de votre intérêt pour contribuer au site de l'ORGANISATION KA INTERNATIONALE !
## Ajouter du contenu
### Ajouter un service Fédiverse
### Ajouter un service hébergé
Éditez `src/_data/services.json` :
Éditez `src/_data/i18n/fr/services.json` (et la version `en/`) :
```json
{
"name": "NOM_DU_SERVICE",
"icon": "🎯",
"platform": "Nom de la plateforme",
"description": "Description du service",
"url": "https://service.o-k-i.net/",
@@ -21,20 +20,25 @@ Merci de votre intérêt pour contribuer au site dE l'ORGANISATION KA INTERNATIO
### Ajouter un projet web
Éditez `src/_data/projects.json` :
Éditez `src/_data/i18n/fr/projects.json` (et la version `en/`) :
```json
{
"name": "NOM.PROJET",
"icon": "📱",
"domain": "nom.projet",
"description": "Description du 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/values.json` :
Éditez `src/_data/i18n/fr/values.json` (et la version `en/`) :
```json
{
@@ -46,7 +50,7 @@ Merci de votre intérêt pour contribuer au site dE l'ORGANISATION KA INTERNATIO
### Modifier la navigation
Éditez `src/_data/navigation.json` :
Éditez `src/_data/i18n/fr/navigation.json` (et la version `en/`) :
```json
{
@@ -58,18 +62,15 @@ Merci de votre intérêt pour contribuer au site dE l'ORGANISATION KA INTERNATIO
Pour un lien externe, mettez `"external": true`.
### Ajouter une section de contact
### Modifier les informations de contact
Éditez `src/_data/contact.json` :
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`).
```json
{
"title": "🔗 Titre de la section",
"title": "💬 Communauté",
"links": [
{
"text": "Nom du lien",
"url": "https://example.com"
}
{ "text": "Discord", "url": "https://discord.gg/DPvUCA8dD" }
]
}
```
@@ -78,17 +79,19 @@ Pour un lien externe, mettez `"external": true`.
Les styles sont dans `src/assets/css/styles.css`.
### Variables CSS disponibles
### Variables CSS principales
```css
--bleu-ocean: #003566;
--jaune-soleil: #FFB700;
--rouge-resistance: #D62828;
--vert-terre: #2A9134;
--orange-communaute: #FB8500;
--noir-profond: #0A0908;
--blanc-lumiere: #F7F7F2;
--violet-fedi: #6364FF;
--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
@@ -108,9 +111,11 @@ description: Description pour le SEO
</section>
```
2. Ajoutez le lien dans `src/_data/navigation.json` si nécessaire
2. Ajoutez le lien dans `src/_data/i18n/fr/navigation.json` (et `en/`) si nécessaire.
3. Reconstruisez le site : `npm run build`
3. Mettez à jour `src/sitemap.xml`.
4. Reconstruisez le site : `npm run build`.
## Modifier un partial
@@ -118,11 +123,15 @@ Les partials sont dans `src/_includes/partials/` :
- `nav.njk` - Navigation
- `hero.njk` - Section hero (accueil)
- `fediverse.njk` - Services Fédiverse
- `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
@@ -133,7 +142,7 @@ Les partials sont dans `src/_includes/partials/` :
git checkout -b feature/ma-fonctionnalite
```
2. Faites vos modifications
2. Faites vos modifications.
3. Testez localement :
```bash
@@ -151,7 +160,7 @@ Les partials sont dans `src/_includes/partials/` :
git commit -m "Description de vos changements"
```
6. Poussez et créez une pull request :
6. Poussez et créez une merge request :
```bash
git push origin feature/ma-fonctionnalite
```
@@ -174,6 +183,10 @@ Les partials sont dans `src/_includes/partials/` :
- 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 Codeberg.
Contactez-nous à kontak@o-k-i.net ou ouvrez une issue sur [Labola](https://labola.o-k-i.net/ORGANISATION-KA-INTERNATIONALE/o-k-i.net).