コンテンツにスキップ

ショーケース

ショーケースページでは、Navara で作られた地図やビジュアライゼーションを紹介しています。各プロジェクトはスクリーンショットで表示され、プロジェクトへのリンクとデータの帰属表示が付きます。

URL: https://navara.world/ja/showcases/

投稿は必ず Issue から始めてください。その後、Navaraチームが追加するか、投稿者自身が Pull Request を作成します。

ショーケース投稿フォームを埋めてください。

ショーケースページは、データファイル docs/src/data/showcases.json と、docs/src/assets/showcases/ のスクリーンショットから作られます。

maplibre/navara をフォークしてクローンし、pnpm で依存関係をインストールします。

ターミナルウィンドウ
git clone https://github.com/<your-account>/navara.git
cd navara
pnpm install

AI エージェントに追加してもらう

Section titled “AI エージェントに追加してもらう”

リポジトリには、この作業のためのエージェントスキル navara-add-showcase が含まれています。Claude Code はクローンしたリポジトリで実行すると自動で読み込みます。ほかのエージェントでは skills/navara-add-showcase/SKILL.md を参照するよう指示してください。Issue 番号を渡して依頼します。

Add the showcase from issue #123 with the navara-add-showcase skill, then open a Pull Request.

エージェントがスクリーンショットの用意、showcases.json への項目追加、チェックの実行を行い、Issue にリンクした Pull Request を作成します。投稿する前に、ローカルのページで自分の画像を確認してください(ローカルで確認するを参照)。

ここから下は、同じ手順を手作業で行う場合の説明です。エージェントを使わない場合や、エージェントの作業内容を確認したい場合に読んでください。

スクリーンショットを追加する

Section titled “スクリーンショットを追加する”

プロジェクトのスクリーンショットを docs/src/assets/showcases/<project-name>.avif に保存します。1000×1000 ピクセル程度の正方形の画像を使ってください。ファイルは AVIF 形式で、150 KB 以下にする必要があります。ほかの形式の画像は、ブラウザで使える Squoosh や、コマンドラインの libavif の avifenc といった既存のツールで変換してください。

ページ上のタイルは正方形です。ほかの縦横比の画像は中央の正方形部分が切り取られるので、主な被写体は中央に置いてください。パネルやボタン、帰属表示といったページ自身の UI は、できるだけ写らないようにしてください。

docs/src/data/showcases.json の配列の先頭にオブジェクトを追加します。新しいプロジェクトほど上に表示されます。

{
"title": "My Navara Project",
"href": "https://example.com/my-navara-project/",
"image": "showcases/my-navara-project.avif",
"attributions": [
{
"text": "© OpenStreetMap contributors",
"href": "https://www.openstreetmap.org/copyright"
}
]
}
フィールド説明
title必須。プロジェクト名。タイルのツールチップと画像の代替テキストに使われます。
href必須。タイルのリンク先 URL。
image必須。docs/src/assets/ からのスクリーンショットのパス。ファイルが存在しないとビルドが失敗します。
attributions任意。タイルの情報アイコンから表示されるデータの帰属表示。プロジェクト自身の帰属表示から 1 件ずつ転記します。帰属表示が不要なプロジェクトでは省略します。
logo任意。Google Photorealistic 3D Tiles を使う場合は "google-maps" を指定します。利用規約で Google Maps のロゴ表示が必要です。

attributions の各項目は text と、任意の href を持ちます。リンクを複数含む帰属表示は、リンクごとに 1 項目に分けます。

リポジトリのルートでドキュメントサイトを起動します。

ターミナルウィンドウ
pnpm dev:docs

スクリーンショットがサイズの上限内かどうかも確認してください。CI でもすべての Pull Request で同じチェックが実行されます。

ターミナルウィンドウ
pnpm -C docs showcases:check

http://localhost:4321/docs/showcases/ を開き(コマンドが表示するポートが異なる場合はそちらを使います)、タイルが表示されること、プロジェクトへリンクしていること、情報アイコンに帰属表示が並ぶことを確認してください。

スクリーンショットと showcases.json の変更をコミットしてフォークにプッシュし、maplibre/navara に Pull Request を作成します。説明欄には投稿時の Issue をリンクしてください(例: Closes #123)。Issue で行った確認が、その Pull Request にも適用されます。