Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/r-lib/pkgdown
Generate static html documentation for an R package
https://github.com/r-lib/pkgdown
documentation-tool package r
Last synced: 6 days ago
JSON representation
Generate static html documentation for an R package
- Host: GitHub
- URL: https://github.com/r-lib/pkgdown
- Owner: r-lib
- License: other
- Created: 2012-03-15T00:36:24.000Z (almost 13 years ago)
- Default Branch: main
- Last Pushed: 2024-12-20T14:36:07.000Z (22 days ago)
- Last Synced: 2025-01-03T05:58:24.623Z (8 days ago)
- Topics: documentation-tool, package, r
- Language: R
- Homepage: https://pkgdown.r-lib.org/
- Size: 32.7 MB
- Stars: 724
- Watchers: 17
- Forks: 336
- Open Issues: 45
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- jimsghstars - r-lib/pkgdown - Generate static html documentation for an R package (R)
README
---
output: github_document
---
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/"
)
```
# pkgdown 
[](https://cran.r-project.org/package=pkgdown){.pkgdown-release}
[](https://github.com/r-lib/pkgdown/actions/workflows/R-CMD-check.yaml){.pkgdown-devel}
[](https://app.codecov.io/gh/r-lib/pkgdown?branch=main)
pkgdown is designed to make it quick and easy to build a website for your package. You can see pkgdown in action at : this is the output of pkgdown applied to the latest version of pkgdown. Learn more in `vignette("pkgdown")` or `?build_site`.
## Installation
::: .pkgdown-release
```{r, eval = FALSE}
# Install released version from CRAN
install.packages("pkgdown")
```
:::
::: .pkgdown-devel
```{r, eval = FALSE}
# Install development version from GitHub
# install.packages("pak")
pak::pak("r-lib/pkgdown")
```
:::
## Usage
Get started with [usethis](https://usethis.r-lib.org/):
```{r, eval = FALSE}
# Run once to configure your package to use and deploy pkgdown
usethis::use_pkgdown_github_pages()
```
```{r, eval = FALSE}
# Preview your site locally before publishing
pkgdown::build_site()
```
This adds the necessary components and sets up GitHub Actions[^1] for automatic site building when deploying.
Your `README.md` becomes the homepage, documentation in `man/` generates a function reference, and vignettes will be rendered into `articles/`.
[^1]: If you don't use GitHub, you can use `usethis::use_pkgdown()` + `pkgdown::build_site()` to create a website.
### pkgdown 2.0.0 and Bootstrap 5
pkgdown 2.0.0 includes an upgrade from Bootstrap 3 to Bootstrap 5, which is accompanied by a whole bunch of minor UI improvements. If you've heavily customised your site, there's a small chance that this will break your site, so everyone needs to explicitly opt-in to the upgrade by adding the following to `_pkgdown.yml`:
```yaml
template:
bootstrap: 5
```
Then learn about the many new ways to customise your site in `vignette("customise")`.
## In the wild
At last count, pkgdown is used [by over 12,000 packages](https://github.com/search?q=path%3A_pkgdown.yml+language%3AYAML&type=code&l=YAML). Here are a few examples:
* [bayesplot](http://mc-stan.org/bayesplot/index.html)
([source](https://github.com/stan-dev/bayesplot/tree/gh-pages)):
plotting functions for posterior analysis, model checking, and MCMC
diagnostics.
* [valr](https://rnabioco.github.io/valr/)
([source](https://github.com/rnabioco/valr)):
read and manipulate genome intervals and signals.
* [mkin](https://pkgdown.jrwb.de/mkin/)
([source](https://github.com/jranke/mkin)):
calculation routines based on the FOCUS Kinetics Report
* [NMF](http://renozao.github.io/NMF/master/index.html)
([source](https://github.com/renozao/NMF)):
a framework to perform non-negative matrix factorization (NMF).
* [tidyverse and r-lib packages source](https://github.com/search?q=path%3A%22_pkgdown.yml%22+AND+%28org%3Atidyverse+OR+org%3Ar-lib%29&type=code)
Comparing the source and output of these sites is a great way to learn new pkgdown techniques.
## Code of conduct
Please note that this project is released with a [Contributor Code of Conduct](https://pkgdown.r-lib.org/CODE_OF_CONDUCT.html). By participating in this project you agree to abide by its terms.