maputnik

Maputnik

Um editor visual gratuito e aberto para os estilos MapLibre GL voltado para desenvolvedores e designers de mapas.

Uso

• ? Projete seus mapas online em https://www.malibre.org/maputnik/ (todos em armazenamento local)
• ? Use a CLI do Maputnik para desenvolvimento de estilo local
• Em um Docker, execute este comando e navegue até http://localhost:8888, Ctrl+C para parar o servidor.

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

Documentação

A documentação pode ser encontrada no Wiki. Você está convidado a colaborar!

• ? Estude a Wiki Maputnik
• ? Projete um mapa do zero https://youtu.be/XoDh0gEnBQo

Desenvolver

Maputnik é escrito em TypeScript e usa React e MapLibre GL JS.

Garantimos que a construção e o desenvolvimento do Maputnik funcionem com a versão LTS Node.js ativa atual e superior.

Confira nosso guia de internacionalização para alterações relacionadas ao texto da IU.

Envolvendo-se

Junte-se ao canal slack #maplibre ou #maputnik no OSMUS: receba um convite em https://slack.openstreetmap.us/ Leia o guia abaixo para se familiarizar com como fazemos as coisas por aqui.

Instale o deps, inicie o servidor de desenvolvimento e abra o navegador da web em http://localhost:8888/ .

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

Se você deseja que o Maputnik seja acessível externamente, use a opção --host :

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

O processo de construção observará as alterações no sistema de arquivos, reconstruirá e recarregará automaticamente o editor.

 npm run build

Lint o código JavaScript.

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

Testes

Para testes E2E usamos Cypress

Cypress não inicia um servidor, então você precisará iniciar um manualmente executando npm run start .

Agora abra um terminal e execute o seguinte usando chrome :

 npm run test

ou firefox :

 npm run test -- --browser firefox

Consulte os seguintes documentos para obter mais informações: (Iniciando navegadores)[https://docs.cypress.io/guides/guides/launching-browsers]

Você também pode ver os testes conforme eles são executados ou selecionar quais suítes serão executadas executando:

 npm run cy:open

Processo de liberação

1. Revisão CHANGELOG.md
   • Verifique novamente se todas as alterações incluídas na versão estão devidamente documentadas.
   • As alterações a serem lançadas devem estar no cabeçalho "principal".
   • Confirme todas as alterações finais no changelog.
2. Execute Criar versão bump PR por envio manual do fluxo de trabalho e defina o número da versão na entrada. Isso criará um PR que altera o changelog e o arquivo package.json para revisão e mesclagem.
3. Depois de mesclado, um processo automático será iniciado e criará uma versão do GitHub e fará upload dos ativos da versão.

Patrocinadores

Obrigado aos apoiadores da campanha Kickstarter . Este projeto não seria possível sem estes patrocinadores comerciais e individuais. Você pode ver o histórico deste arquivo para patrocinadores anteriores do repositório Maputnik original. Leia mais sobre o Programa de Patrocínio MapLibre em https://maplibre.org/sponsors/.

Licença

Maputnik é licenciado pelo MIT e é colaborador de Copyright (c) Lukas Martinelli e Maplibre. Como colaborador, tome cuidado extra para não violar nenhuma marca registrada do Mapbox. Não se inspire em outros estúdios de mapas e tome suas próprias decisões para um bom editor de estilo.