aboutsummaryrefslogtreecommitdiff
path: root/website/src/content/docs/ja/marketplace.mdx
blob: 5f0a5c4cc5143770d088f88bc52c82c6fc5219e2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
---
title: マーケットプレイス
description: GitHub 上のコミュニティ製 Herdr プラグインを探し、自分のプラグインを掲載する方法。
---

Herdr プラグインマーケットプレイスは、コミュニティ製プラグインを探せるインデックスです。
[herdr.dev/plugins](/plugins/) で閲覧できます。これは公開 GitHub リポジトリの
自動インデックスであり、審査済みカタログではありません。

## プラグインを探す

[マーケットプレイス](/plugins/)には、GitHub トピック `herdr-plugin` が付いた
すべての公開リポジトリが掲載されます。名前、オーナー、説明、言語で検索でき、
人気順、最近の活動順、新着順で並べ替えられます。各掲載はソースリポジトリの
GitHub ページに直接リンクしています。

掲載は自動かつ無審査です。掲載されているのはリポジトリが自らトピックを
付けたからであって、Herdr が検証したからではありません。インストールする前に
[信頼に関するガイダンス](/ja/docs/plugins/#信頼とセキュリティ)を確認してください。

## プラグインをインストールする

マーケットプレイスはインストールの上に発見の仕組みを足すものであり、
インストールを置き換えるものではありません。どのプラグインも GitHub から
直接インストールできます:

```bash
herdr plugin install owner/repo[/subdir...]
```

ルートまたはサブディレクトリに `herdr-plugin.toml` マニフェストを置いた
通常の公開 GitHub リポジトリを公開すれば、このコマンドが機能します。
マニフェストと作成方法のリファレンスは[プラグイン](/ja/docs/plugins/)を
参照してください。

## 自分のプラグインを掲載する

公開リポジトリに GitHub トピック `herdr-plugin` を追加してください。
インデックスが使うシグナルはこのトピックだけなので、公開プラグインに
トピックを付けるだけで掲載されます。インデックスは 30 分ごとに自動更新される
ため、新しくトピックを付けたリポジトリはまもなく表示され、トピックを外した
リポジトリは次回の更新で消えます。

## 掲載に表示される内容

各カードには GitHub リポジトリのメタデータが表示されます: リポジトリ名と
オーナー、説明、スター数、主要言語、最終 push 時刻、そしてソースへのリンクです。
インデックスは GitHub のリポジトリ検索からこれらを読み取るため、リポジトリの
説明とトピックを正確に保つことが、掲載を有用にする鍵になります。

インデックスはまだ `herdr-plugin.toml` を解析しないため、プラグインの `id`、
宣言された `platforms`、`min_herdr_version` といったマニフェストのフィールドは
v1 では表示されません。フォークとアーカイブ済みリポジトリは一覧から除外されます。