Skip to contents

Changelog

Source: NEWS.md

curriculr 0.3.1.9000

New features

  • cv_render_section() now aggregates multi-row entries automatically. Rows sharing the same title, unit, startMonth, startYear, endMonth, endYear, and where values are treated as a single entry: one header renders at the top with the date and location right-aligned, and each detail value appears as an indented bullet beneath it. Single-detail entries continue to render exactly as before. Row order in the workbook controls bullet order. This behavior applies to all sections, not just experience.

Improvements

  • create_cv() now writes the intermediate CV.qmd to a temporary directory rather than the workbook folder. The file is never visible to the user and is cleaned up automatically. As a result, overwrite no longer has any effect in render mode – re-running create_cv() on an existing project requires no flags.

  • Fixed bullet spacing in multi-responsibility CV entries. An earlier implementation wrapped each bullet in a block-level #pad(), causing the gap between bullets to inherit from the document’s par.spacing rather than from the package. Spacing is now set explicitly, which also makes rendered output consistent across different rendering environments. Thanks for @orestesI for the bug report

curriculr 0.3.1

Bug fixes

  • cv_contact_line(): when use_icons = "fontawesome", contact fields now render as icons only. Previously the icon and the text label both appeared, producing redundant output like the globe icon followed by “erwinlares.com”.

  • cv_contact_line(): email addresses no longer render with a spurious backslash before the @ symbol in Typst PDF output. The double call to typst_escape() inside the switch() default arm caused @ to be escaped twice, producing a literal backslash in the rendered document. Fixed by removing the inner typst_escape() call so all fields are escaped exactly once (thanks @gygl!).

curriculr 0.3.0

CRAN release: 2026-05-13

Breaking changes

  • read_cv_data() now requires the openxlsx2 package instead of readxl. Remove readxl and add openxlsx2 to any explicit dependencies in your own projects that call read_cv_data() directly.

  • create_cv() no longer falls back to a bundled placeholder image when photo = NULL in render mode. Omitting photo now produces a single-column header layout with no image. Supply a path explicitly to restore the two-column layout with a profile photo.

New features

  • Resume variant. create_cv() and read_cv_data() gain a variant argument ("cv" or "resume"). When variant = "resume", only rows where include_in_resume is checked in the workbook are included in the rendered output. Every section sheet now carries an include_in_resume column for row-level control.

  • Font Awesome icons. create_cv() gains a use_icons argument ("fontawesome" or "none"). When "fontawesome" (the default), contact fields in the CV header are rendered with Font Awesome icons via the Typst @preview/fontawesome package. Fields with no icon equivalent fall back to plain text with a warning. The new exported function cv_contact_line() assembles the contact line and can be called directly in custom templates.

  • Workbook-controlled theming. A new theme sheet in the workbook controls fonts, colors, and page layout. Keys map directly to the Typst style block and the Quarto format: typst: YAML block, both of which are now injected by create_cv() via sentinel substitution. If the theme sheet is absent, built-in defaults are used and individual missing keys are filled from defaults, so partial theme sheets are supported.

  • add_section(). New exported function that adds a new sheet to an existing curriculr workbook and registers it in the sections control sheet. The new sheet is pre-populated with the standard column spine including include_in_resume. The sections row is appended or updated in place without touching the sheet’s formatting.

  • No-photo header layout. When photo = NULL, CV.qmd now emits a single full-width centered header block instead of a two-column grid with an empty left column.

Improvements

  • read_cv_data() reads the theme sheet as a named character vector keyed by the key column, parallel to the profile sheet. Returns NULL if the sheet is absent.
  • read_cv_data() coerces all section columns to character after import, including numeric year columns and logical boolean columns, giving the rendering pipeline a uniform contract.
  • read_cv_data() gains a .coerce_col() internal helper that normalizes NA strings produced by as.character(NA) back to NA_character_.
  • create_cv() injects variant and use_icons into CV.qmd as Quarto params so the Quarto subprocess applies the same filtering and icon settings as the calling R session.
  • The cv-data-template.xlsx template workbook gains a theme sheet with all twelve default theming keys and a description column for in-workbook documentation. The readme sheet is updated to document the theme sheet and to reflect that include_in_resume is now present on all section sheets.
  • Internal helpers .cv_theme_defaults(), .resolve_theme(), .build_format_block(), .build_typst_theme_block(), and .fa_icon_map() are added to support theming and icon assembly.

Dependency changes

  • openxlsx2 added to Imports.
  • readxl removed from Imports.

curriculr 0.2.0

Breaking changes

  • create_cv() has been redesigned. The old scaffolding behavior is replaced by two distinct modes triggered by whether data is supplied or not.

New features

  • create_cv() scaffold mode (no arguments) copies the template workbook and placeholder image to the current working directory and prints step-by-step instructions. Does not render.
  • create_cv() render mode (with data and photo) reads the workbook, writes CV.qmd, and renders CV.pdf into the same directory as the workbook.
  • Added sections sheet support. The workbook now controls which sections are rendered and in what order. Row order is render order. Deleting a row excludes a section. Adding a row for any sheet that follows the standard column schema renders it automatically.
  • Added resolve_date_fun() which maps date_fun token strings ("date", "year", "month_year", "year_only", "none") to R date formatting functions.
  • typst_escape(), cv_section(), and resolve_date_fun() are now exported.
  • inst/templates/CV.qmd simplified – section rendering is now driven by iterating over cv$sections. The template uses sentinel strings that create_cv() replaces with resolved paths at render time.

Improvements

  • read_cv_data() skips the readme sheet entirely.
  • read_cv_data() validates the sections sheet column names on read.
  • read_cv_data() returns the sections sheet in row order without sorting.
  • Non-ASCII characters in cli messages replaced with Unicode escapes for CRAN portability.

curriculr 0.1.0

  • Initial release.
  • read_cv_data() reads a curriculr-formatted Excel workbook into a named list of data frames.
  • cv_render_section() renders a CV section from a data frame into raw Typst output inside a Quarto document.
  • create_cv() scaffolded a new CV project with a template workbook, placeholder image, and ready-to-render Quarto document.