Files
JWE/docs/contribution.md
T

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

  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 :
curl -s "https://www.wikidata.org/w/api.php?action=wbgetentities&ids=Q3077840&props=sitelinks&format=json" | grep frwiki
  1. 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 :
curl -s "https://commons.wikimedia.org/w/api.php?action=query&titles=File:NOM_DU_FICHIER&prop=imageinfo&iiprop=url|extmetadata&format=json"
  1. 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.
  2. Reportez le crédit exact (auteur + licence) dans photo.credit ET dans content/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_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 :

Chaque entité créée enrichit Wikipédia, les cartes libres… et les futurs jeux comme JWE.