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:
+43
-30
@@ -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).
|
||||
|
||||
Reference in New Issue
Block a user