-
Notifications
You must be signed in to change notification settings - Fork 0
/
publishing-to-web.qmd
56 lines (36 loc) · 3.45 KB
/
publishing-to-web.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
---
title: "Publishing to the Web"
editor: visual
---
We have many options for publishing html documents, html-based slides, websites, shiny apps, APIs, etc. to the web.
- **Posit Connect (previously 'RStudio Connect')**: UA has access to a Posit Connect server at viz.datascience.arizona.edu. This is an appropriate venue for publishing Shiny apps, Quarto or RMarkdown documents, datasets using the `pins` package, and `plumber` APIs [**for research purposes**](https://datascience.arizona.edu/analytics-powerhouse/posit-connect). Shiny for Python or Flask APIs can also be published to Posit Connect.
- **Quarto Pub**: Our group has a Quarto Pub account that allows publishing of Quarto documents to [cct-datascience.quarto.pub](https://cct-datascience.quarto.pub/). This is appropriate for slides and notes used for teaching workshops. Course websites can be published here also, but because of size and traffic limitations, GitHub pages might be a better choice.
- **GitHub pages**: We also have the ability to use GitHub pages for publishing content to the web. This is an appropriate venue for package documentation (e.g. `pkgdown` sites), project websites, and websites for short courses. This venue is also not limited to websites created via Quarto, RMarkdown, etc. so it is possibly an appropriate venue if there is a need for more flexible deployment.
## Posit Connect
### Getting Set Up:
You will have to be apply for access to be able to publish to viz.datascience.arizona.edu.
Request access [here](https://datascience.arizona.edu/analytics-powerhouse/rstudio-connect).
After you are approved, you can log in to viz.datascience.arizona.edu with your NetID and password.
To publish to Posit Connect using the RStudio GUI, follow instructions here: <https://docs.posit.co/connect/user/publishing/>
To publish Quarto documents to Posit Connect, follow these instructions: <https://quarto.org/docs/publishing/rstudio-connect.html>
Other useful links:
- [`pins` 📦 + Posit Connect](https://pins.rstudio.com/articles/posit-connect.html)
- [`plumber` 📦 + Posit Connect](https://www.rplumber.io/articles/hosting.html#rstudio-connect)
- [GitHub actions + Posit Connect](https://solutions.posit.co/operations/deploy-methods/ci-cd/github-actions/)
## Quarto Pub
[quartopub.com](https://quartopub.com/) is probably the easiest way to share Quarto documents.
This is only for Quarto documents, and there is no option to make what you share private in any way.
Because Posit Connect is *technically* for research only, this is an appropriate venue for slides or other teaching related documents made with Quarto
### Getting Set Up:
We have an account with the username cct-datascience\@arizona.edu.
The password is stored in [Stache](https://stache.arizona.edu/) (you may need to ask for it to be shared with you).
Published documents appear at <https://cct-datascience.quarto.pub/>.
Publish here with `quarto publish quarto-pub` and the first time you'll be prompted to authenticate.
Useful links:
- [Publishing to Quarto Pub](https://quarto.org/docs/publishing/quarto-pub.html)
- [GitHub actions + Quarto Pub](https://quarto.org/docs/publishing/quarto-pub.html#github-action)
## GitHub Pages
Official guide: <https://pages.github.com/>
Useful links:
- [`pkgdown` 📦 + GitHub actions](https://usethis.r-lib.org/reference/github_actions.html) to create a website for an R package
- [Publish Quarto docs and websites to GitHub Pages](https://quarto.org/docs/publishing/github-pages.html)