v1.9.0-beta

Welcome to the first new version of HackMyResume in over a year. The purpose of
this release is to gather feature enhancements and bug fixes collected over the
past 18 months as we reorganize, rebrand, and prepare for the 2.0 release.

Added

• Support for private resume fields. Mark any non-leaf node in your resume
  JSON with the private property and it will be omitted from outbound resumes.

  "employment": {
    "history": [
      {
        "employer": "Acme Real Estate"
      },
      {
        "employer": "Area 51 Alien Research Laboratory",
        "private": true
      },
      {
        "employer": "H&R Block"
      }
    ]
  }

• Support for PDF generation through WeasyPrint in addition to the
  existing support for wkhtmltopdf and PhantomJS.

• Theme authors can now develop and package custom Handlebars theme helpers
  via the helpers key of the theme.json file (FRESH themes only) (#158).

• Help system has been updated with a HELP command and dedicated help pages
  for each command.

• Theme authors can relocate theme assets with the baseFolder property in
  the FRESH theme.json.

• HackMyResume will now validate the options file (if any) loaded with -o
  or --options and warn the user if necessary.

• Ability to disable Handlebars encoding/escaping of resume fields with
  --no-escape.

• Introduced the [fresh-test-themes][ftt] project as a repository for simple,
  test-only resume themes in the FRESH format.

Changed

• Dropped support for Node 4 and 5. HackMyResume officially runs on Node 6+.

• The FRESCA project has been renamed to [fresh-resume-schema][fresca]. FRESCA
  is still the nickname.

• The HackMyResume web page has moved to https://fluentdesk.com/hackmyresume.

Fixed

• Fixed an issue that would cause the convert command to detect the inbound
  resume type (FRESH or JRS) incorrectly (#162).

• Fixed an issue where generating new JRS resumes would cause a null or
  undefined error (#165).

• Fixed an issue preventing mixed-case themes from being loaded (#172).

• Fixed an issue requiring JSON Resume themes contain json-resume-theme in the
  theme path (#173).

• Fixed an issue that would cause strange @@@@ characters to appear in
  generated resumes (#207, #168, #198).

• Fixed an issue that would cause resume generation to hang after a JSON Resume
  themed resume was generated (#182).

• Fixed an issue that would cause nothing to be generated for Markdown (.md)
  formats (#179).

• Fixed an issue that would prevent a JRS resume from being converted to FRESH
  via the convert command (#180).

• Fixed an issue that would cause broken styling for JSON Resume themes (#155).

Internal

• Tests: fixed resume duration tests (#181).

v1.8.0

Added

• Updated Awesome theme to latest version of Awesome-CV.
• Introduced new theme helpers: pad, date.

Fixed

• Fixed an issue where the Awesome theme wouldn't correctly generate LaTeX outputs (#138).
• Emit a line number for syntax errors around embedded newlines in JSON strings (#137).
• Fix several PDF / PNG generation errors (#132, others).
• Display a more helpful error message when attempting to generate a PDF or PNG on a machine where PhantomJS and/or wkhtmltopdf are either not installed or not path-accessible.
• Fixed an issue that would cause long-running PDF/PNG generation to fail in certain environments.
• Fixed an issue involving an unhelpful spawn-related exception (#136).

Internal

• JSHint will no longer gripe at the use of == null and != null in CoffeeScript transpilation.
• Introduced template-friendly Awesome-CV fork to isolate template expansion logic & provide better durability for HackMyResume's awesome theme.
• Fixed a couple temporary regressions (#139, #140) on the dev branch.
• Additional tests.
• Minor breaking HackMyResume API changes.

v1.7.4

Added

• Build instructions.

Changed

• More precise date handling.

Fixed

• Issue with incomplete PDF generation (#127).
• Issue with building JSON Resume themes (#128).
• Issue with generating .json output format by itself (#97).

v1.7.3

Fixed

• Issue with generated PDFs being chopped off and displaying a mysterious sequence of numbers of unknown and possibly alien origin (#127).
• Unsightly border on Modern:PDF.
• Modern|Positive:PDF formats now correctly reference their PDF-specific CSS files.
• Incorrect helper use warning in Positive:DOC.

v1.7.2

Changed

• Interim release supporting FluentCV Desktop.

Internal

• Moved HackMyCore dependency to submodule.

v1.7.1

Changed

• Caffeinate. CoffeeScript now used throughout HackMyResume and HackMyCore; generated JavaScript lives in /dist.

Fixed

• Issue with generating a single PDF with the .pdf extension (#99).

v1.7.0

Changed

• [Internal] Relocated HMR processing code to the HackMyCore project. Shouldn't affect normal use.

v1.6.0 "Winter Storm"

Added

• Better consistency and coverage for all FRESH resumes and themes (#45).

• Initial support for overridable font styles (face, color, size) in FRESH themes.

• New resume sections. Support for projects, affiliation, governance resume sections for technical and creative projects and memberships / clubs / associations, respectively (#92).

• New command. PEEK at any arbitrary field or entry on your .json resume.

• Grunt.js support through grunt-hackmyresume. Install with npm i grunt-hackmyresume --save-dev and generate your resume as part of your Grunt-enabled workflow.

• Improved handling of start and end dates on employment, projects, education, and other sections with start/end dates.

• Support for an .ignore property on any FRESH or JSON Resume section or field. Ignored properties will be treated by HackMyResume as if they weren't present.

• Emit extended status and error info with the --debug or -d switch.

• The -o or --options switch can now handle either the path to a JSON settings file or raw JSON/JavaScript. Since the JSON double quote syntax is a bit cumbersome from the command line, HackMyResume accepts regular JavaScript object literal syntax:

  hackmyresume build resume.json -o "{ theme: 'compact', silent: 'true' }"
  

• Ability to disable sorting of resume sections (employments, projects, etc.) with the --no-sort option. HMR will respect the order of items as they appear in your resume .json file.

• Improvements to the starter resume emitted by hackmyresume new.

• Theme Authoring: Annotated the HTML and MS Word (XML) formats of the Modern theme for FRESH theme authors.

• Theme Authoring: Support for templatized CSS files in FRESH themes. CSS files are now expanded via Handlebars or Underscore prior to copying to the destination.

• Added CHANGELOG.md (this file).

Changed

• Rewrote the HackMyResume man/help page.

• Minor incremental updates to the FRESCA schema.

• PDF generation now uses asynchronous spawn() which has better compatibility with old or boutique versions of Node.js.

• Refactored colors in HackMyResume output. Errors will now display as red, warnings as yellow, successful operations as green, and informational messages as cyan.

• Theme messages and usage tips will no longer display during resume generation by default. Use the --tips option to view them.

• The --no-tips option (default: false) has been replaced with the --tips option, also defaulting to false.

• Removed the hello-world theme from the prebuilt themes that ship with HackMyResume. It can be installed separately from NPM:

  npm install fresh-theme-hello-world
  hackmyresume resume.json -t node_modules/fresh-theme-hello-world

Fixed

• PDF generation issues on older versions of Node.
• Stack traces not being emitted correctly.
• Missing speaking section will now appear on generated resumes (#101).
• Incomplete education details will now appear on generated resumes (#65).
• Missing employment end date being interpreted as "employment ends today" (#84).
• Merging multiple source resumes during BUILD sometimes fails.
• Document --pdf flag in README (#111).

v1.5.2

Fixed

• Tweak stack trace under --debug.

v1.5.1

Added

• Preliminary support for -d or --debug flag. Forces HackMyResume to emit a stack trace under error conditions.