maputnik

Mapoutnik

Un éditeur visuel gratuit et ouvert pour les styles MapLibre GL destiné aux développeurs et aux concepteurs de cartes.

Usage

• ? Concevez vos cartes en ligne sur https://www.maplibre.org/maputnik/ (le tout dans un stockage local)
• ? Utilisez la CLI Maputnik pour le développement de style local
• Dans un Docker, exécutez cette commande et accédez à http://localhost:8888, Ctrl+C pour arrêter le serveur.

docker run -it --rm -p 8888:80 ghcr.io/maplibre/maputnik:main

Documentation

La documentation peut être trouvée dans le Wiki. Vous êtes invités à collaborer!

• ? Étudiez le wiki Maputnik
• ? Concevoir une carte à partir de Scratch https://youtu.be/XoDh0gEnBQo

Développer

Maputnik est écrit en dactylographié et utilise React et MapLibre GL JS.

Nous veillons à ce que la construction et le développement de Maputnik fonctionnent avec la version active actuelle de LTS Node.js et supérieure.

Consultez notre guide d’internationalisation pour connaître les modifications liées au texte de l’interface utilisateur.

S'impliquer

Rejoignez la chaîne Slack #maplibre ou #maputnik sur OSMUS : recevez une invitation sur https://slack.openstreetmap.us/ Lisez le guide ci-dessous afin de vous familiariser avec la façon dont nous faisons les choses ici.

Installez les deps, démarrez le serveur de développement et ouvrez le navigateur Web sur http://localhost:8888/ .

 # install dependencies
npm install
# start dev server
npm run start

Si vous souhaitez que Maputnik soit accessible en externe, utilisez l'option --host :

 # start externally accessible dev server
npm run start -- --host 0.0.0.0

Le processus de construction surveillera les modifications apportées au système de fichiers, reconstruira et rechargera automatiquement l'éditeur.

 npm run build

Lint le code JavaScript.

 # run linter
npm run lint
npm run lint-css
npm run sort-styles

Essais

Pour les tests E2E, nous utilisons Cypress

Cypress ne démarre pas de serveur, vous devrez donc en démarrer un manuellement en exécutant npm run start .

Ouvrez maintenant un terminal et exécutez ce qui suit en utilisant Chrome :

 npm run test

ou Firefox :

 npm run test -- --browser firefox

Consultez les documents suivants pour plus d'informations : (Lancement des navigateurs)[https://docs.cypress.io/guides/guides/launching-browsers]

Vous pouvez également voir les tests au fur et à mesure de leur exécution ou sélectionner les suites à exécuter en exécutant :

 npm run cy:open

Processus de libération

1. Donnez votre avis sur CHANGELOG.md
   • Vérifiez à nouveau que toutes les modifications incluses dans la version sont correctement documentées.
   • Les modifications à publier doivent se trouver sous l’en-tête « principal ».
   • Validez toutes les modifications finales dans le journal des modifications.
2. Exécutez Créer une version Bump PR par répartition manuelle du flux de travail et définissez le numéro de version dans l'entrée. Cela créera un PR qui modifiera le fichier changelog et package.json pour les réviser et les fusionner.
3. Une fois fusionné, un processus automatique se lancera et créera une version GitHub et téléchargera les ressources de la version.

Commanditaires

Merci aux supporters de la campagne Kickstarter . Ce projet ne serait pas possible sans ces sponsors commerciaux et individuels. Vous pouvez voir l'historique de ce fichier pour les sponsors précédents du dépôt Maputnik original. En savoir plus sur le programme de parrainage MapLibre sur https://maplibre.org/sponsors/.

Licence

Maputnik est sous licence MIT et est protégé par Copyright (c) Lukas Martinelli et les contributeurs de Maplibre. En tant que contributeur, veillez particulièrement à ne violer aucune marque déposée de Mapbox. Ne vous inspirez pas des autres studios de cartes et prenez vos propres décisions pour choisir un bon éditeur de style.