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 にあります。ぜひコラボしてください！

• ?マプトニク Wiki を勉強してください
• ?ゼロから地図をデザインする https://youtu.be/XoDh0gEnBQo

開発する

Maputnik は typescript で書かれており、React と MapLibre GL JS を使用しています。

Maputnik の構築と開発が現在アクティブな LTS Node.js バージョン以降で動作することを保証します。

UI テキスト関連の変更については、国際化ガイドをご覧ください。

参加する

OSMUS の #maplibre または #maputnik のスラック チャンネルに参加してください: https://slack.openstreetmap.us/ で招待を取得してください。ここでの取り組み方法を理解するには、以下のガイドをお読みください。

deps をインストールし、dev サーバーを起動し、 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 コードを lint します。

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

テスト

E2E テストには Cypress を使用します

Cypress はサーバーを起動しないため、 npm run start実行して手動でサーバーを起動する必要があります。

次に、ターミナルを開き、 chrome を使用して次のコマンドを実行します。

 npm run test

またはFirefox :

 npm run test -- --browser firefox

詳細については、次のドキュメントを参照してください: (ブラウザの起動)[https://docs.cypress.io/guides/guides/launching-browsers]

また、実行中のテストを確認したり、以下を実行して実行するスイートを選択したりすることもできます。

 npm run cy:open

リリースプロセス

1. CHANGELOG.md確認する
   • リリースに含まれるすべての変更が適切に文書化されていることを再確認してください。
   • リリース予定の変更は「メイン」ヘッダーの下にある必要があります。
   • 最終的な変更を変更ログにコミットします。
2. 手動ワークフローディスパッチによるバンプバージョン PR の作成を実行し、入力にバージョン番号を設定します。これにより、変更ログとpackage.jsonファイルを変更して確認してマージする PR が作成されます。
3. マージされると、自動プロセスが開始され、GitHub リリースが作成され、リリース アセットがアップロードされます。

スポンサー

Kickstarter キャンペーンのサポーターに感謝します。このプロジェクトは、これらの商業スポンサーや個人スポンサーなしでは不可能です。元の Maputnik リポジトリの以前のスポンサーのこのファイルの履歴を確認できます。 MapLibre スポンサーシップ プログラムの詳細については、https://maplibre.org/sponsors/ をご覧ください。

ライセンス

Maputnik は MIT の下でライセンスを取得しており、著作権 (c) Lukas Martinelli および Maplibre の寄稿者です。寄稿者として、Mapbox の商標を侵害しないよう細心の注意を払ってください。他のマップ スタジオに影響を受けず、優れたスタイル エディターについて独自の決定を下してください。