First looks for index.Rmd or README.Rmd, then index.md or README.md. If none are found, falls back to the description field in DESCRIPTION.

build_home(pkg = ".", override = list(), preview = NA, quiet = TRUE)

## Arguments

pkg Path to package. An optional named list used to temporarily override values in _pkgdown.yml If TRUE, or is.na(preview) && interactive(), will preview freshly generated section in browser. Set to FALSE to display output of knitr and pandoc. This is useful when debugging.

## Images and figures

If you want to images in your README.md, they must be stored in somewhere in the package so that they can be displayed on the CRAN website. The best place to put them appears to be man/figures. If you are generating figures with R Markdown, make sure you set up fig.path as followed:

{r, include = FALSE}
knitr::opts_chunk\$set(
fig.path = "man/figures/"
)



## YAML config

To tweak the home page, you need a section called home.

The sidebar links are automatically generated by inspecting the URL and BugReports fields of the DESCRIPTION. You can add additional links with a subsection called links, which should contain a list of text + href elements:

home:
href: http://website.com


The "developers" list is populated by the maintainer ("cre"), authors ("aut"), and funder ("fnd").

You can remove the first heading with

home: