Skip to content

Commit 68d1662

Browse files
committed
Update description of the repository and rename the action
1 parent 634dd12 commit 68d1662

File tree

3 files changed

+31
-30
lines changed

3 files changed

+31
-30
lines changed

README.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,39 @@
11

2-
# Unified GH Action for {pkgdown} and R WASM Package Binaries
2+
# Unified GH Action for webR/R WASM Package Binaries and {pkgdown} Deployment
33

44
<!-- badges: start -->
55

66
[![R-CMD-check](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/actions/workflows/R-CMD-check.yaml)
77
[![webr-build-binary](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/actions/workflows/deploy-cran-repo.yml/badge.svg)](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/actions/workflows/deploy-cran-repo.yml)
88
<!-- badges: end -->
99

10-
Example GitHub Action workflow to generate developmental webR/R WASM
11-
Package binaries
10+
Example GitHub Action workflow combining creation of developmental
11+
webR/R WASM Package binaries and `{pkgdown}` websites.
1212

1313
# Overview
1414

1515
Interested in having your R package automatically be built for
1616
[webR](https://docs.r-wasm.org/webr/latest/) through a [GitHub
17-
Action](https://github.com/features/actions)? If so, this is the
18-
repository for you! Here’s a summary of what you can find in the
19-
repository:
17+
Action](https://github.com/features/actions) alongside of a pkgdown
18+
website? If so, this is the repository for you! Here’s a summary of what
19+
you can find in the repository:
2020

21-
- [`.github/workflows/deploy-cran-repo.yml`](.github/workflows/deploy-cran-repo.yml):
21+
- [`.github/workflows/webr-pkgdown-build-and-deploy.yml`](.github/workflows/webr-pkgdown-build-and-deploy.yml):
2222
Modified version of [`r-wasm/actions`
2323
deploy-cran-repo.yml](https://github.com/r-wasm/actions/blob/d21bf7da50e539df543bbee973087ec585deaba6/examples/deploy-cran-repo.yml)
2424
- [`DESCRIPTION`](DESCRIPTION): Standard description information for an
2525
R package
2626
- [`R/in-webr.R`](R/in-webr.R): Check to see if we’re inside of webR or
2727
not.
2828

29-
You can view the pushed webR package binary parts by looking at the
30-
[`gh-pages`](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/tree/gh-pages)
31-
branch of the repository. Specifically, we can see binary package data
32-
[`bin/emscripten/contrib/4.3`](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/tree/gh-pages/bin/emscripten/contrib/4.3)
33-
and the package information in
34-
[`src/contrib`](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/tree/gh-pages/src/contrib).
35-
You can read more about package repositories that are CRAN-like in the
36-
[R Administration: 6.6 Setting up a package
37-
repository](https://cran.r-project.org/doc/manuals/r-release/R-admin.html#Setting-up-a-package-repository).
29+
## Deployment
30+
31+
This approach moves away from tracking website deployments in a
32+
`gh-pages` to generating artifacts with GitHub Actions and, then,
33+
deploying them onto GitHub Pages. As a result, the size of the
34+
repository should not grow large with the addition of a webR/R WASM
35+
Package binary. Though, this means that changes associated with new
36+
`{pkgdown}` deployments are no longer tracked in the `gh-pages` branch.
3837

3938
## Setup
4039

@@ -50,7 +49,7 @@ usethis::use_github_pages()
5049

5150
# Obtain the modified version of the rwasm repo setup
5251
usethis::use_github_action(
53-
"https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/blob/main/.github/workflows/deploy-cran-repo.yml"
52+
"https://github.com/coatless-tutorials/webr-unified-gh-workflow/blob/main/.github/workflows/webr-pkgdown-build-and-deploy.yml"
5453
)
5554
```
5655

@@ -118,7 +117,7 @@ v0.2.2) and run the following:
118117
# Install the binary from a repository
119118
webr::install(
120119
"demorwasmbinary",
121-
repos = "https://tutorials.thecoatlessprofessor.com/webr-github-action-wasm-binaries/"
120+
repos = "https://tutorials.thecoatlessprofessor.com/webr-unified-gh-workflow/"
122121
)
123122
# Check to see if the function works
124123
demorwasmbinary::in_webr()

README.qmd

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,33 +3,35 @@ format: gfm
33
engine: knitr
44
---
55

6-
# Unified GH Action for {pkgdown} and R WASM Package Binaries
6+
# Unified GH Action for webR/R WASM Package Binaries and {pkgdown} Deployment
77

88
<!-- badges: start -->
99
[![R-CMD-check](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/actions/workflows/R-CMD-check.yaml)
1010
[![webr-build-binary](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/actions/workflows/deploy-cran-repo.yml/badge.svg)](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/actions/workflows/deploy-cran-repo.yml)
1111
<!-- badges: end -->
1212

13-
Example GitHub Action workflow to generate developmental webR/R WASM Package binaries
13+
Example GitHub Action workflow combining creation of developmental webR/R WASM Package binaries and `{pkgdown}` websites.
1414

1515
# Overview
1616

1717
Interested in having your R package automatically be built for [webR](https://docs.r-wasm.org/webr/latest/) through
18-
a [GitHub Action](https://github.com/features/actions)?
18+
a [GitHub Action](https://github.com/features/actions) alongside of a pkgdown website?
1919
If so, this is the repository for you! Here's a summary of what you can find in the repository:
2020

21-
- [`.github/workflows/deploy-cran-repo.yml`](.github/workflows/deploy-cran-repo.yml):
21+
- [`.github/workflows/webr-pkgdown-build-and-deploy.yml`](.github/workflows/webr-pkgdown-build-and-deploy.yml):
2222
Modified version of [`r-wasm/actions`' deploy-cran-repo.yml](https://github.com/r-wasm/actions/blob/d21bf7da50e539df543bbee973087ec585deaba6/examples/deploy-cran-repo.yml)
2323
- [`DESCRIPTION`](DESCRIPTION):
2424
Standard description information for an R package
2525
- [`R/in-webr.R`](R/in-webr.R): Check to see if we're inside of webR or not.
2626

27-
You can view the pushed webR package binary parts by looking at the
28-
[`gh-pages`](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/tree/gh-pages)
29-
branch of the repository. Specifically, we can see binary package data [`bin/emscripten/contrib/4.3`](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/tree/gh-pages/bin/emscripten/contrib/4.3)
30-
and the package information in
31-
[`src/contrib`](https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/tree/gh-pages/src/contrib). You can read more about package repositories that
32-
are CRAN-like in the [R Administration: 6.6 Setting up a package repository](https://cran.r-project.org/doc/manuals/r-release/R-admin.html#Setting-up-a-package-repository).
27+
## Deployment
28+
29+
This approach moves away from tracking website deployments in a `gh-pages` to
30+
generating artifacts with GitHub Actions and, then, deploying them onto
31+
GitHub Pages. As a result, the size of the repository should not grow large with
32+
the addition of a webR/R WASM Package binary. Though, this means that changes
33+
associated with new `{pkgdown}` deployments are no longer tracked in the
34+
`gh-pages` branch.
3335

3436
## Setup
3537

@@ -45,7 +47,7 @@ usethis::use_github_pages()
4547

4648
# Obtain the modified version of the rwasm repo setup
4749
usethis::use_github_action(
48-
"https://github.com/coatless-tutorials/webr-github-action-wasm-binaries/blob/main/.github/workflows/deploy-cran-repo.yml"
50+
"https://github.com/coatless-tutorials/webr-unified-gh-workflow/blob/main/.github/workflows/webr-pkgdown-build-and-deploy.yml"
4951
)
5052
```
5153

@@ -110,7 +112,7 @@ and run the following:
110112
# Install the binary from a repository
111113
webr::install(
112114
"demorwasmbinary",
113-
repos = "https://tutorials.thecoatlessprofessor.com/webr-github-action-wasm-binaries/"
115+
repos = "https://tutorials.thecoatlessprofessor.com/webr-unified-gh-workflow/"
114116
)
115117
# Check to see if the function works
116118
demorwasmbinary::in_webr()

0 commit comments

Comments
 (0)