Skip to content
/ rmdfiltr Public

R package that provides a collection of Lua filters that extend the functionality of R Markdown templates.

License

Notifications You must be signed in to change notification settings

crsh/rmdfiltr

Repository files navigation

rmdfiltr

Lifecycle: experimental Travis build status CRAN status CRAN downloads

rmdfiltr provides a collection of Lua-filters that extend the functionality of R Markdown templates.

Installation

You can install the development version from this GitHub repository with:

# install.packages("remotes")
remotes::install_github("crsh/rmdfiltr")

Example

You can add a filter to any R Markdown template that accepts additional pandoc arguments.

---
title: "Word count test"
output:
  html_document:
    pandoc_args: !expr rmdfiltr::add_wordcount_filter()
---

Of course, you can also use the filters in a custom R Markdown format by adding pandoc arguments with the pre-processor function.

wordcount_html_document = function(...) {
  format <- rmarkdown::html_document(...)
  format$pre_processor <- rmdfiltr::add_wordcount_filter
  format
}

See R Markdown: The Definitive Guide for details on how to create custom formats.

Filters

rmdfiltr currently provides the following filters:

  • wordcount: Prints the word count for the body of the document and for the reference section to the console.
  • charcount: Prints the character count for the body of the document to the console.
  • replace_ampersands: Replaces all ampersands in in-text citation with and (or the equivalent in other languages).
  • doi2cite: Generates .bib file from the DOIs in a document and convert the DOIs into BibTeX citation keys.

Contributions

Contributions of new filters are welcome. Pleas refer to the contributing guidelines before you start working or open a pull request. Also, please note that the rmdfiltr project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

About

R package that provides a collection of Lua filters that extend the functionality of R Markdown templates.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published