maputnik

马普特尼克

针对 MapLibre GL 样式的免费开放可视化编辑器，面向开发人员和地图设计者。

用法

• ？在https://www.maplibre.org/maputnik/在线设计地图（全部位于本地存储中）
• ？使用 Maputnik CLI 进行本地风格开发
• 在 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 使用 TypeScript 编写，并使用 React 和 MapLibre GL JS。

我们确保 Maputnik 的构建和开发适用于当前活跃的 LTS Node.js 版本及更高版本。

查看我们的国际化指南，了解 UI 文本相关的更改。

参与其中

加入 OSMUS 的 #maplibre 或 #maputnik slack 频道：通过 https://slack.openstreetmap.us/ 获取邀请。阅读以下指南，以熟悉我们在这里的工作方式。

安装 deps，启动开发服务器并在http://localhost:8888/上打开 Web 浏览器。

 # 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
   • 仔细检查版本中包含的所有更改是否均已适当记录。
   • 即将发布的更改应位于“main”标题下。
   • 将所有最终更改提交到变更日志。
2. 运行通过手动工作流调度创建凹凸版本 PR 并在输入中设置版本号。这将创建一个 PR，更改变更日志和package.json文件以进行审查和合并。
3. 合并后，自动流程将启动并创建 GitHub 版本并上传版本资产。

赞助商

感谢Kickstarter 活动的支持者。如果没有这些商业和个人赞助商，这个项目就不可能实现。您可以查看原始 Maputnik 存储库的先前赞助商的此文件的历史记录。请访问 https://maplibre.org/sponsors/ 了解有关 MapLibre 赞助计划的更多信息。

执照

Maputnik 已获得 MIT 许可，版权所有 (c) Lukas Martinelli 和 Maplibre 贡献者。作为贡献者，请特别注意不要侵犯任何 Mapbox 商标。不要受到其他地图工作室的启发，自己决定一个好的样式编辑器。