hrbrmstr / markdowntemplates

:white_check_mark::small_red_triangle_down: A collection of alternate R markdown templates

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

output
html_document md_document
keep_md
true
variant
markdown_github

Build Status

A package of R markdown templates and knitr knit engine replacments

These are a set of alternate R markdown templates that do not use Bootstrap and do not include or rely on jQuery. These are primarily here for demonstration purposes but are also useful in and of themselves (it's always good to have choices). If you have a particular framework you like and it's not here, file an issue and I'll add it.

  • bulma (output: markdowntemplates::bulma) uses the Bulma CSS framework and has optional navlink YAML header elements and also has support for arbitrary footer content & a subset of OpenGraph tags (see the example Rmd) which will be used in header of the generated file.
  • skeleton (output: markdowntemplates::skeleton) or default (output: markdowntemplates::default) uses the Skeleton CSS framework and has optional navlink YAML header elements and also has support for arbitrary footer content & a subset of OpenGraph tags (see the example Rmd) which will be used in header of the generated file.
  • kube (output: markdowntemplates::kube) uses the Kube CSS framework (contributed by Kieran Healy)
  • minimal (output: markdowntemplates::minimal) uses no CSS framework and only uses the title YAML header element.
  • hugo (output: markdowntemplates::hugo) produces markdown suitable for Hugo websites. It makes a broad assumption that you will save/use the hugo document in the content directory of your Hugo websites.
  • prismpress (output: markdowntemplates::prismpress) produces markdown suitable for use in WordPress with Jetpack (markdown-enabled) and Prism
  • prismskel (output: markdowntemplates::hrbrskel) is a revamp of the skeleton template that has top navbar and footer as optional, uses different base colors, is Fira Sans/Fira Code-based and uses Prism for code highlighting with a dark theme.

When you use RStudio to create a new R Markdown document, select "From Template" and choose one of these templates.

knit engine replacements

  • to_jupyter() : uses notedown to make an ipynb out of an Rmd If you create an R markdown (Rmd) document with the following YAML header:


    knit: markdowntemplates::to_jupyter run: false

The to_jupyter() engine will be used and notedown will be used to convert the notebook to a Jupyter (ipynb) notebook. The run parameter is optional. If not present or set to true the notebook will be executed as it is converted to a Jupyter notebook. The engine is also now smart enough to detect the absence of pure R code chunks and avoid including of:

%load_ext rpy2.ipython

at the top of the notebook.

Installation

Since the package is not on CRAN yet, you have to install it devtools-style

devtools::install_git("https://sr.ht/~hrbrmstr/markdowntemplates")
# OR
devtools::install_git("https://gitlab.com/hrbrmstr/markdowntemplates")
# OR
devtools::install_github("hrbrmstr/markdowntemplates")

Bulma example

Skeleton/default example

Kube example

Minimal example

About

:white_check_mark::small_red_triangle_down: A collection of alternate R markdown templates

License:Other


Languages

Language:CSS 69.4%Language:HTML 13.5%Language:JavaScript 10.0%Language:R 7.1%