88 lines
4.1 KiB
Markdown
88 lines
4.1 KiB
Markdown
|
# JWE — Guide de contribution : ajouter un lieu
|
||
|
|
|
||
|
|
Le corpus de lieux vit dans `app/src/lib/server/data/lieux.json`, versionné dans Git. Ajouter un lieu = une pull request. La revue de PR sert de modération éditoriale (exactitude, crédits photo, licence).
|
||
|
|
|
||
|
|
## 1. Règles d'or d'un bon lieu
|
||
|
|
|
||
|
|
- **Photographiable et identifiable** : le lieu doit avoir une photo libre de qualité (Wikimedia Commons de préférence).
|
||
|
|
- **Localisé précisément** : coordonnées GPS au lieu près (le score Expert se joue à 1 km).
|
||
|
|
- **Éditorialement pertinent** : monument, paysage, lieu culturel, rue ordinaire… Le jeu mélange volontairement lieux célèbres et lieux du quotidien.
|
||
|
|
- **Lacunes assumées** : il est VOLONTAIRE d'inclure des lieux sans page Wikipédia (`wikidata_id: null`) — le jeu affiche alors un écran pédagogique « Pwen blindé » appelant à documenter le territoire. Mais c'est un choix, pas une négligence : vérifiez d'abord qu'aucune page/frwiki ni entité Wikidata n'existe.
|
||
|
|
|
||
|
|
## 2. Schéma du lieu
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"id": "générez un uuid (uuidgen)",
|
||
|
|
"nom": "Fort Delgrès",
|
||
|
|
"nom_creole": "Fò Delgrès",
|
||
|
|
"region": "GUADELOUPE | MARTINIQUE | GUYANE | REUNION",
|
||
|
|
"commune": "Basse-Terre",
|
||
|
|
"coordonnees": { "lat": 16.0036, "lon": -61.7319 },
|
||
|
|
"categorie": "MONUMENT | LIEU",
|
||
|
|
"difficulte": "FACILE | MOYEN | DIFFICILE | EXPERT",
|
||
|
|
"wikidata_id": "Q3077840",
|
||
|
|
"photo": {
|
||
|
|
"url": "https://commons.wikimedia.org/wiki/Special:FilePath/FICHIER?width=1200",
|
||
|
|
"credit": "© Auteur / Wikimedia Commons CC-BY-SA-4.0",
|
||
|
|
"alt": "Description précise (sert d'alternative textuelle)"
|
||
|
|
},
|
||
|
|
"indices": [
|
||
|
|
{ "niveau": 1, "texte": "Indice doux" },
|
||
|
|
{ "niveau": 2, "texte": "Indice précis" }
|
||
|
|
]
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## 3. Trouver et lier l'identifiant Wikidata
|
||
|
|
|
||
|
|
1. Cherchez le lieu sur https://www.wikidata.org
|
||
|
|
2. L'identifiant ressemble à `Q3077840`.
|
||
|
|
3. Vérifiez que l'entité a un lien vers une page **fr.wikipedia** (sitelink) — c'est ce qui permet au jeu d'afficher l'extrait de l'article :
|
||
|
|
|
||
|
|
```bash
|
||
|
|
curl -s "https://www.wikidata.org/w/api.php?action=wbgetentities&ids=Q3077840&props=sitelinks&format=json" | grep frwiki
|
||
|
|
```
|
||
|
|
|
||
|
|
4. **Si le lieu n'a ni page Wikipédia ni entité Wikidata** : mettez `"wikidata_id": null`. C'est une contribution précieuse : le jeu transforme la lacune en appel à contribution. Mieux encore : créez l'entité Wikidata vous-même, puis revenez renseigner l'ID !
|
||
|
|
|
||
|
|
## 4. Choisir la photo (licence obligatoire)
|
||
|
|
|
||
|
|
1. Cherchez sur https://commons.wikimedia.org une photo nette, paysage de préférence.
|
||
|
|
2. Licences acceptées : CC BY, CC BY-SA, CC0, domaine public. **Jamais** de « fair use ».
|
||
|
|
3. Vérifiez la licence et l'auteur via l'API :
|
||
|
|
|
||
|
|
```bash
|
||
|
|
curl -s "https://commons.wikimedia.org/w/api.php?action=query&titles=File:NOM_DU_FICHIER&prop=imageinfo&iiprop=url|extmetadata&format=json"
|
||
|
|
```
|
||
|
|
|
||
|
|
4. L'URL dans le JSON utilise `Special:FilePath` avec `?width=1200` (redimensionnement à la volée côté Wikimedia — pas besoin d'héberger l'image). Testez qu'elle renvoie bien 200.
|
||
|
|
5. Reportez le crédit exact (auteur + licence) dans `photo.credit` ET dans `content/credits.md`.
|
||
|
|
|
||
|
|
## 5. Valider avant la PR
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd app
|
||
|
|
node -e "const l=require('./src/lib/server/data/lieux.json');console.log(l.length,'lieux')"
|
||
|
|
npm run check
|
||
|
|
```
|
||
|
|
|
||
|
|
Checklist de revue :
|
||
|
|
|
||
|
|
- [ ] coordonnées cohérentes avec la commune déclarée
|
||
|
|
- [ ] `wikidata_id` vérifié (ou `null` justifié)
|
||
|
|
- [ ] licence photo CC vérifiée + crédit complet
|
||
|
|
- [ ] `alt` descriptif (accessibilité)
|
||
|
|
- [ ] 2 indices progressifs, sans donner la réponse
|
||
|
|
- [ ] `nom_creole` renseigné quand la forme créole est attestée (sinon, reprendre le nom français — ne pas inventer)
|
||
|
|
|
||
|
|
## 6. Contribuer à Wikipédia / Wikidata (au-delà du jeu)
|
||
|
|
|
||
|
|
Si vous ajoutez un lieu « Pwen blindé », envisagez de documenter le lieu vous-même :
|
||
|
|
|
||
|
|
- Créer un compte et un brouillon d'article : https://fr.wikipedia.org/wiki/Aide:Brouillon
|
||
|
|
- Créer une entité Wikidata : https://www.wikidata.org/wiki/Wikidata:Main_Page
|
||
|
|
- Contacter les groupes Wikimédia locaux (Wikimédia France, groupes antillais/guyanais/réunionnais).
|
||
|
|
|
||
|
|
Chaque entité créée enrichit Wikipédia, les cartes libres… et les futurs jeux comme JWE.
|