maputnik

Maputnik

Editor visual gratis dan terbuka untuk gaya MapLibre GL yang ditargetkan untuk pengembang dan perancang peta.

Penggunaan

• ? Rancang peta Anda secara online di https://www.maplibre.org/maputnik/ (semuanya ada di penyimpanan lokal)
• ? Gunakan Maputnik CLI untuk pengembangan gaya lokal
• Di Docker, jalankan perintah ini dan ramban ke http://localhost:8888, Ctrl+C untuk menghentikan server.

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

Dokumentasi

Dokumentasinya dapat ditemukan di Wiki. Anda dipersilakan untuk berkolaborasi!

• ? Pelajari Maputnik Wiki
• ? Rancang peta dari Awal https://youtu.be/XoDh0gEnBQo

Mengembangkan

Maputnik ditulis dalam skrip ketikan dan menggunakan React dan MapLibre GL JS.

Kami memastikan pembangunan dan pengembangan Maputnik berfungsi dengan versi LTS Node.js yang aktif saat ini dan yang lebih baru.

Lihat panduan Internasionalisasi kami untuk perubahan terkait teks UI.

Terlibat

Bergabunglah dengan saluran slack #maplibre atau #maputnik di OSMUS: dapatkan undangan di https://slack.openstreetmap.us/ Baca panduan di bawah ini untuk memahami cara kami melakukan berbagai hal di sini.

Instal deps, mulai server dev dan buka browser web di http://localhost:8888/ .

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

Jika Anda ingin Maputnik dapat diakses secara eksternal, gunakan opsi --host :

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

Proses pembangunan akan memperhatikan perubahan pada sistem file, membangun kembali dan memuat ulang editor secara otomatis.

 npm run build

Lintasi kode JavaScript.

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

Tes

Untuk pengujian E2E kami menggunakan Cypress

Cypress tidak memulai server jadi Anda harus memulainya secara manual dengan menjalankan npm run start .

Sekarang buka terminal dan jalankan perintah berikut menggunakan chrome :

 npm run test

atau firefox :

 npm run test -- --browser firefox

Lihat dokumen berikut untuk informasi lebih lanjut: (Meluncurkan Browser)[https://docs.cypress.io/guides/guides/launching-browsers]

Anda juga dapat melihat pengujian saat dijalankan atau memilih rangkaian mana yang akan dijalankan dengan menjalankan:

 npm run cy:open

Proses rilis

1. Tinjau CHANGELOG.md
   • Periksa kembali apakah semua perubahan yang disertakan dalam rilis didokumentasikan dengan benar.
   • Perubahan yang akan dirilis harus berada di bawah header "utama".
   • Komit perubahan terakhir apa pun pada log perubahan.
2. Jalankan Buat PR versi tambahan dengan pengiriman alur kerja manual dan atur nomor versi di input. Ini akan membuat PR yang mengubah file changelog dan package.json untuk ditinjau dan digabungkan.
3. Setelah digabungkan, proses otomatis akan dimulai dan membuat rilis GitHub serta mengunggah aset rilis.

Sponsor

Terima kasih kepada para pendukung kampanye Kickstarter . Proyek ini tidak akan mungkin terwujud tanpa sponsor komersial dan individu ini. Anda dapat melihat riwayat file ini untuk sponsor sebelumnya dari repo Maputnik asli. Baca lebih lanjut tentang Program Sponsor MapLibre di https://maplibre.org/sponsors/.

Lisensi

Maputnik dilisensikan di bawah MIT dan merupakan Hak Cipta (c) Lukas Martinelli dan kontributor Maplibre. Sebagai kontributor harap berhati-hati agar tidak melanggar merek dagang Mapbox apa pun. Jangan terinspirasi oleh studio peta lain dan buatlah keputusan Anda sendiri untuk editor gaya yang baik.