#!mathjax#

R Markdown with the Docco Classic Style

This is an example of Markdown vignettes using the Docco style.

Docco

To use the Docco style for Markdown vignettes in an R package, you need to

  • add *.Rmd files under the vignettes directory
  • add Suggests: knitr and VignetteBuilder: knitr to the DESCRIPTION file
  • specify the vignette engine \VignetteEngine{knitr::docco_classic} in the Rmd files (inside HTML comments)

After building and installing the package, you can view vignettes via

browseVignettes(package = 'Your_Package')

Examples

Below are some code chunks as examples.

cat('_hello_ **markdown**!', '\n')

hello markdown!

Normally you do not need any chunk options.

1+1
## [1] 2
10:1
##  [1] 10  9  8  7  6  5  4  3  2  1
rnorm(5)^2
## [1] 0.02793 0.06013 2.93306 0.58198 0.04078
strsplit('hello, markdown vignettes', '')
## [[1]]
##  [1] "h" "e" "l" "l" "o" "," " " "m" "a" "r" "k" "d" "o" "w" "n" " " "v" "i" "g"
## [20] "n" "e" "t" "t" "e" "s"

Feel free to draw beautiful plots and write math \(P(X>x)=\alpha/2\).

plot of chunk unnamed-chunk-3

n=300; set.seed(123)
par(mar=c(4,4,.1,.1))
plot(rnorm(n), rnorm(n), pch=21, cex=5*runif(n), col='white', bg='gray')

How does it work

The markdown package (>= v0.6.2) supports custom HTML templates, and the docco engine in knitr uses a custom template to compile Markdown to HTML:

head(knitr::rocco, 5)
##                                                                                    
## 1 function (input, ...)                                                            
## 2 {                                                                                
## 3     out = knit2html(input, ..., meta = list(css = system.file("misc",            
## 4         "docco-classic.css", package = "knitr")), template = system.file("misc", 
## 5         "docco-classic.html", package = "knitr"))

That is it.

You probably have noticed that you can adjust the widths of the two columns using your cursor. What is more, press T on your keyboard, and see what happens.