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 商標。不要受到其他地圖工作室的啟發，自己決定一個好的風格編輯器。