4.1 KiB
4.1 KiB
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
{
"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
- Cherchez le lieu sur https://www.wikidata.org
- L'identifiant ressemble à
Q3077840. - 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 :
curl -s "https://www.wikidata.org/w/api.php?action=wbgetentities&ids=Q3077840&props=sitelinks&format=json" | grep frwiki
- 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)
- Cherchez sur https://commons.wikimedia.org une photo nette, paysage de préférence.
- Licences acceptées : CC BY, CC BY-SA, CC0, domaine public. Jamais de « fair use ».
- Vérifiez la licence et l'auteur via l'API :
curl -s "https://commons.wikimedia.org/w/api.php?action=query&titles=File:NOM_DU_FICHIER&prop=imageinfo&iiprop=url|extmetadata&format=json"
- L'URL dans le JSON utilise
Special:FilePathavec?width=1200(redimensionnement à la volée côté Wikimedia — pas besoin d'héberger l'image). Testez qu'elle renvoie bien 200. - Reportez le crédit exact (auteur + licence) dans
photo.creditET danscontent/credits.md.
5. Valider avant la PR
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_idvérifié (ounulljustifié)- licence photo CC vérifiée + crédit complet
altdescriptif (accessibilité)- 2 indices progressifs, sans donner la réponse
nom_creolerenseigné 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.