トピックでリポジトリを分類する

あなたのプロジェクトを他の人が見つけて貢献しやすくするために、プロジェクトの目的、分野、主催グループなどの、リポジトリに関するトピックを追加できます。

この記事の内容

Topics について

Topics を利用すれば、特定の領域に関するリポジトリを調べたり、コントリビュートするプロジェクトを見つけたり、特定の問題に対する新たなソリューションを見つけ出すことができます。 Topics は、リポジトリのメインページに表示されます。 トピック名をクリックして、そのトピックの他のリポジトリを検索することができます。

github/docs リポジトリのスクリーンショット。 右側のサイドバーで、"docs"、"hacktoberfest"、"works-with-codespaces" が濃いオレンジの枠線で囲まれています。

最もよく使われるトピックを閲覧するには、HOSTNAME/topics/ に移動します。

リポジトリの管理者は、リポジトリに好きなトピックを追加できます。 リポジトリを分類するのに役立つトピックには、そのリポジトリの意図する目的、主題の領域、コミュニティ、言語などがあります。

パブリック、プライベート、内部のリポジトリにはトピックを含めることができますが、トピック検索結果にはアクセスできるプライベート リポジトリのみが表示されます。

特定のトピックに関連付けられているリポジトリを検索できます。 詳しくは、「リポジトリを検索する」を参照してください。 また、GitHub Enterprise Server 上でトピックのリストを検索することもできます。 詳しくは、「トピックを検索する」を参照してください。

トピックを作成するとき:

  • 小文字、数字、およびハイフンを使います。
  • 50 文字以下にします。
  • 20 トピックまで追加できます。

Topics をリポジトリに追加する

注: トピック名は、プライベート リポジトリ内からトピックを作成した場合でも、常にパブリックになります。

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. ページの右上隅にある [概要] の右側にある をクリックします。

    リポジトリのメイン ページの右上にあるスクリーンショット。 歯車アイコンとして表示される [リポジトリ メタデータの編集] ボタンは、オレンジ色の枠線で囲まれています。

  3. [トピック] で、リポジトリに追加するトピックを入力し、一致するトピックのドロップダウン メニューを表示します。 追加するトピックをクリックするか、入力を続けて新しいトピックを作成します。

    "docs" と "works-with-codespaces" のトピックの例を示す [トピック] フィールドのスクリーンショット。 "提案" トピックの "documentation" が下に表示されています。

  4. 省略可能です。[トピック] フィールドに "提案" トピックが表示されている場合は、 をクリックして追加するか、 をクリックして提案されたトピックを辞退します。

  5. トピックの追加が終わったら、 [変更の保存] をクリックします。