Skip to content

Commit

Permalink
update installation instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
jhelvy committed Dec 11, 2024
1 parent e63269c commit b0068f7
Show file tree
Hide file tree
Showing 3 changed files with 42 additions and 69 deletions.
26 changes: 8 additions & 18 deletions README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@ stable](https://lifecycle.r-lib.org/articles/figures/lifecycle-stable.svg)](http
This package contains functions for rendering [R Markdown][rmarkdown] and [Quarto][quarto] documents — priamrily [xaringan] or [revealjs] slides — to different formats, including HTML, PDF, PNG, GIF, PPTX, and MP4, as well as a 'social' output, a png of the first slide re-sized for sharing on social media.

**Looking for xaringanBuilder?**
The package formerly known as xaringanBuilder is now **renderthis**.
If you need to install xaringanBuilder under the previous package name,
The `renderthis` package was previously called `xaringanBuilder`. We updated the name as the package evolved (see [this blog post](https://www.jhelvy.com/blog/2022-06-28-introducing-renderthis/) detailing the package's history)
If you need to install `xaringanBuilder` under the previous package name,
[see the instructions below](#installing-xaringanbuilder).

## Installation
Expand All @@ -46,30 +46,20 @@ installation of Google Chrome. See the
[Setup](https://jhelvy.github.io/renderthis/articles/renderthis-setup.html)
page for details.

You can install the latest version of renderthis from
[CRAN](https://cran.r-project.org/) with:
Since `renderthis` is temporarily not on CRAN (we'll eventually get it back up), you can install it from GitHub with:

```{r}
install.packages("renderthis")
```

And the development version from GitHub with:

```{r}
# install.packages("remotes")
remotes::install_github("jhelvy/renderthis")
# install.packages("pak")
pak::pak("jhelvy/renderthis")
```

Some output formats require additional packages, and each format will provide
instructions about how to install any missing dependencies. You can also
choose to install renderthis with all of its dependencies:
choose to install `renderthis` with all of its dependencies:

```{r}
# From CRAN
install.packages("renderthis", dependencies = TRUE)
# From GitHub
remotes::install_github("jhelvy/renderthis", dependencies = TRUE)
pak::pak("jhelvy/renderthis", dependencies = TRUE)
```

## Usage
Expand Down Expand Up @@ -97,7 +87,7 @@ citation("renderthis")

## Installing xaringanBuilder

You can install the xaringanBuilder package as it was just prior to the name change with:
If you want, you can still install the `xaringanBuilder` package as it was just prior to the name change with:

```r
remotes::install_github("jhelvy/[email protected]")
Expand Down
65 changes: 29 additions & 36 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,12 @@ different formats, including HTML, PDF, PNG, GIF, PPTX, and MP4, as well
as a ‘social’ output, a png of the first slide re-sized for sharing on
social media.

**Looking for xaringanBuilder?** The package formerly known as
xaringanBuilder is now **renderthis**. If you need to install
xaringanBuilder under the previous package name, [see the instructions
**Looking for xaringanBuilder?** The `renderthis` package was previously
called `xaringanBuilder`. We updated the name as the package evolved
(see [this blog
post](https://www.jhelvy.com/blog/2022-06-28-introducing-renderthis/)
detailing the package’s history) If you need to install
`xaringanBuilder` under the previous package name, [see the instructions
below](#installing-xaringanbuilder).

## Installation
Expand All @@ -34,30 +37,21 @@ installation of Google Chrome. See the
[Setup](https://jhelvy.github.io/renderthis/articles/renderthis-setup.html)
page for details.

You can install the latest version of renderthis from
[CRAN](https://cran.r-project.org/) with:
Since `renderthis` is temporarily not on CRAN (we’ll eventually get it
back up), you can install it from GitHub with:

``` r
install.packages("renderthis")
```

And the development version from GitHub with:

``` r
# install.packages("remotes")
remotes::install_github("jhelvy/renderthis")
# install.packages("pak")
pak::pak("jhelvy/renderthis")
```

Some output formats require additional packages, and each format will
provide instructions about how to install any missing dependencies. You
can also choose to install renderthis with all of its dependencies:
can also choose to install `renderthis` with all of its dependencies:

``` r
# From CRAN
install.packages("renderthis", dependencies = TRUE)

# From GitHub
remotes::install_github("jhelvy/renderthis", dependencies = TRUE)
pak::pak("jhelvy/renderthis", dependencies = TRUE)
```

## Usage
Expand Down Expand Up @@ -89,28 +83,27 @@ library(renderthis)

All of the package functions follow a common pattern:

- All functions start with `to_*()` to render slides to a desired
format (e.g., `to_pdf()`).
- All functions have a required `from` argument which should be set to
the full or local path to the input file.
- All functions have an optional `to` argument. If provided, it can be
a full or local path to the output file, and it must end in an
appropriate extension (e.g. `slides.gif` for `to_gif()`). If it is
not provided, the output file name will be determined based on the
`from` argument.
- All functions start with `to_*()` to render slides to a desired format
(e.g., `to_pdf()`).
- All functions have a required `from` argument which should be set to
the full or local path to the input file.
- All functions have an optional `to` argument. If provided, it can be a
full or local path to the output file, and it must end in an
appropriate extension (e.g. `slides.gif` for `to_gif()`). If it is not
provided, the output file name will be determined based on the `from`
argument.

Learn more about renderthis in the [Get Started
article](https://jhelvy.github.io/renderthis/articles/renderthis.html).

## Author and License Information

- Authors: [John Paul Helveston](https://www.jhelvy.com/) (*aut*,
*cre*, *cph*) & [Garrick
Aden-Buie](https://www.garrickadenbuie.com/) (*aut*)
- Date First Written: Originally as {xaringanBuilder} on *September
27, 2020*
- License:
[MIT](https://github.com/jhelvy/renderthis/blob/master/LICENSE.md)
- Authors: [John Paul Helveston](https://www.jhelvy.com/) (*aut*, *cre*,
*cph*) & [Garrick Aden-Buie](https://www.garrickadenbuie.com/) (*aut*)
- Date First Written: Originally as {xaringanBuilder} on *September 27,
2020*
- License:
[MIT](https://github.com/jhelvy/renderthis/blob/master/LICENSE.md)

## Citation Information

Expand All @@ -132,8 +125,8 @@ author = {{Helveston} and John Paul and {Aden-Buie} and {Garrick}}, year

## Installing xaringanBuilder

You can install the xaringanBuilder package as it was just prior to the
name change with:
If you want, you can still install the `xaringanBuilder` package as it
was just prior to the name change with:

``` r
remotes::install_github("jhelvy/[email protected]")
Expand Down
20 changes: 5 additions & 15 deletions vignettes/renderthis-setup.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -21,30 +21,20 @@ of Chrome.

# Installation

You can install the latest version of renderthis from
[CRAN](https://cran.r-project.org/) with:
Since `renderthis` is temporarily not on CRAN (we'll eventually get it back up), you can install it from GitHub with:

```{r}
install.packages("renderthis")
```

And the development version from GitHub with:

```{r}
# install.packages("remotes")
remotes::install_github("jhelvy/renderthis")
# install.packages("pak")
pak::pak("jhelvy/renderthis")
```

Some output formats require additional packages, and each format will provide
instructions about how to install any missing dependencies. You can also
choose to install renderthis with all of its dependencies:
choose to install `renderthis` with all of its dependencies:

```{r}
# From CRAN
install.packages("renderthis", dependencies = TRUE)
# From GitHub
remotes::install_github("jhelvy/renderthis", dependencies = TRUE)
pak::pak("jhelvy/renderthis", dependencies = TRUE)
```

# Local Chrome Installation
Expand Down

0 comments on commit b0068f7

Please sign in to comment.