use_pkgdown

use_pkgdown_github_pages

<a href="https://pkgdown.r-lib.org">pkgdown</a> makes it easy to turn your package into
a beautiful website. usethis provides two functions to help you use pkgdown:<ul>
<li><code>use_pkgdown()</code>: creates a pkgdown config file and adds relevant files or
directories to <code>.Rbuildignore</code> and <code>.gitignore</code>.</li>
<li><code>use_pkgdown_github_pages()</code>: implements the GitHub setup needed to
automatically publish your pkgdown site to GitHub pages:<ul>
<li>(first, it calls <code>use_pkgdown()</code>)</li>
<li><code>use_github_pages()</code> prepares to publish the pkgdown site from the
<code>gh-pages</code> branch</li>
<li><code>use_github_action("pkgdown")</code> configures a
GitHub Action to automatically build the pkgdown site and deploy it via
GitHub Pages</li>
<li>The pkgdown site's URL is added to the pkgdown configuration file,
to the URL field of DESCRIPTION, and to the GitHub repo.</li>
<li>Packages owned by certain GitHub organizations (tidyverse, r-lib, and
tidymodels) get some special treatment, in terms of anticipating the
(eventual) site URL and the use of a pkgdown template.</li>
</ul></li>
</ul>

Automate package and project setup tasks that are otherwise
performed manually. This includes setting up unit testing, test
coverage, continuous integration, Git, 'GitHub', licenses, 'Rcpp',
'RStudio' projects, and more.

Jennifer Bryan

usethis

Automate Package and Project Setup

Hadley Wickham

Malcolm Barrett

Andy Teucher

Posit Software, PBC 

use_pkgdown function

<dl><dt>config_file</dt>
<dd>Path to the pkgdown yaml config file, relative to the
project.</dd>
<dt>destdir</dt>
<dd>Target directory for pkgdown docs.</dd></dl>

Arguments

<a href='https://pkgdown.r-lib.org'>pkgdown</a> makes it easy to turn your package into
a beautiful website. usethis provides two functions to help you use pkgdown:<ul>
<li><code>use_pkgdown()</code>: creates a pkgdown config file and adds relevant files or
directories to <code>.Rbuildignore</code> and <code>.gitignore</code>.</li>
<li><code>use_pkgdown_github_pages()</code>: implements the GitHub setup needed to
automatically publish your pkgdown site to GitHub pages:<ul>
<li>(first, it calls <code>use_pkgdown()</code>)</li>
<li><code>use_github_pages()</code> prepares to publish the pkgdown site from the
<code>gh-pages</code> branch</li>
<li><code>use_github_action("pkgdown")</code> configures a
GitHub Action to automatically build the pkgdown site and deploy it via
GitHub Pages</li>
<li>The pkgdown site's URL is added to the pkgdown configuration file,
to the URL field of DESCRIPTION, and to the GitHub repo.</li>
<li>Packages owned by certain GitHub organizations (tidyverse, r-lib, and
tidymodels) get some special treatment, in terms of anticipating the
(eventual) site URL and the use of a pkgdown template.</li>
</ul></li>
</ul>

Use pkgdown — use_pkgdown

<dl>

<dt>config_file</dt>
<dd>Path to the pkgdown yaml config file, relative to the
project.</dd>


<dt>destdir</dt>
<dd>Target directory for pkgdown docs.</dd>

</dl>

use_pkgdown: Use pkgdown

Description

Usage

Arguments

See Also