forked from r-lib/usethis
-
Notifications
You must be signed in to change notification settings - Fork 0
/
use_pkgdown.Rd
45 lines (41 loc) · 1.53 KB
/
use_pkgdown.Rd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/pkgdown.R
\name{use_pkgdown}
\alias{use_pkgdown}
\alias{use_pkgdown_github_pages}
\alias{use_pkgdown_travis}
\title{Use pkgdown}
\usage{
use_pkgdown(config_file = "_pkgdown.yml", destdir = "docs")
use_pkgdown_github_pages()
use_pkgdown_travis()
}
\arguments{
\item{config_file}{Path to the pkgdown yaml config file}
\item{destdir}{Target directory for pkgdown docs}
}
\description{
\href{https://pkgdown.r-lib.org}{pkgdown} makes it easy to turn your package into
a beautiful website. usethis provides two functions help you use pkgdown:
\itemize{
\item \code{use_pkgdown()}: creates a pkgdown config file, adds relevant files or
directories to \code{.Rbuildignore} and \code{.gitignore}, and builds favicons if
your package has a logo.
\item \code{use_pkgdown_github_pages()}: implements the GitHub setup needed to
automatically publish your pkgdown site to GitHub pages:
\itemize{
\item \code{\link[=use_github_pages]{use_github_pages()}} prepares to publish the pkgdown site from the
\code{github-pages} branch
\item \code{\link[=use_github_action]{use_github_action("pkgdown")}} configures a
GitHub Action to automatically build the pkgdown site and deploy it via
GitHub Pages
\item The pkgdown site's URL is added to the pkgdown configuration file,
to the URL field of DESCRIPTION, and to the GitHub repo.
}
}
\code{use_pkgdown_travis()} is deprecated; we no longer recommend that you use
Travis-CI.
}
\seealso{
\url{https://pkgdown.r-lib.org/articles/pkgdown.html#configuration}
}