fresh-themes

Multiformat themes and templates for your résumé / CV.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
fresh-themes
194210.17.0-beta6 years ago8 years agoMinified + gzip package size for fresh-themes in KB

Readme

fresh-themes ============ Stylized templates for your résumé and/or CV, compatible with FRESH/FRESCAf and (through conversion) JSON Resumejrs formats. FRESH themes are multiformat, Markdown-aware, standards-friendly templates for résumés, CVs, and other employment artifacts.
  • Markdown-friendly. FRESH themes support Markdown and/or HTML formatting
across multiple formats. That means if you bold something in your resume you will see that style reflected not just in the HTML version, but in the MS Word version, and the PDF too.
  • Multiple output formats including HTML, MS Word, Markdown, LaTeX, plain
text, and more.
  • Engine-agnostic. FRESH themes can be built with Handlebars,
Underscore, and in the future, other template engines such as Liquid.
  • DRY. FRESH themes rely on partials and theme inheritance in order to
minimize the amount of duplication and boilerplate you have to wade through to design and/or build a modern, multiformat resume. on, FRESH themes have no commercial or corporate backing, basis, or bias.

Use

  1. The quickest way to get started with FRESH themes is to install
HackMyResume
hmr. Installing this repo (fresh-themes) is not required except for development purposes.
  1. Create a FRESHf or JRSjrs résumé.
  1. Run `hackmyresume build to .all -t
` to generate all formats for a particular theme. For example:
```bash
hackmyresume BUILD resume.json TO out/resume.all -t positive
```

Predefined FRESH Themes

This repository provides canonical versions of a handful of FRESH themes used in and installed with HackMyResume. Other FRESH themes may be available on GitHub and NPM.
  • New themes forthcoming.
All FRESH themes in this repo are MIT licensed. You're free to change, modify, update, or improve them at will.

How It Works

FRESH themes are powered by the same templates you're familiar with from Jekyll, Handlebars, MS Word, or your server-side web language of choice. You create a FRESH theme the same way you would any other template: by intermixing markup (HTML, XML, plain text, whatever) with special tags or placeholders: ```html

{{ job.title }}

{{ job.summary }}

``` Run it through a tool like HackMyResume, and you get finished markup suitable for display or saving as a document: ```html

Ninja

Performed covert ops in feudal Japan.

``` The only difference between a FRESH theme and your Jekyll blog or MS Word template is the syntax. If you can do {{ r.name }} or {% highlight html %} in a template file you can work with FRESH themes. For an annotated example of building a FRESH theme for multiple formats including HTML, MS Word, and PDF, check out the Modern theme's HTMLh and DOCd templates.

Structure

FRESH themes are structured to allow for flexible generation of documents in multiple formats. Each theme lives in a separate folder and consists of:
  • A JSON description file.
  • One or more template files in Handlebars or Underscore format.
  • Any necessary support files (CSS, LaTeX partials, etc.).
  • A dedicated README.
Within its containing folder, a theme can have an arbitrary structure provided you either a) follow a standard naming convention or b) specify your theme files in your theme's JSON file.

Contribute

Contributions are encouraged.
  1. Fork, branch, and clone this repository.
  1. Add or edit a theme or make other changes.
  1. Submit a PR.
  1. Ideally, target the dev branch with your PR.

License

MIT. See LICENSE.md1 for details.