maputnik

Мапутник

Бесплатный и открытый визуальный редактор стилей MapLibre GL, предназначенный для разработчиков и дизайнеров карт.

Использование

• ? Создавайте свои карты онлайн по адресу https://www.maplibre.org/maputnik/ (все в локальном хранилище).
• ? Используйте интерфейс командной строки Maputnik для разработки локального стиля.
• В Docker выполните эту команду и перейдите по адресу http://localhost:8888, Ctrl+C, чтобы остановить сервер.

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

Документация

Документацию можно найти в Wiki. Приглашаем к сотрудничеству!

• ? Изучите Maputnik Wiki
• ? Создайте карту с нуля https://youtu.be/XoDh0gEnBQo

Развивать

Maputnik написан машинописным текстом и использует React и MapLibre GL JS.

Мы гарантируем, что сборка и разработка Maputnik работает с текущей активной версией LTS Node.js и выше.

Ознакомьтесь с нашим руководством по интернационализации изменений, связанных с текстом пользовательского интерфейса.

Участие

Присоединяйтесь к Slack-каналу #maplibre или #maputnik на OSMUS: получите приглашение на https://slack.openstreetmap.us/. Прочтите приведенное ниже руководство, чтобы узнать, как мы здесь работаем.

Установите deps, запустите сервер разработки и откройте веб-браузер по http://localhost:8888/ .

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

Если вы хотите, чтобы Maputnik был доступен извне, используйте опцию --host :

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

Процесс сборки будет отслеживать изменения в файловой системе, пересобирать и автоматически перезагружать редактор.

 npm run build

Линтируйте код JavaScript.

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

Тесты

Для E2E-тестирования мы используем Cypress.

Cypress не запускает сервер, поэтому вам придется запустить его вручную, запустив npm run start .

Теперь откройте терминал и запустите следующее с помощью Chrome :

 npm run test

или фаерфокс :

 npm run test -- --browser firefox

Дополнительную информацию см. в следующей документации: (Запуск браузеров)[https://docs.cypress.io/guides/guides/launching-browsers]

Вы также можете просмотреть тесты во время их выполнения или выбрать, какие пакеты запускать, выполнив:

 npm run cy:open

Процесс выпуска

1. Обзор CHANGELOG.md
   • Дважды проверьте, что все изменения, включенные в релиз, надлежащим образом задокументированы.
   • Изменения, которые будут выпущены, должны находиться под «основным» заголовком.
   • Внесите все окончательные изменения в журнал изменений.
2. Запустите «Создать обновленную версию PR» путем ручной отправки рабочего процесса и установите номер версии во входных данных. Это создаст PR, который изменит журнал изменений и файл package.json для проверки и объединения.
3. После объединения запустится автоматический процесс, создающий выпуск GitHub и загружающий ресурсы выпуска.

Спонсоры

Спасибо сторонникам кампании Kickstarter . Этот проект был бы невозможен без коммерческих и индивидуальных спонсоров. Вы можете просмотреть историю этого файла для предыдущих спонсоров исходного репозитория Maputnik. Дополнительную информацию о спонсорской программе MapLibre можно найти на странице https://maplibre.org/sponsors/.

Лицензия

Maputnik имеет лицензию MIT и защищен авторскими правами (c) Лукаса Мартинелли и участников Maplibre. Как участник, пожалуйста, будьте особенно внимательны и не нарушайте права товарных знаков Mapbox. Не вдохновляйтесь другими картографическими студиями и принимайте собственные решения о выборе хорошего редактора стиля.