bookdown

Authoring Books and Technical Documents with R Markdown

rstudio/bookdown

pkgs.rstudio.com/bookdown

4020 stars

1279 forks

GPL-3.0

JavaScript

bookdown is an R package for authoring books and long-form technical documents using R Markdown. It converts R Markdown source files into multiple output formats including PDF, HTML, EPUB, and Word.

The package simplifies technical writing by providing easier markup than LaTeX while supporting advanced features like mathematical equations, theorems, and cross-references across all output formats. It enables authors to embed executable code in multiple languages (R, Python, C/C++, SQL), include interactive content like HTML widgets and Shiny apps, and publish directly to web platforms. The package integrates with RStudio IDE and supports one-click publishing to bookdown.org.

Contributors#

Resources featuring bookdown#

Carson Sievert: Towards the next generation of Shiny UI

About the talk: Shiny, the R package for creating interactive web graphics, recently celebrated its 10th birthday. Since then, Shiny has grown tremendously in many areas (e.g., performance, functionality, extensions, etc); however, a “hello world” Shiny app still looks like it did 10 years ago. This is mostly because Shiny goes to great lengths to ensure backwards compatibility; and as a result, default Shiny UI will likely continue to be based on Bootstrap 3 (a CSS styling framework released in 2010). However, thanks to the new bslib R package, it is now easy to opt-into a modern Bootstrap 5 foundation that “just works” with Shiny, R Markdown, flexdashboard, pkgdown, bookdown, and more. In addition to upgrading Shiny’s Bootstrap dependency, bslib also makes it much easier to do custom theming, leverage modern layout techniques, and create custom components (all from R without any CSS/HTML/JS required). At this point, bslib is still maturing, and does not yet provide what we’d consider a “complete UI toolkit”, but it should eventually replace and/or improve upon all of Shiny UI. In this talk, I’ll highlight bslib features that we’re most excited about (e.g., expandable cards, accordions, (sidebar) layouts, input controls, etc.), discuss some best design practices for improving user experience with these tools, and present some real world examples of these tools in action.

Speakers’ bio: Carson is a software engineer on the Shiny team at Posit. He joined Posit in 2018, and in recent years, has focused primarily on Shiny for Python and improving Shiny UI. The Shiny UI work has manifested in the creation and development of many R packages such as bslib, thematic, htmltools, htmlwidgets, sass, shiny, rmarkdown, flexdashboard, and more. Carson also has a PhD in statistics, is a recipient of the ASA’s Chambers Statistical Software Award, has maintained the R package plotly since 2015, authored the book “Interactive data visualization with R, plotly, and shiny”, and ran a successful freelance consulting service for numerous years

Carson Sievert, Shiny Team

Quarto with the Quarto Team | An Open-Source Chat

Join Al Manning, Carlos SchIidegger, & Charles Teague, members of the Quarto Team, as they take our questions.

Quarto is an open-source tool for scientific and technical publishing. Create dynamic content with Python, R, Julia, and Observable. Author documents as plain text markdown or Jupyter notebooks. Publish high-quality articles, reports, presentations, websites, blogs, and books in HTML, PDF, MS Word, ePub, and more. Author with scientific markdown, including equations, citations, crossrefs, figure panels, callouts, advanced layout, and more.

Key Resources: ⬡ Learn more and get started with Quarto at quarto.org

Contact ⬡ Bug reports and feature requests - https://github.com/quarto-dev/quarto-cli/issues ⬡ Need help? Github discussions - https://github.com/quarto-dev/quarto-cli/discussions

Introduction Videos for Quarto ⬡ Mine and Julia talk, https://www.youtube.com/watch?v=p7Hxu4coDl8 ⬡ Quarto Series, 1️⃣ Welcome to Quarto Workshop led by Tom Mock: https://www.youtube.com/watch?v=yvi5uXQMvu4 2️⃣ Building a Blog with Quarto led by Isabella Velásquez: https://www.youtube.com/watch?v=CVcvXfRyfE0&feature=youtu.be 3️⃣ Beautiful reports and presentations with Quarto led by Tom Mock: https://www.youtube.com/watch?v=hbf7Ai3jnxY&feature=youtu.be

Timestamps 00:00:00 Introductions 2:55 Why open source? 6:20 Can we expect to see Quarto available to R-users via CRAN any time soon? 9:10 Quarto and Google Docs? 9:49 Lua filters/shortcodes. Advice for a good development environment for prototyping and debugging? 14:59 Is there a single documentation page for ALL the quarto-specific YAML options? https://quarto.org/docs/reference
16:15 Navigating Quarto’s documentation. 18:00 Is there something like Observable SQL cells on the roadmap? 20:10 Is there something closer to {bookdown} for Quarto? What is the best way to retain data and environment objects in a quarto book? Is there any path to enabling this? See Includes, https://quarto.org/docs/authoring/includes.html 24:20 Flexdashboard? Coming soon. 26:30 A big challenge in the adoption is that Quarto is competing with ipython notebooks for mindspace, what does the Quarto team think about that? Quarto and Jupyter Notebooks will hopefully be thought of as complementary to one another, with Quarto helping a lot with narrative, layout, and appearance for publication and sharing. 30:10 Where should I go to contact you about an issue? What if the issue isn’t just Quarto, say, Quarto + Jupyter? 31:50: What is the Quarto team hoping to see the community produce? Feedback, reporting in github issues. Quarto Extensions. 34:05 Custom styling, configuring grid options. Any tips or anything in the roadmap that will help users finetune the look and feel of their output? 38:40 Terminology question; what do we call a published Quarto doc? (or webpage, blog, etc.?) 40:00 How do I stay up to date with Quarto? Getting the latest release and learning about what is new?

See what’s up on quarto.org. Look under get-started and under downloads for pre-releases

Isabella Velásquez

bookdown cli finetune flexdashboard Quarto Rstudio Data Science Machine Learning Python Stats Tidyverse Data Visualization Data Viz Ggplot Technology Coding Connect Server Pro Shiny RMarkdown Package Manager CRAN Interoperability Serious Data Science Dplyr Forcats Ggplot2 Tibble Readr Stringr Tidyr Purrr Github Data Wrangling Tidy Data Odbc Rayshader Plumber Blogdown Gt Lazy Evaluation Tidymodels Statistics Debugging Programming Education Rstats Open Source OSS Reticulate

Brad Lindblad | Professional Financial Reports with {rmarkdown} | Posit

GitHub: https://github.com/bradlindblad/pro_reports_talk

Abstract: With finance there will always be a need for reports, and as long as there’s a need for reports, there will be R users who want to create them as lazily as possible.

R Markdown lets us create incredibly customized and branded reports that can run automatically each month or day or whatever, and it all starts with the wonderful parameterizing features of R Markdown.

In this lightning talk, we will work through a practical example of creating an income statement for a group of theoretical office branches. You will learn how to make a parameterized R Markdown report, organize your R Markdown files and even create a custom cover letter, all in R.

Bio: Brad Lindblad is a data scientist located in Fargo, North Dakota. He is author of the tidyUSDA and schrute R packages, and specializes in geospatial data science and risk modeling. Brad is a frequent contributor to data science publications and loves creating new R users.

This is a meetup recording from December 2020. For more information on how to join meetups live: rstd.io/community-events

Links shared in the chat: Brad’s material/slides: https://github.com/bradlindblad/pro_reports_talk For anyone who’s new to R Markdown, this is a great reference guide and overview: https://bookdown.org/yihui/rmarkdown/ Pagedown package: https://github.com/rstudio/pagedown ETL example: https://solutions.rstudio.com/r/apps/twitter-etl/ More information on RStudio Connect: https://www.rstudio.com/products/connect/ To chat with RStudio about Connect: rstd.io/chat-with-rstudio

JooYoung Seo | Accessible Data Science Beyond Visual Models | RStudio

Full title: Accessible Data Science Beyond Visual Models: Non-Visual Interactions with R and RStudio Packages

Data science is full of vision-dominant practices, and most data scientists rely heavily on visual models.

However, data science itself should require insight and computational thinking beyond what is just seen by eyes.

JooYoung Seo, who is a blind data scientist and who was working for RStudio’s accessibility projects over the summer 2020, will talk about his experience with some non-visual techniques to interact with data.

If you would like to know more about various ways of making data science accessible via R, and new accessibility features introduced in RStudio IDE and Shiny, his demonstration without sight will be thought-provoking.

About JooYoung: JooYoung Seo is a Ph.D candidate in the Learning, Design, and Technology program at the Pennsylvania State University, and internationally certified accessibility professional whose research and development focuses on accessible computing for all. As an RStudio’s double-certified data science instructor (i.e., Tidyverse + Shiny), who is blind, he is committed to making data science ecosystem more accessible to people with and without dis/abilities using R. To this end, he has been actively contributing to R open-source projects including Shiny, RMarkdown, bookdown, and distill for accessibility, and interned on the RStudio IDE and Shiny team as an accessibility engineer in summer 2020

Shiny Team

bookdown rmarkdown rstudio Shiny tidyverse Rstudio Data Science Machine Learning Python Stats Tidyverse Data Visualization Data Viz Ggplot Technology Coding Connect Server Pro Shiny RMarkdown Package Manager CRAN Interoperability Serious Data Science Dplyr Ggplot2 Tibble Readr Stringr Tidyr Purrr Github Data Wrangling Tidy Data Odbc Rayshader Plumber Blogdown Gt Lazy Evaluation Tidymodels Statistics Debugging Programming Education Forcats Rstats Open Source OSS Reticulate JooYoung Seo Accessibility

Advanced R Markdown 2-day Workshop - rstudio::conf(2019L)

What is the 2-day Advanced R Markdown Workshop? That’s a great question, I’m glad you asked.

This is a two-day hands-on workshop based on the book “R Markdown: The Definitive Guide”.

This workshop is designed for those who want to take their R Markdown skills to the next level. We’ll talk about many low-level details in the rmarkdown package and the whole R Markdown ecosystem. The two goals of this workshop are: 1) learn how to fully customize R Markdown output (HTML, LaTeX/PDF, Word, and PowerPoint); and 2) learn more about existing R Markdown extensions in the ecosystem, such as flexdashboard, bookdown, blogdown, pkgdown, xaringan, rticles, and learnr. We will also talk about how to use or develop new language engines (languages that are not R), how to develop HTML widgets, and integrate Shiny with R Markdown.

You should take this workshop if you have experience programming in R and want to learn how to take advantage of the amazing breadth and depth of R Markdown. You’ll get the most from it if you enjoy learning how R Markdown works under the hood (which will involve reading some source code), and are seriously interested in hacking (playing) with HTML, JavaScript, CSS, LaTeX, and command-line tools. We will give minimal tutorials on these languages and tools in the workshop, but it may be easier for you to keep pace with the instructor if you already know them before.

This workshop is led by Yihui Xie, Software Engineer and Data Scientist at RStudio. Yihui is the main author of the open-source knitr package for reproducible research and dynamic report generation. He has also created and co-authored several other R packages, including rmarkdown, bookdown, blogdown, xaringan, tinytex, DT, shiny, and leaflet. He has authored and co-authored four books: Dynamic Documents with R and knitr, bookdown: Authoring Books and Technical Documents with R Markdown, blogdown: Creating Websites with R Markdown, and R Markdown: The Definitive Guide.

Speakers: Yihui Xie and Alison Hill with guest lecturers Jiena Gu and Hao Zhu