README.md

bookup-html custom quarto format

bookup is a custom quarto HTML format based on the Roboto font family. It provides both a light and a dark theme, and should be suitable for single documents, book projects and website projects.

Screenshots

Single document, light theme (live example)
Single document, dark theme (live example)
Book project with a docked sidebar, light theme (live example)
Website project with a floating sidebar, dark theme (live example)

Installation and usage

To use this custom format, first install the extension at the root directory of your project:

quarto add juba/bookup-html

And add the format to your YAML configuration, along with other HTML format options if needed:

format:
    bookup-html:
        toc: true
        toc-depth: 3

Even simpler, you can also directly install the extensions and generate a sample qmd file from a template with:

quarto use template juba/bookup-html

Dark and light variants

Warning : this will only work with quarto version 1.3 or higher.

By default, your document will be displayed with the light theme, with a toggle allowing to switch to the dark theme.

If you want to change this behavior you can add a variant to the format name:

Format name	Theme used
bookup-html (default)	Light theme by default, optional dark theme
bookup-html+dark	Dark theme by default, optional light theme
bookup-html+lightonly	Light theme only
bookup-html+darkonly	Dark theme only

Format Options

Currently bookup provides the following option:

• embed-fonts : if set to true, fonts are included locally with the document. If set to false, they are downloaded from Google Web Fonts. Not that if you use self-contained: true, fonts are embedded inside the resulting HTML even if embed-fonts is false.

Credits

This format is derived from the original bookdown theme, adapted for the online french book Introduction à R et au tidyverse.