Skip to content

rladies/glamour

Repository files navigation

Glamour

Branded Quarto formats for RLadies+ documents, presentations, dashboards, and reports. One extension, four output formats — all driven by a shared brand.yml design system.

Part of the RLadies+ witchy toolkit: Jinx (GitHub bot), Spellbind (R package), and Glamour (Quarto extension).

Installation

# Use as a starter template (creates a new project)
quarto use template rladies/glamour

# Add to an existing project
quarto add rladies/glamour

Requires Quarto >= 1.6.0.

Formats

HTML Document

format:
  glamour-html: default

Light and dark themes with automatic toggle. Branded headings, callouts, code blocks, tables, and print stylesheet.

RevealJS Presentation

format:
  glamour-revealjs:
    footer: "RLadies+ Oslo | rladies.org"

Branded slides with semantic classes for different slide types:

Class Usage Effect
.title-bar ## Title {.title-bar} Purple heading band
.statement ## Big idea {.statement} Centered large text
.elaborate-section # Part {.elaborate-section} Left accent bar divider
.image-slide ## Title {.image-slide background-image="..."} Full-bleed with overlay
.image-slide-bottom Same, bottom-aligned Bottom overlay variant

Colored backgrounds with automatic text inversion:

title-slide-attributes:
  class: elaborate-title
  data-background-color: "#881ef9"

Supported backgrounds: purple (#881ef9) and charcoal (#2f2f30).

Dashboard

format:
  glamour-dashboard: default

Light and dark themes. Purple navbar, branded cards, valuebox color mapping (bg-primary = purple, bg-secondary = blue, bg-info = rose). For Shiny dashboards, use thematic::thematic_shiny() for automatic plot theming.

Typst PDF

Three document modes from a single format:

Report (default) — title page with clean headers:

format:
  glamour-typst: default

Elaborate report — decorative title page with geometric accents:

format:
  glamour-typst:
    title-style: elaborate

Letterhead — branded header/footer bands on every page:

format:
  glamour-typst:
    letterhead: true
    letterhead-details: "RLadies+ Oslo | oslo@rladies.org"

Certificate — landscape completion certificate:

format:
  glamour-typst:
    certificate: true
    certificate-recipient: "Jane Doe"
    certificate-description: "Completed the Introduction to R workshop"
    certificate-footer: "rladies.org"

R+ Submark

The rlogo.lua filter renders images clipped to the R+ logo shape (HTML formats only):

::: {.rlogo image="photo.jpg" width="280px"}
:::

Options: image (path), color (solid fill, default #881ef9), width, alt, shadow (true/false).

Brand

All colors, fonts, and logos are defined in brand.yml. The extension uses:

  • Purple #881ef9 — primary brand color
  • Blue #0f55cc — secondary (WCAG AA accessible)
  • Rose #ff5b92 — tertiary accent
  • Poppins — body and heading font
  • Inconsolata — monospace font

Dark mode uses lighter tints aligned with the rladies.org website dark theme.

10 logo variants ship with the extension (horizontal, vertical, white, charcoal, lavender, and favicon).

Examples

File Format Description
example.qmd HTML Feature showcase
slides.qmd RevealJS Presentation with all slide classes
report.qmd Typst Report with elaborate title page
letterhead.qmd Typst Branded letterhead
certificate.qmd Typst Completion certificate
dashboard.qmd Dashboard Static dashboard with valueboxes
dashboard-shiny.qmd Dashboard Interactive Shiny dashboard

Render all static formats:

quarto render

Render Shiny dashboard:

quarto serve dashboard-shiny.qmd

License

CC-BY-4.0

About

R-Ladies Quarto extension

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors