Register hdatools' bundled fonts for use in plots and knitr output

Registers the font faces bundled in inst/fonts/ (Lato and Roboto Slab for theme_hda(), Open Sans and Poppins for theme_hfv(), Noto Sans for theme_pha(), Montserrat for theme_vha()) with systemfonts, making them available by name to ragg graphics devices (and any other systemfonts-aware device). Everything is read from files installed with the package, so this never makes a network request.

Usage

register_hda_fonts(quiet = FALSE)

Arguments

quiet

If TRUE, suppresses the message emitted when registering a family unexpectedly fails (a name collision with an installed system font is never reported, since it is not a failure). Registration issues are non-fatal: hdatools falls back to whatever fonts are already available on the system.

Value

Invisibly, TRUE if every bundled family is available (registered by hdatools or already present as a system font), FALSE if skipped via the opt-out or if a family failed to register for an unexpected reason.

Details

Rendering with these fonts requires a systemfonts-aware device — for knitr/Quarto output, set dev: "ragg_png" (see README.md); the default Cairo device does not consult the systemfonts registry.

Registration can be skipped by setting options(hdatools.fonts = FALSE) or the environment variable HDATOOLS_NO_FONTS to any non-empty value — useful if a consumer wants to supply its own font setup.

Each bundled family is registered independently. systemfonts::register_font() refuses to register a name that already matches an installed system font (e.g. Open Sans ships with several common apps) — when that happens, this function leaves that one family alone (the system copy resolves under the same name anyway) and still registers the rest.