Skip to content

sahilseth/readthedocs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RTD

A wrapper around staticdocs providing a way to port R documentation into a readthedocs flavored website.

See here for an example.

Features:

  • Sphnix/readthedocs provides a convinient way to produce a beautiful, searchable and powerful website.
  • Further, Sphinx provides an excellent ( and powerful ) tree structure for organizing the docs
  • this packages, makes it easy to convert all markdown vignettes and R help files to ReSt format
  • Thus, one can use Markdown, but still use the power of ReadTheDocs (Sphinx).
# install.packages("devtools")
devtools::install_github("sahilseth/readthedocs")
library(staticdocs)
librar(readthedocs)
require(tools)
outwd = "flowrdocs/source/rd" ## assuming sphnix reads from the source directory
pkg = staticdocs::as.sd_package(pkg = ".",
                                site_path = outwd,
                                templates_path = system.file("templates", package = "readthedocs"))
tmp <- build_topics(pkg = pkg)
tmp <- build_vignettes(pkg = pkg)

Then one needs to call sphnix to build the website locally OR update this to github and point readthedocs.org to it. Refer to readthedocs for more information regarding this setup.

About

Create readthedocs website for a R package

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages