Create a Quarto file that lists the available reference pages

R/index_to_qmd.R

index_to_qmd

Description

Create a Quarto file that lists the available reference pages

Usage

index_to_qmd(pkg = ".", template = NULL, quarto_file_path = NULL)

Arguments

Arguments Description
pkg Path to the root of the R package. Defaults to ".".
template The path to a Quarto file that can be used as the template for all of the resulting reference files. If left NULL, pkgsite will use its default template.
quarto_file_path Path to the folder containing _quarto.yml. Use when the Quarto project root differs from the package root (e.g. the package lives in a sub-folder of a larger Quarto project). Must be a directory path. Defaults to NULL, in which case pkg is used.

Value

A character vector with the contents of a document that links to the converted Quarto documents.

Examples

library(pkgsite)
example_pkg <- system.file("example", package = "pkgsite")
index_to_qmd(pkg = example_pkg)
#>  [1] "---"                                                                                              
#>  [2] "title: Package index"                                                                             
#>  [3] "toc: false"                                                                                       
#>  [4] "---"                                                                                              
#>  [5] ""                                                                                                 
#>  [6] "### Conversion functions"                                                                         
#>  [7] ""                                                                                                 
#>  [8] "[index_to_qmd()](index_to_qmd.qmd)"                                                               
#>  [9] ""                                                                                                 
#> [10] ""                                                                                                 
#> [11] "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a Quarto file that lists the available reference pages"
#> [12] ""                                                                                                 
#> [13] "[rd_to_list()](rd_to_list.qmd)"                                                                   
#> [14] ""                                                                                                 
#> [15] ""                                                                                                 
#> [16] "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Converts a given 'Rd' file into a list object"                
#> [17] ""                                                                                                 
#> [18] "[rd_to_qmd()](rd_to_qmd.qmd)"                                                                     
#> [19] ""                                                                                                 
#> [20] ""                                                                                                 
#> [21] "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Converts 'Rd' to Quarto files"                                
#> [22] ""

See Also

Other Conversion functions: rd_to_list(), rd_to_qmd()