ALSO ADD PLACEHOLDERS FOR ALL CHAPTERS BY COPYING 01.Rmd (IDEALLY ALSO UPDATE TITLES WITHIN THE FILES), THEN DELETE THIS SENTENCE.
Welcome to the DSLC Outstanding User Interfaces with Shiny Book Club!
We are working together to read Outstanding User Interfaces with Shiny by David Granjon (Chapman & Hall, copyright August 31, 2022, 9780367645267). Join the #book_club-shinyui channel on the DSLC Slack to participate. As we read, we are producing notes about the book.
If you would like to present, please see the sign-up sheet for your cohort (linked below, and pinned in the #book_club-shinyui channel on Slack)!
- Cohort 1 (started 2023-02-14, finished 2023-10-03): meeting videos
- Cohort 2 (started 2024-11-08): Fridays, 19:00 Central (America/Chicago) | meeting videos
This repository is structured as a {bookdown} site. To present, follow these instructions:
Do these steps once:
- Setup Git and GitHub to work with RStudio (click through for detailed, step-by-step instructions; I recommend checking this out even if you're pretty sure you're all set).
usethis::create_from_github("r4ds/bookclub-shinyui")
(cleanly creates your own copy of this repository).
Do these steps each time you present another chapter:
- Open your project for this book.
usethis::pr_init("my-chapter")
(creates a branch for your work, to avoid confusion, making sure that you have the latest changes from other contributors; replacemy-chapter
with a descriptive name, ideally).devtools::install_dev_deps()
(installs any packages used by the book that you don't already have installed).- Edit the appropriate chapter file, if necessary. Use
##
to indicate new slides (new sections). - If you use any packages that are not already in the
DESCRIPTION
, add them. You can useusethis::use_package("myCoolPackage")
to add them quickly! - Build the book! ctrl-shift-b (or command-shift-b) will render the full book, or ctrl-shift-k (command-shift-k) to render just your slide. Please do this to make sure it works before you push your changes up to the main repo!
- Commit your changes (either through the command line or using Rstudio's Git tab).
usethis::pr_push()
(pushes the changes up to github, and opens a "pull request" (PR) to let us know your work is ready).- (If we request changes, make them)
- When your PR has been accepted ("merged"),
usethis::pr_finish()
to close out your branch and prepare your local repository for future work. - Now that your local copy is up-to-date with the main repo, you need to update your remote fork. Run
gert::git_push("origin")
or click thePush
button on theGit
tab of Rstudio.
When your PR is checked into the main branch, the bookdown site will rebuild, adding your slides to this site.