Skip to content
This repository has been archived by the owner. It is now read-only.

etiennebacher/docsifier

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
R
 
 
 
 
 
 
man
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

This repo is archived. See altdoc instead

docsifier

The goal of {docsifier} is to provide helper functions to create the documentation of an R package or project with docsify.js.

Installation

You can install the development version with:

# install.packages("devtools")
devtools::install_github("etiennebacher/docsifier")

Basic demo

This is a small demo that shows the main steps for creating the documentation. For more details about e.g customization, or deployment, check out the website.

First, let’s create a package called dummy using RStudio buttons (New Project > New Directory > R Package). This package has the following structure:

.
├── DESCRIPTION
├── NAMESPACE
├── R
│   └── hello.R
├── dummy.Rproj
└── man
    └── hello.Rd

You can do your development workflow as usual. In fact, you can add the documentation whenever you want. Let's create it now.

> library(docsifier)
> init_docsify()

── Import docsify.js files ───────────────────────────────────────────────────────
✓ Folder "docs" has been created.Setting active project to 'path/to/dummy'Adding '^docs$' to '.Rbuildignore'Files "index.html", "homepage.md" and "_sidebar.md" have been created.

── Create content ────────────────────────────────────────────────────────────────
✓ 'Reference' section has been added.File NEWS.md doesn't exist.
ℹ Files LICENSE.md and LICENCE.md don't exist.File CODE_OF_CONDUCT.md doesn't exist.
ℹ No vignettes to transform.

This code has created the folder docs and added basic docsify.js files in it (note that this will not work if you already have a folder "docs").

.
├── DESCRIPTION
├── NAMESPACE
├── R
│   └── hello.R
├── docs
│   ├── _sidebar.md
│   ├── docsify_files
│   │   ├── docsify.min.js
│   │   └── vue.min.css
│   ├── homepage.md
│   ├── index.html
│   └── reference.md
├── dummy.Rproj
└── man
    └── hello.Rd

Finally, you can already run preview_docsify() to see what the documentation looks like.

More details and features on the website.

Code of Conduct

Please note that the docsifier project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

About

Use docsify.js to create the documentation for R projects and packages

Resources

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published