2015-05-25 12:28:50 +00:00
# Luzifer / badge-gen
Ever ran into this scenario? You wanted to add a link to something to your GitHub project using a nice button like the Godoc or the Travis-CI button but you was not able to find a button for this having the text you wanted? I did. I wanted to add a button "API Documentation" to one of my projects and did not find any button with that caption. So I wrote it myself.
And I wasn't myself if I would allow me to do the same work twice or more often so I wrote a small webserver able to generate those buttons with a customizable text in SVG (I did not care about older browser since long ago)…
## Usage
### Using my version
2016-06-28 19:25:50 +00:00
Simple use the raw-API URL below or one of the URLs in the table at the bottom of this page:
2015-05-25 12:28:50 +00:00
```
2016-06-28 18:00:52 +00:00
https://badge.luzifer.io/v1/badge?title=API& text=Documentation& color=4c1
2015-05-25 12:28:50 +00:00
```
Parameters `title` and `text` are free-text strings while `color` has to be 3- or 6-letter hex notation for colors like that one you use in CSS.
To embed them into Markdown pages like this `README.md` :
```
2016-06-28 18:00:52 +00:00
![YourTitle ](https://badge.luzifer.io/static/API/Documentation/4c1 )
2015-05-25 12:28:50 +00:00
```
### Using your own hosted version
2016-06-28 19:33:21 +00:00
- There is a [Docker container ](https://quay.io/repository/luzifer/badge-gen ) for it. Just start it and use your own URL
2015-05-25 12:28:50 +00:00
- You also can download the binary from [GoBuilder.me ](https://gobuilder.me/github.com/Luzifer/badge-gen ) and use that one
2015-05-25 16:13:53 +00:00
### Popular buttons rebuilt
Hint: To get the source just look into the source of this README.md
2016-06-28 18:00:52 +00:00
![godoc reference ](https://badge.luzifer.io/static/godoc/reference/5d79b5 )
![API Documentation ](https://badge.luzifer.io/static/API/Documentation/4c1 )
![gratipay support ](https://badge.luzifer.io/static/gratipay/support%20myproject/4c1 )
![gitter chat ](https://badge.luzifer.io/static/GITTER/JOIN%20CHAT/1dce73 )
![achievement ](https://badge.luzifer.io/static/Achievement/You%20found%20a%20badge!/911 )
2015-05-25 16:13:53 +00:00
Yeah, sure you even could fake your Travis-CI build status but seriously: Why should you do that? Shame on you if you do!
2016-06-28 19:25:50 +00:00
### Services
| Service | Example | URL Format |
| ------------ | ---------------------------------------------------------- | -------------------------------- |
| Static Badge | ![](https://badge.luzifer.io/static/API/Documentation/4c1) | `/static/<title>/<text>/<color>` |
| Travis-CI | ![](https://badge.luzifer.io/travis/Luzifer/password) | `/travis/<user>/<repo>/[branch]` |