https://cderv.github.io/pandoc/
R package to install, manage and run Pandoc (https://pandoc.org/)
https://cderv.github.io/pandoc/
Last synced: 2 months ago
JSON representation
R package to install, manage and run Pandoc (https://pandoc.org/)
- Host: GitHub
- URL: https://cderv.github.io/pandoc/
- Owner: cderv
- License: other
- Created: 2021-06-30T12:54:25.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-02-29T11:17:27.000Z (over 1 year ago)
- Last Synced: 2025-04-22T19:03:37.841Z (2 months ago)
- Language: R
- Homepage: https://cderv.github.io/pandoc/
- Size: 8.38 MB
- Stars: 27
- Watchers: 5
- Forks: 2
- Open Issues: 12
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-r-pkgtools - `{pandoc}`
README
---
output: github_document
editor_options:
markdown:
wrap: 72
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# pandoc
[](https://lifecycle.r-lib.org/articles/stages.html#experimental)
[](https://github.com/cderv/pandoc)
[](https://github.com/cderv/pandoc/actions/workflows/R-CMD-check.yaml)
[](https://app.codecov.io/gh/cderv/pandoc?branch=main)
```{r child = "vignettes/articles/_about.Rmd"}
```
## Usage
All functions are prefixed with `pandoc_` and you will find below their
main usage. See [Get
started](https://cderv.github.io/pandoc/articles/pandoc.html) for usage
examples and
[Reference](https://cderv.github.io/pandoc/reference/index.html) page
for full details of functions.
Most functions follows these following rules:
- They are prefixed with `pandoc_` .
- They can be used with any installed Pandoc version using `version`
argument.
- Versions to use are passed as a string, either the version number
(e.g `"2.14.2"` ), or one special alias (`default`, `nightly` ,
`rstudio` , `system`) .
Available functions allows:
- Installing / Uninstalling specific Pandoc version from
`r knitr::combine_words(range(as.numeric_version(pandoc::pandoc_available_releases())), sep = ", ", and = " to ", before = "'")`
, including development version of Pandoc.
- `pandoc_install()`, `pandoc_install_nightly()`,
`pandoc_uninstall()`, ...
- Switching Pandoc version by activating a specific one or running any
function with a specific Pandoc version using `version=` argument.
- `pandoc_activate()` , `with_pandoc()` , ....
- Managing locally installed version of Pandoc as versions installed
by this package are located within one folder per version in a
user's data directory.
- `pandoc_installed_versions()` , `pandoc_installed_latest` ,
`pandoc::pandoc_is_installed()` , `pandoc_locate()`,
`pandoc_available()`, ...
- Using easily one of the installed version with **rmarkdown** (i.e
`rmarkdown::render()` will use the version activated by this pandoc)
- See `pandoc::pandoc_activate(rmarkdown = TRUE)`
- Running a Pandoc binary from R, including a version installed
system-wise (`pandoc_bin("system")`), or the version shipped with
RStudio (`pandoc_bin("rstudio")`).
- Calling binary at low-level from R with any version installed.
- `pandoc_run()`
- to easily access information in R usually requiring command line
execution
- `pandoc_version()`, `pandoc_list_extensions()` ,
`pandoc_export_template()` , and all other wrappers...
- opening Pandoc's resources from R
- `pandoc::pandoc_browse_manual()`,
`pandoc::pandoc_browse_extension()` , ....
## Example
```{r}
library(pandoc)
# Install version
pandoc_install("2.7.3")
pandoc_install("2.11.4")
# Highest install is used
pandoc_version()
```
See detailed examples in [Get
started](https://cderv.github.io/pandoc/articles/pandoc.html).
## Code of Conduct
Please note that the **pandoc** project is released with a [Contributor
Code of Conduct](https://cderv.github.io/pandoc/CODE_OF_CONDUCT.html).
By contributing to this project, you agree to abide by its terms.