ecodown: Publish package documents in Quarto

ecodown_convert_versions

R Documentation

Copies and/or converts files from package source into Quarto

Description

Copies and/or converts files from package source into Quarto

Usage

ecodown_convert_versions(
  package_source_folder = "",
  package_name = fs::path_file(package_source_folder),
  quarto_sub_folder = package_name,
  version_folder = "",
  quarto_folder = here::here(),
  downlit_options = FALSE,
  site_url = qe(quarto_folder, "site", "site-url"),
  verbosity = c("verbose", "summary", "silent"),
  convert_readme = TRUE,
  convert_news = TRUE,
  convert_articles = TRUE,
  convert_reference = TRUE,
  reference_folder = "reference",
  vignettes_folder = "articles",
  reference_examples = TRUE,
  reference_examples_not_run = FALSE,
  reference_output = "qmd",
  reference_qmd_options = NULL,
  reference_template = NULL,
  branch = "main",
  package_description = NULL,
  versions = list()
)

Arguments

`package_source_folder`	Path to the package's source code
`package_name`	Name of the package. Defaults to the top folder in the repo URL
`quarto_sub_folder`	Sub folder in `quarto_folder` that will be the base for the package's documentation.
`version_folder`	Folder path to save the documentation version. Examples are: "latest", "dev", "v1.0". Defaults to empty.
`quarto_folder`	Base target Quarto folder. Defaults to current workspace.
`downlit_options`	Flag that indicates if the package name should be added to the 'options()' that tells 'downlit' that this is an internal package
`site_url`	URL of the target site. It defaults to using the address in the '_quarto.yml' file
`verbosity`	Level of messaging available during run time. Possible values are 'verbose', 'summary', and 'silent'.
`convert_readme`	Flag that indicates if the README file needs to be processed
`convert_news`	Flag that indicates if the NEWS file needs to be processed
`convert_articles`	Flag that indicates if the vignette files needs to be processed
`convert_reference`	Flag that indicates if the help files needs to be processed
`reference_folder`	The sub folder where the reference files will be placed. Defaults to "reference".
`vignettes_folder`	The sub folder where the vignette files will be placed. Defaults to "articles".
`reference_examples`	Boolean flag to indicate if the Examples inside the reference page is to be evaluated.
`reference_examples_not_run`	Boolean flag to indicate if the Examples marked as DO NOT RUN is to be ignored and the code should be evaluated.
`reference_output`	File type for all the reference files. Possible options are `qmd` and `md`. Defaults to `qmd`.
`reference_qmd_options`	A character variable that contains the text version of additions to the reference front matter. It applies only to when reference output is `qmd`
`reference_template`	The path to a `.qmd` file to use as the template to create the reference pages.
`branch`	Repo branch. Defaults to 'main'
`package_description`	Custom description for the package. If NULL then the package's Title, inside DESCRIPTION, will be used.
`versions`	A list of additional reference versions to convert. Pass the commit to use, the name of the version, and the sub-folder to use. It expects a named list object. Example: list(list(commit = "latest_commit", path = "dev"))