Badgecreatr was developed with myself in mind. I often create packages on Github and wanted to have a standardized way to add badges to the README file. In Github (and many other code sharing websites) the README.md file on top of the repository is automatically rendered as HTML (a normal webpage) and can be viewed by everyone in the browser with full markup.
I've written a blogpost about the older version of this package here
I've also added a vignette describing how you can add new badges to this package.
Many projects have shields that signal the status of the project. When you make use of continuous integration (CI) tools such as travis-ci, you let the service rebuild and retest your package after every commit to Github. Travis has a badge that signals if the build passed or not. I've added extra information such as under what license the code is shared, the latest change in the package and what version the package has.
Keep in mind that I don't create all of the badges (only 2 are of my invention), this package is just a convenient way to place badges in your readme.
I realized that I don't often use the package in its original form anymore, so the use cases might change. I've identified some cases.
You just want to add a badge for projectstatus. All the badges start with badge_. So adding badges is as simple as typing badge_ and looking through the options.
library(badgecreatr) badge_projectstatus("wip") # any of concept, wip, suspended, abandoned, active, inactive, unsupported
The badge functions result in markdown that you can paste into your readme file. This would input the current date.
I imagin using this to add some quick badges that you might update later but it communicates the basic properties of the package:
minimal_badges(status = "concept", license = "MIT",date = "2017-05-17")
You add badges that change everytime you re-knit your document so that everything stays up to date.
Communicate - Maturity (project status) - license - Last change - minimal r version - package version - travis badge (when a travis file is available) - codecov badge (when this is specified in the travis file)
dynamic_badges_minimal(license = "MIT", travisfile = TRUE, codecov = TRUE)
# is not implemented yet. place_badge_groups( CI_status = c("travis", "rwin"), versions = c("CRAN", "github"), stats = c("downloads, gh_stars"))
Since markdown cannot process R, we add badges once.
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.