Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jasdumas/gramr
RStudio Addin, function, & shiny app for the write-good linter :pencil:
https://github.com/jasdumas/gramr
r r-package rstats unconf unconf17
Last synced: about 1 month ago
JSON representation
RStudio Addin, function, & shiny app for the write-good linter :pencil:
- Host: GitHub
- URL: https://github.com/jasdumas/gramr
- Owner: jasdumas
- License: other
- Created: 2017-05-25T19:02:19.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-11-14T20:56:21.000Z (about 5 years ago)
- Last Synced: 2024-08-02T06:02:28.047Z (4 months ago)
- Topics: r, r-package, rstats, unconf, unconf17
- Language: JavaScript
- Homepage: https://docs.ropensci.org/gramr
- Size: 433 KB
- Stars: 128
- Watchers: 10
- Forks: 13
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - jasdumas/gramr - RStudio Addin, function, & shiny app for the write-good linter :pencil: (JavaScript)
README
# gramr
[![Travis-CI Build Status](https://travis-ci.org/ropenscilabs/gramr.svg?branch=master)](https://travis-ci.org/ropenscilabs/gramr.svg?branch=master)
[![Coverage Status](https://img.shields.io/codecov/c/github/ropenscilabs/gramr/master.svg)](https://codecov.io/github/ropenscilabs/gramr?branch=master)
[![Last-changedate](https://img.shields.io/badge/last%20change-2017--05--19-brightgreen.svg)](https://github.com/ropenscilabs/gramr/commits/master) [![minimal R version](https://img.shields.io/badge/R%3E%3D-3.4.0-brightgreen.svg)](https://cran.r-project.org/) [![Licence](https://img.shields.io/github/license/mashape/apistatus.svg)](http://choosealicense.com/licenses/mit/)**The goal of gramr is to help R programmers who can't write good and and wanna learn to do other stuff good too by checking a RMarkdown document for grammatical errors.**
This package wraps the command line tool, [`write-good`](https://github.com/btford/write-good) to provide grammar checking functions for Rmd or md documents. It can be used as an [RStudio Addin](https://rstudio.github.io/rstudioaddins/), or from the console or command line by supplying an Rmd or md filename.
![](https://media.giphy.com/media/OCMGLUo7d5jJ6/giphy.gif)
## Installation
You can install `gramr` from github with:
```R
# install.packages("devtools")
devtools::install_github("ropenscilabs/gramr")
```## Examples
`write_good_ip()`: run the write-good linter on text in a currently active Rmd file in RStudio
`write_good_file("my_file.Rmd")`: run the write-good linter on text in an Rmd file (RStudio not required)
`run_grammar_checker("example.rmd")`: run the write-good linter interactively
![](shiny-wg.jpg)
**Example Output**:
```r
> write_good_file("tests/testthat/test.Rmd")# index offset reason
#1 15 12 "been defined" may be passive voice
#2 49 8 "suddenly" can weaken meaning
```## Contributing
Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.
## Acknowledgements
Thanks to [Brian Ford](https://github.com/btford) for the development of [write-good](https://github.com/btford/write-good)!