• Preface
    • Why rstudio4edu?
    • Philosophy
    • Who are you?
    • What is in this handbook?
    • What did we leave out?
    • Who are we?
    • Contributing
  • Four basic ingredients
  • 1 Infrastructure
    • 1.1 R
    • 1.2 RStudio
      • 1.2.1 The RStudio IDE
      • 1.2.2 RStudio Projects
      • 1.2.3 RStudio.cloud
      • 1.2.4 Pro Products
    • 1.3 GitHub
      • 1.3.1 GitHub for you
      • 1.3.2 GitHub for them
    • 1.4 Communication platform
  • 2 Data
    • 2.1 Data from R packages
    • 2.2 Data stored on GitHub
    • 2.3 Data from other sources
  • 3 Lessons
    • 3.1 A very brief history
    • 3.2 A very brief pep-talk
    • 3.3 Literate lesson-making
    • 3.4 Make it work
      • 3.4.1 Make it work for you
      • 3.4.2 Make it work for them
    • 3.5 Literate lesson-delivery
    • 3.6 Literate lesson-sharing
    • 3.7 Sample Rmds
    • 3.8 Sharing
      • 3.8.1 Share source code
      • 3.8.2 Share readable output
    • 3.9 Lesson delivery & sharing
      • 3.9.1 Live coding
      • 3.9.2 Screencast
      • 3.9.3 Online tutorials
      • 3.9.4 Remote workshops & webinars
  • 4 Organization
    • Introduction
    • 4.1 For Courses
    • 4.2 For Workshops
    • 4.3 For Online Tutorials
    • 4.4 Types of R Markdown collections
    • 4.5 Choose your collections wisely
    • 4.6 Meta
    • 4.7 Showtime
  • Education cookbooks
  • How to use the cookbooks
  • I Cookbook: R Markdown Lessons
  • Introduction
    • What are we making?
  • 5 Make a document
    • 5.1 Getting set up
      • 5.1.1 Update packages
      • 5.1.2 Make a project
      • 5.1.3 Get to know Markdown
    • 5.2 Make a document
    • 5.3 A mini-orientation
    • 5.4 Push to GitHub
    • 5.5 Knit to HTML
    • 5.6 Push to GitHub (again)
    • 5.7 Make a living, breathing document!
    • 5.8 Uplevel your workflow
  • 6 Make it yours
    • 6.1 Add code
    • 6.2 Embrace Markdown
    • 6.3 Add structure with headers
    • 6.4 Add narrative
    • 6.5 Add space
  • 7 Caring for your document
    • 7.1 Live editing
    • 7.2 Care for your code
      • 7.2.1 Use keyboard shortcuts
      • 7.2.2 Add a setup code chunk
      • 7.2.3 Name your code chunks
      • 7.2.4 Print pretty packages
    • 7.3 Care for your self
      • 7.3.1 Use portable file paths
      • 7.3.2 Name your files nicely
      • 7.3.3 Add notes to self
  • 8 Design a how-to
    • 8.1 Share the source code
    • 8.2 Show the data
    • 8.3 Share the data
    • 8.4 Code Folding
    • 8.5 Show code, hide results
    • 8.6 Show code, hide plots
    • 8.7 Show results, hide code
    • 8.8 Interactively hide/show code
    • 8.9 Hide everything
    • 8.10 Reuse your code
    • 8.11 Two plots side-by-side
    • 8.12 Include verbatim code chunks
  • 9 Dress it up!
    • 9.1 Use a bootswatch theme
    • 9.2 Add a floating table of contents
    • 9.3 Customize code highlighter
    • 9.4 Add images
      • 9.4.1 Markdown images
      • 9.4.2 Use knitr::include_graphics()
    • 9.5
    • 9.6 Upgrade your output format
      • 9.6.1 bookdown::html_document2
      • 9.6.2 distill::distill_article
      • 9.6.3 tufte::tufte_html
      • 9.6.4 learnr::tutorial
  • 10 Make it fancier
    • 10.1 Extra packages
    • 10.2 Use bootswatch CSS
    • 10.3 include or not?
    • 10.4 Before you begin
    • 10.5 Include a css file
    • 10.6 Branding and aesthetics
      • 10.6.1 Google Fonts
      • 10.6.2 Links
      • 10.6.3 Add a logo
      • 10.6.4 White Space
    • 10.7 Table of contents (TOC)
    • 10.8 Questions counter
  • 11 Trouble-shooting
  • II Cookbook: Packages etc.
  • Introduction
  • 12 Create a data package
    • 12.1 Is this tutorial for you?
    • 12.2 Mental Framework
    • 12.3 Part 1: Getting set up
      • 12.3.1 Packages
      • 12.3.2 Two getting-started workflows
    • 12.4 Part 2: Add some clean data
      • 12.4.1 With built-in data
      • 12.4.2 Start with your OWN Data
    • 12.5 Part 3: Check!
    • 12.6 Part 4: Document the datasets
    • 12.7 Part 5: Document the package
    • 12.8 Part 6: Build and Install!
    • 12.9 Part 7: Deliver
    • 12.10 Caring for your package
      • 12.10.1 A review
      • 12.10.2 Package accessories
    • 12.11 tldr;
  • 13 Create R Markdown templates
    • 13.1 Why do this?
    • 13.2 Step 1: Create files and folders
    • 13.3 Step 2: Create your template
    • 13.4 Step 3: Confirm that your template is accessible
  • 14 Create RStudio project templates
    • 14.1 Why do this?
  • 15 Add interactive tutorials
    • 15.1 PART 1: Including a LearnR tutorial
      • 15.1.1 Why do this?
      • 15.1.2 Step 1: Create files and directories
      • 15.1.3 Step 2: Customize your tutorial
      • 15.1.4 Step 3: Add additional subdirectory
      • 15.1.5 Step 4: Run your tutorial
    • 15.2 PART 5: FINAL STEPS
      • 15.2.1 (Optionally) Document the package as a whole
      • 15.2.2 Create a README.Rmd file
    • 15.3 Troubleshooting
    • 15.4 Miscellaneous / Nice to Know
    • 15.5 Other community resources on package-making:
  • III Cookbook: R Markdown sites
  • Introduction
    • What are we making?
    • Pros and cons of using Rmd sites
    • Is this cookbook for you?
    • Other learning resources
  • 16 Make a site
    • 16.1 tl;dr
    • 16.2 Getting set up
      • 16.2.1 Update packages
      • 16.2.2 Make a project
      • 16.2.3 Make a site skeleton
    • 16.3 A mini-orientation
    • 16.4 Push to GitHub
    • 16.5 Change output directory
    • 16.6 Turn off Jekyll
    • 16.7 Build your site
    • 16.8 Push to GitHub (again)
    • 16.9 Make a living, breathing site!
    • 16.10 Uplevel your workflow
  • 17 Make it yours
    • 17.1 Adding new pages
    • 17.2 Grow your navbar
    • 17.3 Add a dropdown menu
    • 17.4 Add your content
    • 17.5 Recap
  • 18 Caring for your site
    • 18.1 Hiding pages
    • 18.2 Staying organized
    • 18.3 Troubleshooting
  • 19 Dress it up!
    • 19.1 Before you begin
    • 19.2 One YAML to rule them all
    • 19.3 Applying what you can from a single lesson
    • 19.4 Add a site theme
    • 19.5 Customize code highlighting
    • 19.6 Change the navbar color
    • 19.7 Add navbar icons
    • 19.8 Tidy up the dropdown menu
    • 19.9 Recap
  • 20 Make it fancier
    • 20.1 Before you begin
    • 20.2 Anatomy of a fancy R Markdown page
    • 20.3 Adding custom CSS to your site
    • 20.4 Aesthetics and branding
      • 20.4.1 Google fonts
      • 20.4.2 Customize your links
      • 20.4.3 White space
      • 20.4.4 Logo
      • 20.4.5 Add a logo
      • 20.4.6 Add a favicon
      • 20.4.7 Add a hero image
    • 20.5 Table of contents
    • 20.6 Navigation bar styling
    • 20.7 Questions counter
    • 20.8 Add multiple CSS files
    • 20.9 Recap
  • IV Cookbook: Distill sites
  • Introduction
    • What are we making?
    • Distill vs R Markdown site
    • Is this tutorial for you?
    • Other learning resources
      • 20.9.1 Existing Distill sites
  • 21 Make a Distill site
    • 21.1 tl;dr
    • 21.2 Getting set up
      • 21.2.1 Packages
      • 21.2.2 Make a project
      • 21.2.3 Make a Distill site skeleton
    • 21.3 A mini-orientation
    • 21.4 Push to GitHub
    • 21.5 Build your site
    • 21.6 Push to GitHub (again)
    • 21.7 Make a living, breathing site!
    • 21.8 Uplevel your workflow
  • 22 Make it yours
    • 22.1 Adding new Distill articles
    • 22.2 Grow your navbar
  • 23 Caring for your Distill site
    • 23.1 Hiding pages
      • 23.1.1 Switching from an existing R Markdown site to a Distill site
    • 23.2 Alternatives and drawbacks
    • 23.3 Using your Distill site
    • 23.4 Distill features
      • 23.4.1 Authors and affiliations
      • 23.4.2 Citations
      • 23.4.3 Hoverable footnotes
      • 23.4.4 Asides
      • 23.4.5 Figure width
      • 23.4.6 Figure captions and cross-references
      • 23.4.7 If you like Distill…
  • 24 Dress it up!
    • 24.1 Site sections
      • 24.1.1 Site footer
      • 24.1.2 Appendix
    • 24.2 Sharing
      • 24.2.1 Reuse and licencing
      • 24.2.2 Preview images
      • 24.2.3 Logo
      • 24.2.4 Favicon
      • 24.2.5 Google analytics
      • 24.2.6 Getting edits
  • 25 Make it fancier
    • 25.1 Before you begin
    • 25.2 Anatomy of a fancy Distill page
    • 25.3 Adding custom CSS to your site
    • 25.4 Aesthetics and branding
      • 25.4.1 Google Fonts
      • 25.4.2 Larger logo
    • 25.5 Navbar
      • 25.5.1 More space for the navbar
      • 25.5.2 Navbar font and text style
      • 25.5.3 Transparent, faded navbar
      • 25.5.4 Animated hovering
      • 25.5.5 Tweak for mobile
    • 25.6 Appendix
    • 25.7 Footer
      • 25.7.1 Links
  • V Cookbook: Bookdown book
  • Introduction
    • What are we making?
    • Pros and cons of using bookdown sites
    • Is this cookbook for you?
    • Learning resources
  • 26 Make a book
    • 26.1 tl;dr
    • 26.2 Getting set up
      • 26.2.1 Packages needed
      • 26.2.2 Make a project
      • 26.2.3 Make a book skeleton
    • 26.3 A mini-orientation
    • 26.4 Push to GitHub
    • 26.5 Change output directory
    • 26.6 Turn off Jekyll
    • 26.7 Build your book
    • 26.8 Push to GitHub (again)
    • 26.9 Make a living, breathing site!
    • 26.10 Uplevel your workflow
  • 27 Make it yours
    • 27.1 Creating new chapters
    • 27.2 Putting your chapters in order
  • 28 Caring for your book
    • 28.1 Workflow for maintenance
    • 28.2 Rendering
    • 28.3 Using your book
      • 28.3.1 Components
      • 28.3.2 Search
    • 28.4 Hiding Chapters
    • 28.5 Staying organized
  • 29 Dress it up!
    • 29.1 Before you begin
    • 29.2 Organizing
      • 29.2.1 Collapse TOC by (sub)sections
      • 29.2.2 Change the chapter name
      • 29.2.3 Section (un)numbering
      • 29.2.4 Group chapters into parts
      • 29.2.5 Appendix
    • 29.3 Aesthetics
      • 29.3.1 Header and footer of the TOC
    • 29.4 Edits and source code
      • 29.4.1 Share the source code
    • 29.5 Polishing and sharing
      • 29.5.1 Twitter and GitHub
      • 29.5.2 Add a favicon
      • 29.5.3 Book cover and description
  • 30 Make it fancier
    • 30.1 Before you begin
    • 30.2 Anatomy of a fancy book
    • 30.3 Aesthetics and branding
      • 30.3.1 Align the toolbar line
      • 30.3.2 Symmetrical code chunks
      • 30.3.3 Google fonts
      • 30.3.4 Add a logo
      • 30.3.5 Custom link colors
      • 30.3.6 Add a hero image
    • 30.4 Usability
      • 30.4.1 Custom div tips
      • 30.4.2 Anchor links
      • 30.4.3 Copy to clipboard
    • 30.5 Table of Contents
      • 30.5.1 Change TOC background color
      • 30.5.2 Style the TOC links
      • 30.5.3 Hierarchy styling
  • VI Cookbook: Blogdown sites
  • Introduction
  • 31 Make a site
  • 32 Make a site for a workshop
  • 33 Make a site for a course
  • 34 Make it fancier
  • Appendix
  • A CSS Crash Course
    • A.1 What’s in a name?
    • A.2 How do I change the color of….?
  • B Backlog
  • C Miscellaneous
  • D Spillover from distill
  • E Teaching and Learning with Jupyter Book Review
  • F R Markdown Themes
    • F.0.1 default
    • F.0.2 cerulean
    • F.0.3 journal
    • F.0.4 flatly
    • F.0.5 darkly
    • F.0.6 readable
    • F.0.7 spacelab
    • F.0.8 united
    • F.0.9 cosmo
    • F.0.10 lumen
    • F.0.11 paper
    • F.0.12 sandstone
    • F.0.13 simplex
    • F.0.14 yeti
  • G What should I make
  • H Teaching learners
  • I What to do on day 1
  • J Licensing your content
  • K Remixing licensed content
  • L Community
  • Published with bookdown

rstudio4edu

L Community

https://community.rstudio.com/c/teaching


All illustrations CC-BY-NC : You can download them by clicking here
All other materials CC-BY unless noted otherwise.