The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

cardargus 0.2.4

CRAN policy fix

The font cache no longer writes to the user’s home filespace during R CMD check. When a check is detected (via the _R_CHECK_PACKAGE_NAME_ environment variable), font_cache_dir() routes downloads to a session-specific temporary directory. This resolves the donttest additional issue where examples (install_fonts(), svg_to_png(), save_svg()) left *.woff2 files under ~/.cache/R/cardargus/. Interactive and normal use is unchanged (the persistent cache is still the default).

cardargus 0.2.3

Bug fixes

create_badge() now accepts CSS gradient background colors; previously is_light_color() was evaluated before gradient detection and aborted in col2rgb() (#14).
css_gradient_to_svg() with a single color now produces a solid gradient of that color instead of falling back to white-to-black (#4).
Utility functions in utils.R (compress_number(), escape_xml(), text_width(), text_height(), wrap_text()) no longer error on NULL, NA, or length > 1 input (#2).
is_light_color() now validates its input and errors clearly on NA, NULL, or invalid hex strings instead of returning NA/TRUE silently (#5).
Google Fonts downloaded via gfonts are now cached with their real file extension, so @font-face declares the correct format() (#3).

Internal / maintenance

SVG geometry and font-family parsing now use xml2 (a new soft dependency in Suggests) with a regex fallback, making them robust to attribute order, quoting, units (px/%), whitespace and viewBox-only sizing. Affects parse_svg_root_dim(), detect_svg_fonts(), load_svg_for_embed(), the logo rows and custom-icon sizing (#13).
generate_id() is now deterministic (session-local counter) instead of using runif(), improving reproducibility (#12).
Removed dead footer_logos_svg placeholder in svg_card() (#6).
Network downloads use explicit connect/read timeouts (#11).
Added a tests/testthat/ suite covering the pure utilities (#9).
Fixed duplicated roxygen @param tags in svg_card() and a lifecycle reference without the dependency (#7, #8). Documentation regenerated with roxygen2 8.0.0.

cardargus 0.2.0

Breaking changes

Function renames (tidyverse style)

All functions now follow snake_case naming convention. The old function names have been removed.

Removed function	Use instead
`house_icon_svg()`	`icon_house()`
`building_icon_svg()`	`icon_building()`
`construction_icon_svg()`	`icon_construction()`
`map_pin_icon_svg()`	`icon_map_pin()`
`money_icon_svg()`	`icon_money()`
`badge_svg()`	`create_badge()`
`badge_row_svg()`	`create_badge_row()`
`setup_cardargus_fonts()`	`setup_fonts()`
`install_cardargus_fonts()`	`install_fonts()`
`cardargus_font_cache_dir()`	`font_cache_dir()`
`register_knitr_engine()`	`register_cardargus_knitr()`

New features

Chrome-based rendering

Added headless Chrome support for superior font rendering via the chromote package.

svg_to_png_chrome() - Convert SVG to PNG using headless Chrome
svg_to_pdf_chrome() - Convert SVG to vector PDF using headless Chrome
chrome_available() - Check if Chrome/Chromium is available
ensure_chrome() - Check and optionally download Chrome for Testing
find_chrome_path() - Find Chrome executable on the system

Chrome auto-download

When Chrome is not installed, use ensure_chrome(download = TRUE) to automatically download “Chrome for Testing” (~150MB). This standalone Chrome distribution is cached locally and works without system installation.

Improved CLI output

All user-facing messages now use the cli package for better formatting: - Informative error messages with suggestions - Progress indicators for downloads - Structured output with bullets and formatting

Custom SVG support

Made it clearer that you can use your own SVG files for logos and icons:

# Use any SVG file path for logos
svg_card(
 title = "My Card",
 logos = c("/path/to/logo1.svg", "/path/to/logo2.svg"),
 ...
)

# Or for icons in fields
svg_card(
 title = "My Card",
 fields = list(
   list(list(label = "Name", value = "Test", with_icon = "/path/to/icon.svg"))
 ),
 ...
)

Enhanced knitr functions

All knitr/Quarto functions now support an engine parameter:

include_card() - Added engine parameter
include_card_png() - Added engine parameter
save_card_for_knitr() - Added engine parameter
card_to_grob() - Added engine parameter

Engine options: - "auto" (default): Uses Chrome if available, otherwise rsvg - "chrome": Forces Chrome rendering - "rsvg": Forces rsvg/magick rendering

Bug fixes

Fixed duplicate @font-face declarations in embed_svg_fonts()
Fixed double font embedding in svg_to_formats()
Now uses modern CSS weight range syntax (font-weight: 100 900)
Removed unused inst/fonts/ directory

Deprecated

fonts_dir() - Use font_cache_dir() instead
custom_logo_svg() - Use load_svg_for_embed() or pass file paths directly

cardargus 0.1.0

Initial release

Card Creation

svg_card() - Main function for creating SVG cards with badges, fields, and logos
Support for Google Fonts via embedded CSS
Shields.io-style badges with uniform height
Top-right and bottom-left logo positioning

Icons

icon_house() - House/home icon
icon_building() - Building icon
icon_construction() - Construction icon
icon_map_pin() - Location pin icon
icon_money() - Money/currency icon

Logos

load_svg_for_embed() - Load and process external SVG files
create_logo_row() - Create horizontal logo rows
get_svg_path() - Get paths to bundled SVGs
list_bundled_svgs() - List available bundled SVGs

Export

save_svg() - Save card as SVG file
svg_to_png() - Convert card to PNG
svg_to_png_with_margin() - Convert with margin
batch_svg_to_png() - Batch convert multiple cards

R Markdown / Quarto Integration

include_card() - Display card inline as SVG
include_card_png() - Display card inline as PNG
save_card_for_knitr() - Save for knitr::include_graphics()
register_cardargus_knitr() - Register custom knitr engine
card_to_grob() - Convert to grid graphical object

Font Management

setup_fonts() - Quick setup for showtext
register_google_font() - Register Google Fonts
font_available() - Check font availability
install_fonts() - Install fonts locally

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.