Books

SciPy 2024: Unlocking Dynamic Reproducible Documents
A Quarto Tutorial for Scientific Communication

Mine Çetinkaya Rundel

Duke University + Posit PBC

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

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

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

Questions

Any questions / anything you’d like to review before we wrap up this module?