Type: Package
Title: Creating Pretty Documents from R Markdown
Version: 0.4.1
Date: 2021-01-10
Description: Creating tiny yet beautiful documents and vignettes from R Markdown. The package provides the 'html_pretty' output format as an alternative to the 'html_document' and 'html_vignette' engines that convert R Markdown into HTML pages. Various themes and syntax highlight styles are supported.
Imports: rmarkdown (≥ 1.17)
Suggests: knitr, KernSmooth
SystemRequirements: pandoc (>= 1.12.3)
VignetteBuilder: knitr, rmarkdown
URL: https://github.com/yixuan/prettydoc
BugReports: https://github.com/yixuan/prettydoc/issues
License: Apache License (≥ 2.0)
Encoding: UTF-8
LazyData: true
RoxygenNote: 7.1.1
NeedsCompilation: no
Packaged: 2021-01-10 09:47:23 UTC; qyx
Author: Yixuan Qiu [aut, cre], Jason Long [ctb] (the Cayman, Tactile and Architect themes), Renyuan Zou [ctb] (the Leonids theme), Michael Rose [ctb] (the HPSTR theme), JJ Allaire [ctb] (pandoc template for rmarkdown), Hadley Wickham [ctb] (the html_vignette() function), Yihui Xie [ctb] (the html_vignette() function), Steve Matteson [ctb] (the Open Sans fonts), Emily Eisenberg [ctb] (the KaTeX library), Sophie Alpert [ctb] (the KaTeX library)
Maintainer: Yixuan Qiu <yixuan.qiu@cos.name>
Repository: CRAN
Date/Publication: 2021-01-10 11:40:03 UTC

Creating Pretty HTML from R Markdown

Description

This function is an alternative to the html_document and html_vignette formats to create HTML document from R Markdown. It generates small yet pretty HTML pages that are suitable for publishing project pages and package vignettes. See the online documentation for more details.

Usage

html_pretty(
  theme = "cayman",
  highlight = NULL,
  css = NULL,
  math = c("mathjax", "katex"),
  fig_retina = NULL,
  keep_md = FALSE,
  readme = FALSE,
  compressed_css = TRUE,
  ...
)

Arguments

theme

Character string to specify the document theme. Currently supported themes are "cayman", "tactile", "architect", "leonids", and "hpstr".

highlight

Character string to specify the syntax highlight theme. Supported values are NULL (use Pandoc default), "github", and "vignette".

css

Additional CSS file to be merged in the document. It will NOT overwrite the CSS from the themes.

math

The engine to render math expressions. Possible values are "mathjax" and "katex". The katex engines supports offline (no internet connection) rendering of math expressions.

fig_retina

The same argument in html_document but with a different default value (NULL to disable retina scaling)

keep_md

Keep the markdown file generated by knitting. This is the same argument in html_vignette.

readme

Use this vignette as the package ‘README.md’ file. This is the same argument in html_vignette.

compressed_css

Whether the compressed CSS should be used.

...

Additional arguments passed to html_document.

Value

R Markdown output format to pass to render.

Author(s)

Yixuan Qiu <https://statr.me>

Examples

## Not run: 
doc = system.file("rmarkdown", "templates", "html_pretty_vignette",
                  "skeleton", "skeleton.Rmd", package = "prettydoc")
rmarkdown::render(doc, html_pretty(), output_dir = tempdir())

## End(Not run)