systemfonts (version 1.2.1)

search_web_fonts: Search font repositories for a font based on family name

Description

While it is often advisable to visit the webpage for a font repository when looking for a font, in order to see examples etc, search_web_fonts() provide a quick lookup based on family name in the repositories supported by systemfonts (currently Google Fonts and Font Squirrel). The lookup is based on fuzzy matching provided by utils::adist() and the matching parameters can be controlled through ...

Usage

search_web_fonts(family, n_max = 10, ...)

Value

A data.frame with the columns family, giving the family name of the matched font, and repository giving the repository it was found in.

Arguments

family

The font family name to look for

n_max

The maximum number of matches to return

...

Arguments passed on to utils::adist

costs

a numeric vector or list with names partially matching insertions, deletions and substitutions giving the respective costs for computing the Levenshtein distance, or NULL (default) indicating using unit cost for all three possible transformations.

counts

a logical indicating whether to optionally return the transformation counts (numbers of insertions, deletions and substitutions) as the "counts" attribute of the return value.

fixed

a logical. If TRUE (default), the x elements are used as string literals. Otherwise, they are taken as regular expressions and partial = TRUE is implied (corresponding to the approximate string distance used by agrep with fixed = FALSE).

partial

a logical indicating whether the transformed x elements must exactly match the complete y elements, or only substrings of these. The latter corresponds to the approximate string distance used by agrep (by default).

ignore.case

a logical. If TRUE, case is ignored for computing the distances.

useBytes

a logical. If TRUE distance computations are done byte-by-byte rather than character-by-character.

Examples

# Requires an internet connection

# search_web_fonts("Spectral")