Readme Badges#
These are example badges in Markdown that we typically put just below the header of the README.md file of the repository. See for example jupyterhub/kubespawner. Most of the badges get the image representing the badge itself from shields.io.
About shields.io#
The badges is typically customized by passing query string parameters, to better understand these lets consider the most complicated badge in this list, the Helm chart badges.
The Helm chart badges are constructed on
https://img.shields.io/badge/dynamic/json.svg
as a foundation along with a set
of query strings.
label=stable
url=https://jupyterhub.github.io/helm-chart/info.json
query=$.jupyterhub.stable
colorB=orange
logo=helm
In this case, the badge is customized to fetch json data from an URL and fetch the specific section in the json data as defined by the query. Here is the final result.
https://img.shields.io/badge/dynamic/json.svg?label=stable&url=https://jupyterhub.github.io/helm-chart/info.json&query=$.jupyterhub.stable&colorB=orange&logo=helm
Note that we specified a color for this badge, often that is automatically assigned based on the the SemVer version, where something versioned 1.0.0 will become blue while something versioned 0.9.0 would be orange. This was not automatically determined for the Helm chart badge so it was explicitly specified.
Badges#
Build#
[](https://jupyterhub.readthedocs.org/en/latest/)
[](https://circleci.com/gh/jupyterhub/jupyterhub)
[](https://travis-ci.org/jupyterhub/jupyterhub)
[](https://travis-ci.com/jupyterhub/jupyterhub)
[](https://dev.azure.com/jupyter/repo2docker/_build)
[](https://hub.docker.com/r/jupyterhub/jupyterhub/tags)
[](https://codecov.io/gh/jupyterhub/jupyterhub)
Package#
[](https://pypi.python.org/pypi/jupyterhub)
[](https://anaconda.org/conda-forge/jupyterhub)
[](https://www.npmjs.com/package/configurable-http-proxy)
[](https://jupyterhub.github.io/helm-chart/)
[](https://jupyterhub.github.io/helm-chart/)
[](https://jupyterhub.github.io/helm-chart/)
Community#
[](https://github.com/jupyterhub/jupyterhub/issues)
[](https://discourse.jupyter.org/c/jupyterhub)
[](https://jupyter.zulipchat.com/#narrow/channel/469744-jupyterhub)