Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/yonicd/texpreview

Efficiently iterate, refine and share snippets of LaTeX in R with ease
https://github.com/yonicd/texpreview

imagemagick latex r rmarkdown

Last synced: 12 days ago
JSON representation

Efficiently iterate, refine and share snippets of LaTeX in R with ease

Awesome Lists containing this project

README

        

[![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/texPreview)](https://cran.r-project.org/package=texPreview)
[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/0.1.0/active.svg)](https://www.repostatus.org)
[![](https://cranlogs.r-pkg.org/badges/texPreview)](https://cran.r-project.org/package=texPreview)
[![Coverage Status](https://img.shields.io/codecov/c/github/yonicd/texPreview/master.svg)](https://app.codecov.io/github/yonicd/texPreview?branch=master)
[![Covrpage Summary](https://img.shields.io/badge/covrpage-Last_Build_2024_01_23-yellowgreen.svg)](https://github.com/yonicd/texPreview/blob/master/tests/README.md)
[![R-win build
status](https://github.com/yonicd/texPreview/workflows/R-win/badge.svg)](https://github.com/yonicd/texPreview)
[![R-mac build
status](https://github.com/yonicd/texPreview/workflows/R-mac/badge.svg)](https://github.com/yonicd/texPreview)
[![R-linux build
status](https://github.com/yonicd/texPreview/workflows/R-linux/badge.svg)](https://github.com/yonicd/texPreview)

# texPreview

Efficiently iterate, refine and share snippets of LaTeX in R with ease.

`texPreview` compiles LaTeX directly into images from the R console to view in the RStudio viewer pane, Shiny apps and RMarkdown documents.

## Functionality

- __Supports__: character, knitr, kableExtra, xtable, texreg, equatiomatic classes

- __Extendable__: `S3` methods can be written for the main call, `texPreview::tex_preview`, to use with new classes for rendering and printing.

- __Rstudio Addin__: Users can highlight text in the editor and invoke preview automatically.

- __RMarkdown__ document compatible with all document outputs

- __Shiny__ compatible via `shiny::renderImage` or as part of htmlwidgets like `slickR::slickR`.

- __Pan and Zoom functionality__: When the output is set to 'svg' the default output to the viewer is `svgPanZoom::svgPanZoom`, which allows for panning and zooming on the image in the viewer. If the package is not installed a static image will be loaded.

- __System Requirements__:
- Must have pdflatex in PATH, Windows users can install by running [installr::install.MikTeX](http://talgalili.github.io/installr/reference/install.MikTeX.html)
- TeX libraries that are used: `standalone`, `xcolor`, `booktabs`, `multirow`, `array`, `helvet`, `amsmath`, `rotating`, `listings`, `graphicx`, `setspace`, `caption`
- Using [tinytex](https://github.com/rstudio/tinytex) you can run

```
install.packages('tinytex')
tinytex::tlmgr_install(c('standalone', 'xcolor', 'booktabs', 'multirow', 'amsmath',
'listings', 'setspace', 'caption', 'graphics', 'tools', 'psnfss', 'varwidth',
'colortbl', 'epstopdf-pkg', 'pgf','makeindex'))
```
- To Check if the system is in compliance with these libraries run `texPreview::check_requirements()`.
- Ghostscript: If you are installing TeX with [tinytex](https://github.com/rstudio/tinytex) make sure to install ghostscript onto your system.

## Examples

### Basic

![](https://github.com/yonicd/texPreview/blob/misc/Multimedia/texPreview.gif?raw=true)

### Pan/Zoom

![](https://github.com/yonicd/texPreview/blob/misc/Multimedia/texPreviewPanZoom.gif?raw=true)