Introducing the new rOpenSci docs server

[This article was first published on rOpenSci - open tools for open science, and kindly contributed to R-bloggers]. (You can report issue about the content on this page here)
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

As part of our continuous effort to improve rOpenSci infrastructure, we are rolling out a new service to automatically build and host documentation for all rOpenSci packages.


The webpages are generated using the popular pkgdown system with our rOpenSci template, and get automatically published on Some examples:

As we are still rolling this out, not all packages are there yet, but the majority is online now. We hope this becomes the central place to find documentation for rOpenSci packages.

Zero setup required

What do you need to do as an rOpenSci package maintainer to set this up? Nothing! Each commit to the master branch of your repository automatically triggers a build on our new development server. We do not generate documentation for feature branches and pull requests, only for master.


To check your build logs, click the checkmark behind the commit in your Github repository. There will be a new build status ropensci/pkgdown that links to the build log for that commit. If the build is failing and you can’t figure out the problem from the logs, please get in touch.


You can also check out the dashboard at to see status and build histories from all rOpenSci packages.

Testing and customizing your site

Our build server uses the standard pkgdown functions to generate the docs; we only override the URL and theming. To test your site locally, install our theme and then render your site with pkgdown:

# Install the rOpenSci theme

# Run in your package directory to build the site:
template <- list(package = "rotemplate")
pkgdown::build_site(override = list(template = template))

To customize the site you can use any of the standard options in the _pkgdown.yml file as described in the pkgdown documentation. If you already had a pkgdown site, the system will automatically use your existing _pkgdown.yml file. You can also have a look at pkgdown configs from other packages.

In Conclusion

We hope that the documentation server will become a valuable resource to rOpenSci package users and maintainers. All rOpenSci packages get a canonical URL with a beautiful up-to-date homepage, vignettes, and manual pages, without the need for complicated travis hooks and deploy keys.

Moreover, documentation hosted on will benefit from the joined pagerank for this domain which boosts the position on Google and other search engines. Hence by centralizing, we simulatnously increase the visibility and reduce maintenance work for rOpenSci packages.

If this works well, we plan to experiment with more new infrastructural services to support rOpenSci ecosystem, with the goal of making it easier to find, use, and maintain our software.

To leave a comment for the author, please follow the link and comment on their blog: rOpenSci - open tools for open science. offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

Never miss an update!
Subscribe to R-bloggers to receive
e-mails with the latest R posts.
(You will not see this message again.)

Click here to close (This popup will not appear again)