これは、SVGおよびラスター形式の簡潔で一貫した、読みやすいバッジのサービスであるShields.ioの本拠地であり、GitHub Readmesまたはその他のWebページに簡単に含めることができます。このサービスは、数十の継続的な統合サービス、パッケージレジストリ、分布、アプリストア、ソーシャルネットワーク、コードカバレッジサービス、およびコード分析サービスをサポートしています。毎月16億以上の画像を提供しており、世界で最も人気のあるオープンソースプロジェクト、vs Code、Vue.JS、Bootstrapで使用されています。
このリポジトリは次のとおりです。
あなた自身のバッジを作りましょう! (簡単な例: https://img.shields.io/badge/left-right-f39f37 )
バッジの完全なリストを閲覧し、検索バーを使用するか、カテゴリを閲覧して特定のバッジを見つけます。バッジをクリックして、そのバッジタイプに必要なデータ要素(ユーザー名やリポジトリなど)に入力し、オプションでカスタマイズ(ラベル、色など)。そして、それは使用する準備ができています!
下部のボタンを使用して、バッジURLまたはスニペットをコピーして、GitHub ReadMeファイルやその他のWebページなどの場所に追加できます。
Shieldsはコミュニティプロジェクトです。私たちは問題を通じてあなたの参加を招待し、リクエストをプルします!貢献ガイドラインを熟読することができます。
サービスを追加または変更するときは、テストを追加してください。
このプロジェクトには、提案のかなりのバックログがあります!プロジェクトを初めて使用する場合は、そのうちの1つに対処するためのプルリクエストを開きたいと思うかもしれません。
バッジの追加方法に関するチュートリアルを読むことができます。
セキュリティの脆弱性に関連する修正を報告または貢献する場合は、まずセキュリティポリシーを参照してください。
npm ciを実行して、依存関係をインストールします。npm startを実行して、バッジサーバーとFrontend Devサーバーを起動します。http://localhost:3000/を開きます。フロントエンドを表示します。サーバーソースファイルが変更されると、バッジサーバーは自動的に自動的に再起動する必要があります(Nodemonを使用)。フロントエンドファイルが変更されると、Frontend Dev Server( docusaurus start )も自動的にリロードする必要があります。ただし、バッジ定義は、サーバーが最初に開始される前にのみ構築されます。それらを再生するには、 npm run prestartか、サーバーを手動で再起動します。
コマンドラインからバッジをデバッグするには、 npm run badge -- /npm/v/nock実行します。また、 npm run badge -- https://img.shields.io/npm/v/nockなどの完全なURL)でも動作します。
npm run debug:serverを使用して、デバッグモードでサーバーを起動します。このレシピは、vsコードでnode.jsアプリケーションをデバッグする方法を示しています。
Shieldsには、ブラウザで実行される事前に構成された開発環境であるGitPodの実験的サポートがあります。 gitpodを使用するには、下のボタンをクリックして、githubでサインインします。 GitPodはブラウザアドオンも提供していますが、必須ではありません。第2772号のgitpodバグ、質問、または提案を報告してください。
スナップショットテストにより、SVGまたはJSON出力に影響を与える変更を不注意に行わないようにします。故意に出力を変更する場合、 SNAPSHOT_DRY=1 npm run test:package 、およびSNAPSHOT_UPDATE=1 npm run test:package 。
サーバーは、Sentry(構成)とPrometheus(構成)を使用するように構成できます。
私たちの完全なテストスイートとコードカバレッジは、毎日実行されます。
独自のサーバーのホストに関するドキュメントがあります。
ステータスバッジは、オープンソースおよびプライベートソフトウェアプロジェクト全体で広く使用されています。アカデミックは、ソフトウェアプロジェクトの品質について「信号」バッジが提供することを研究しています。これらのバッジをレンダリングするための多くの既存のライブラリがあり、ホストされたシールズバッジサービスに代わるものがあります。 Awesome-Badgesは、このようなリソースのキュレーションされたコレクションです。そこには貢献が考慮される場合があります。 (そのコレクションにおけるプロジェクトの存在は、Shieldsプロジェクトからの承認や昇進として解釈されるべきではありません)
b.adge.meは、このサービスの元のWebサイトでした。当時のHerokuには、Toplevel Domainを使用するのが難しくなったものがあり、それゆえ奇妙なドメインがありました。 2013年にThaddéeTylによって開発されたGHバッジと呼ばれるライブラリから開発されたコードを使用しました。このプロジェクトは、b.adge.meコードと閉じたb.adge.meを使用することにより、shields.ioと合併しました。
元のバッジ仕様は、2013年にOlivier Lacanによって開発されました。 Travis CIや同様のバッジに触発されました(当時ははるかに少なかった)。 2014年、ThaddéeTylはTravis CIの従業員の助けを借りてそれを再設計し、全員にそれに切り替えるよう説得しました。古いデザインは、今日のプラスチックスタイルと呼ばれるものです。新しいものはフラットスタイルです。
プロジェクトの開始、SVGバッジ仕様の動機、および仕様自体について詳しく読むことができます。
メンテナー:
卒業生:
すべての資産とコードは、特に指定されていない限り、CC0ライセンスとパブリックドメインにあります。
プロジェクトを実行し続けるためにお金、サービス、または時間を寄付してくれた人々と企業に感謝します。 https://shields.io/community