bookdown icon indicating copy to clipboard operation
bookdown copied to clipboard

update bookdown book Publishing section

Open jtbayly opened this issue 3 years ago • 6 comments

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.

jtbayly avatar Feb 06 '21 20:02 jtbayly

Thanks for opening the issue - Yes updating this chapter about deployment is on my TODO !

cderv avatar Feb 08 '21 08:02 cderv

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, ...)

cderv avatar Feb 10 '21 14:02 cderv

A good list here too: https://rstudio.github.io/distill/publish_website.html

apreshill avatar Feb 10 '21 15:02 apreshill

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.

shirdekel avatar Jul 28 '21 04:07 shirdekel

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/

cderv avatar Jul 28 '21 07:07 cderv

We should also remove travis section following security issue: https://twitter.com/peter_szilagyi/status/1437646118700175360

cderv avatar Sep 17 '21 16:09 cderv