Books

CIPPCD 2025: Dynamic Reproducible
Documents for Public Policy with Quarto

Julia Silge

Posit PBC

Hello!

@juliasilge

@juliasilge.com

youtube.com/juliasilge

juliasilge.com

Anatomy of a Quarto book

Quarto books

  • Books are also essentially format: html + a Quarto Project

  • But a book is different than format: html in that it has multiple pages

  • Books and websites are very similar in that they associate multiple pages/resources into a connected resource

  • Books and websites are different in how they treat components: pages vs. cross-referencable chapters for website and books, respectively

Our turn

Activity

Let’s build a book together from some of the documents we’ve created so far and highlight the following features of Quarto websites:

  • _quarto.yml

  • index.qmd / landing page

  • Cross references

  • Sections

  • Appendices

Your turn

Activity

Pick up where we left off and:

  • Give a title to your book
  • Add a numbered figure and cross-reference it
  • Add a numbered figure to another chapter, cross-reference it, and observe the numbering scheme
10:00

Wrap up

Computations

Same freeze and cache ideas for websites apply to books

Publishing

Same publishing options for websites apply to books as well

Learn more

quarto.org/docs/books

Thanks!

@juliasilge

@juliasilge.com

youtube.com/juliasilge

juliasilge.com