maputnik

maputnik

Un editor visual gratuito y abierto para los estilos MapLibre GL dirigido a desarrolladores y diseñadores de mapas.

Uso

• ? Diseñe sus mapas en línea en https://www.maplibre.org/maputnik/ (todos en almacenamiento local)
• ? Utilice la CLI de Maputnik para el desarrollo de estilos locales
• En Docker, ejecute este comando y vaya a http://localhost:8888, Ctrl+C para detener el servidor.

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

Documentación

La documentación se puede encontrar en la Wiki. ¡Eres bienvenido a colaborar!

• ? Estudia la Wiki Maputnik
• ? Diseña un mapa desde Scratch https://youtu.be/XoDh0gEnBQo

Desarrollar

Maputnik está escrito en mecanografiado y utiliza React y MapLibre GL JS.

Nos aseguramos de que la construcción y el desarrollo de Maputnik funcionen con la versión LTS activa actual de Node.js y superior.

Consulte nuestra guía de internacionalización para conocer los cambios relacionados con el texto de la interfaz de usuario.

Involucrarse

Únase al canal slack #maplibre o #maputnik en OSMUS: reciba una invitación en https://slack.openstreetmap.us/ Lea la guía a continuación para familiarizarse con cómo hacemos las cosas aquí.

Instale los departamentos, inicie el servidor de desarrollo y abra el navegador web en http://localhost:8888/ .

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

Si desea que Maputnik sea accesible externamente utilice la opción --host :

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

El proceso de compilación observará los cambios en el sistema de archivos, reconstruirá y recargará automáticamente el editor.

 npm run build

Limpia el código JavaScript.

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

Pruebas

Para las pruebas E2E utilizamos Cypress

Cypress no inicia un servidor, por lo que deberá iniciar uno manualmente ejecutando npm run start .

Ahora abra una terminal y ejecute lo siguiente usando Chrome :

 npm run test

o Firefox :

 npm run test -- --browser firefox

Consulte los siguientes documentos para obtener más información: (Inicio de navegadores)[https://docs.cypress.io/guides/guides/launching-browsers]

También puede ver las pruebas a medida que se ejecutan o seleccionar qué suites ejecutar ejecutando:

 npm run cy:open

Proceso de liberación

1. Revisar CHANGELOG.md
   • Vuelva a verificar que todos los cambios incluidos en la versión estén debidamente documentados.
   • Los cambios que se publicarán deben estar debajo del encabezado "principal".
   • Confirme cualquier cambio final en el registro de cambios.
2. Ejecute Crear PR de versión mejorada mediante el envío manual del flujo de trabajo y establezca el número de versión en la entrada. Esto creará un PR que cambiará el registro de cambios y el archivo package.json para revisarlos y fusionarlos.
3. Una vez fusionados, se activará un proceso automático que creará una versión de GitHub y cargará los activos de la versión.

Patrocinadores

Gracias a los seguidores de la campaña Kickstarter . Este proyecto no sería posible sin estos patrocinadores comerciales e individuales. Puede ver el historial de este archivo para patrocinadores anteriores del repositorio original de Maputnik. Lea más sobre el programa de patrocinio de MapLibre en https://maplibre.org/sponsors/.

Licencia

Maputnik tiene licencia del MIT y tiene derechos de autor (c) de Lukas Martinelli y colaboradores de Maplibre. Como colaborador, tenga especial cuidado de no violar ninguna marca registrada de Mapbox. No te dejes inspirar por otros estudios de mapas y toma tus propias decisiones para un buen editor de estilo.