76 lines
2.0 KiB
Markdown
76 lines
2.0 KiB
Markdown
# GitHub badges in SVG format
|
|
|
|
[](https://npmjs.org/package/gh-badges)
|
|
|
|
Make your own [badges][] (like this one above)!
|
|
|
|
[badges]: <http://b.adge.me>
|
|
|
|
# Contribute
|
|
|
|
If you want to add a badge, you only need to modify `default-badges.json`.
|
|
|
|
The format is the following:
|
|
|
|
```js
|
|
/* Unique name of your badge. */
|
|
"build-passed": {
|
|
/* Textual information shown, in order. */
|
|
"text": [ "build", "passed" ],
|
|
"colorscheme": "green"
|
|
}
|
|
```
|
|
|
|
Color schemes are located in `colorscheme.json`. Each scheme has a name and
|
|
a [CSS/SVG color][] for the
|
|
color used in the first box (for the first piece of text, field `colorA`) and
|
|
for the one used in the second box (field `colorB`).
|
|
|
|
[CSS/SVG color]: http://www.w3.org/TR/SVG/types.html#DataTypeColor
|
|
|
|
```js
|
|
"green": {
|
|
"colorB": "#4c1"
|
|
}
|
|
```
|
|
|
|
Both `colorA` and `colorB` have default values. Usually, the first box uses the
|
|
same dark grey, so you can rely on that default value by not providing a
|
|
`"colorA"` field (such as above).
|
|
|
|
You can also use the `"colorA"` and `"colorB"` fields directly in the badges if
|
|
you don't want to make a color scheme for it. In that case, remove the
|
|
`"colorscheme"` field altogether.
|
|
|
|
# Requirements
|
|
|
|
Because of the usage of the npm module [canvas][canvas-pkg] *you need* to have **cairo** installed.
|
|
|
|
For more information check the [wiki][canvas-wiki] of the canvas project with system-specific installation details.
|
|
|
|
[canvas-pkg]: https://npmjs.org/package/canvas
|
|
[canvas-wiki]: https://github.com/LearnBoost/node-canvas/wiki/_pages
|
|
|
|
# Making your Heroku badge server
|
|
|
|
Once you have installed the [Heroku Toolbelt][]
|
|
|
|
[Heroku Toolbelt]: (https://toolbelt.heroku.com/):
|
|
|
|
```bash
|
|
heroku login
|
|
heroku create your-app-name
|
|
heroku config:set BUILDPACK_URL=https://github.com/mojodna/heroku-buildpack-multi.git#build-env
|
|
cp /path/to/Verdana.ttf .
|
|
make deploy
|
|
heroku open
|
|
```
|
|
|
|
# Origin
|
|
|
|
See <https://github.com/h5bp/lazyweb-requests/issues/150>.
|
|
|
|
# License
|
|
|
|
All work here is licensed CC0.
|