This commit is contained in:
Valentin Brandl 2019-04-20 14:54:57 +02:00
parent 84e76b3986
commit a06e0e3fae
No known key found for this signature in database
GPG Key ID: 30D341DD34118D7D

View File

@ -32,56 +32,62 @@ gives an overview about the amount of work put into a codebase.
There is a <a href="https://github.com/yegor256/hoc/">command-line tool</a> to calculate the HoC of a repository, but There is a <a href="https://github.com/yegor256/hoc/">command-line tool</a> to calculate the HoC of a repository, but
some people might want a nice badge to put in their README, that's why I implemented this API. Currently the API can be some people might want a nice badge to put in their README, that's why I implemented this API. Currently the API can be
used for GitHub, GitLab and Bitbucket repositories. Just put the following code in your README: used for GitHub, GitLab and Bitbucket repositories. Just put the following code in your README:
</p>
<pre> <pre>
[![Hits-of-Code](https://hitsofcode.com/&lt;service&gt;/&lt;user&gt;/&lt;repo&gt;)](https://hitsofcode.com/view/&lt;service&gt;/&lt;user&gt;/&lt;repo&gt;) [![Hits-of-Code](https://hitsofcode.com/&lt;service&gt;/&lt;user&gt;/&lt;repo&gt;)](https://hitsofcode.com/view/&lt;service&gt;/&lt;user&gt;/&lt;repo&gt;)
</pre> </pre>
<p>
where <code>&lt;service&gt;</code> is one of <code>github</code>, <code>gitlab</code> or <code>bitbucket</code>. So the where <code>&lt;service&gt;</code> is one of <code>github</code>, <code>gitlab</code> or <code>bitbucket</code>. So the
following Markdown following Markdown
</p>
<pre> <pre>
[![Hits-of-Code](https://hitsofcode.com/github/vbrandl/hoc)](https://hitsofcode.com/view/github/vbrandl/hoc) [![Hits-of-Code](https://hitsofcode.com/github/vbrandl/hoc)](https://hitsofcode.com/view/github/vbrandl/hoc)
</pre> </pre>
<p>
would render this badge: would render this badge:
</p>
<pre> <pre>
<a href="https://hitsofcode.com/view/github/vbrandl/hoc"><img src="https://hitsofcode.com/github/vbrandl/hoc" /></a> <a href="https://hitsofcode.com/view/github/vbrandl/hoc"><img src="https://hitsofcode.com/github/vbrandl/hoc"
alt="example badge" /></a>
</pre> </pre>
</p>
<h2>Colors</h2> <h2>Colors</h2>
<p> <p>
You can generate badges with custom colors via the <code>color</code> query parameter. The following predefined colors You can generate badges with custom colors via the <code>color</code> query parameter. The following predefined colors
are supported: are supported:
</p>
<pre> <pre>
<img src="/badge?color=brightgreen" /> <img src="/badge?color=brightgreen" alt="brightgreen example badge" />
<img src="/badge?color=green" /> <img src="/badge?color=green" alt="green example badge" />
<img src="/badge?color=yellowgreen" /> <img src="/badge?color=yellowgreen" alt="yellowgreen example badge" />
<img src="/badge?color=yellow" /> <img src="/badge?color=yellow" alt="yellow example badge" />
<img src="/badge?color=orange" /> <img src="/badge?color=orange" alt="orange example badge" />
<img src="/badge?color=red" /> <img src="/badge?color=red" alt="red example badge" />
<img src="/badge?color=blue" /> <img src="/badge?color=blue" alt="blue example badge" />
<img src="/badge?color=lightgrey" /> <img src="/badge?color=lightgrey" alt="lightgrey example badge" />
<img src="/badge?color=success" /> <img src="/badge?color=success" alt="success example badge" />
<img src="/badge?color=important" /> <img src="/badge?color=important" alt="important example badge" />
<img src="/badge?color=critical" /> <img src="/badge?color=critical" alt="critical example badge" />
<img src="/badge?color=informational" /> <img src="/badge?color=informational" alt="informational example badge" />
<img src="/badge?color=inactive" /> <img src="/badge?color=inactive" alt="inactive example badge" />
</pre> </pre>
</p>
<p> <p>
You can also pass HTML color codes: You can also pass HTML color codes:
</p>
<pre> <pre>
<img src="/badge?color=ff69b4" /> <img src="/badge?color=9cf" /> <img src="/badge?color=ff69b4" alt="long HTML color code example badge" /> <img src="/badge?color=9cf" alt="short HTML
color code example badge" />
</pre> </pre>
</p>
<h2>Source Code</h2> <h2>Source Code</h2>