dafyddcrosby/resumeman

Command line based resume builder made in Ruby using Middleman.

Resume Man

Resume Man is an HTML and PDF resume builder made in Ruby with Middleman.

It has the following features:

• Separation between content and data, all your resume information is an YAML file.
• Fork this project for maintening multiple versions of your resume in sync.
• Markdown for formatting of the longer paragraphs.
• Default template included: SRT.
• You can preview your changes with Middleman's included server.
• config.ru file included for use with Pow.
• Automatic PDF generation using wkpdf (OS X) or wkhtmltopdf (other platforms).
• Turnkey deployment to a http://yourusername.github.com/resume page no configuration necessary.
• hResume microformat support

Preview

See the result: sample resume.

In practice

Fork this project and name it resume for example. Follow the installation instructions below.

To create/update your resume, you'll just need to edit the data/resume.yml file. All keys with a desc: | header can be Markdown formated.

Here is what it looks like:

info:
    name: Jonathan Doe
    shortdesc: Web Designer, Director
    email: [email protected]
    phone: (313) - 867-5309
    address:
        - 123 Fake Street
        - City, Country
    desc: |
        You can put Markdown in here [like this](http://daringfireball.net/projects/markdown/).

You can preview your changes via http://resume.dev/ if using Pow or http://localhost:4567/ otherwise.

bundle exec middleman build

Build the static version of your resume, it'll also create the PDF version.

bundle exec middleman deploy

Upload it to a github page. Your resume will be available at http://yourusername.github.com/resume.

Installation

Note: if you are on OS X and using rvm/rbenv, use the system Ruby. Wkpdf depends on Rubycocoa and works best with the system provided Ruby.

If you forked to your own repo:

git clone https://github.com/<yourusername>/resume.git
cd resume

Otherwise:

git clone https://github.com/reefab/ResumeMan.git
cd ResumeMan

Install all dependencies:

sudo gem install bundler
bundle install --path vendor/bundle

If using Pow, this will setup a previewing server that will be available at http://resume.dev/

ln -s `pwd`/. ~/.pow/resume

Otherwise, you'll have to launch the previewing server manually:

bundle exec middleman

Note on PDF generation

On OS X, wkpdf is used. It has a PDF output comparable to Safari and is perfectly adequate.

On the other hand, for other platforms Wkhtmltopdf doesn't have the best PDF rendering. Manually exporting a PDF version from Chrome might have a better result especially for page breaks.