bookdown
bookdown copied to clipboard
update bookdown book Publishing section
This page in the book could be updated with how to use Github Actions for CI.
By filing an issue to this repo, I promise that
- [x] I have fully read the issue guide at https://yihui.org/issue/.
- [x] I have provided the necessary information about my issue.
- If I'm asking a question, I have already asked it on Stack Overflow or RStudio Community, waited for at least 24 hours, and included a link to my question there.
- If I'm filing a bug report, I have included a minimal, self-contained, and reproducible example, and have also included
xfun::session_info('bookdown')
. I have upgraded all my packages to their latest versions (e.g., R, RStudio, and R packages), and also tried the development version:remotes::install_github('rstudio/bookdown')
. - If I have posted the same issue elsewhere, I have also mentioned it in this issue.
- [x] I have learned the Github Markdown syntax, and formatted my issue correctly.
I understand that my issue may be closed if I don't fulfill my promises.
Thanks for opening the issue - Yes updating this chapter about deployment is on my TODO !
We could mentioned :
- Host platform
- Github Pages
- Gitlab Pages (#795: with two examples https://gitlab.com/dashohoxha/bookdown-example, https://www.researchgate.net/publication/336983801_How_to_Publish_a_Book_With_Bookdown by @dashohoxha)
- Netlify, digitalocean, ...
- RStudio connect
- Deployment method:
- Manual (
rsconnect
package, drag and drop) - Automatic (GHA, Github App, ...)
- Manual (
A good list here too: https://rstudio.github.io/distill/publish_website.html
Is there a plan on including something about Netlify? I see that a discussion was startied on RStudio community but I can't find much else.
Edit: I now see this was already mentioned, so disregard.
That is always good to have reminder and showing that this is of interest. We'll try to make time to add a section on Netlify publication. I don't think there is anything specific to bookdown but it would surely help to have setup instruction in the book.
In the meantime, here are the resources we know about and would surely mentioned in the book
- Github Action + Netlify: https://www.emilhvitfeldt.com/post/bookdown-netlify-github-actions/
- Sharing on Short notice webinar: https://education.rstudio.com/blog/2020/04/sharing-on-short-notice/#questions-about-bookdown and https://www.rstudio.com/resources/webinars/sharing-on-short-notice-how-to-get-your-materials-online-with-r-markdown/
We should also remove travis section following security issue: https://twitter.com/peter_szilagyi/status/1437646118700175360