dabrorius / jobless

A ruby DSL for generating CVs.

Jobless

Jobless is a simple DSL written in Ruby for generating CVs. It generates HTML files, which can be easily converted to PDF format if needed. Here's an example of Jobless code.

Jobless.cv do
  name "John Doe"
  phone "([phone]"
  email "[email protected]"

  employment do
    entry do
      title "Full-stack Rails developer"
      company "Royal Programming Squad"
      start_date "April 2015"
      end_date "June 2015"
    end
    entry do
      title "C# Developer"
      company "Microsoft"
      start_date "January 2015"
      end_date "April 2015"
    end
  end
end

You can see a larger source example here which gets compiled into this.

Installation

You can install jobless via RubyGems

gem install jobless

Then just create a new ruby file, require jobless and start coding. When you run that file your CV will be generated.

How to start?

The best way to start is by forking the example repository. It's convinient because you can use your GitHub repo to store the CV.

Available keywords

Personal info

Following keywords are available on top level:

• name
• email
• location
• address
• phone
• homepage
• github
• blog

Groups and entries

Key part of a CV are lists of you archievements grouped in different categories. You can add groups to your CV with group keyword. Each group consists of multiple entries

group "Group title" do
  entry do
  end
end

For convenience, Jobless provides several keywords with pre-defined titles.

• employment
• education
• open_source
• other_experience
• work_experience
• summary
• skills
• projects
• awards

education do
  entry do
    title "Ruby on Rails Course"
  end
end

Entry

Entry describes one instance of your experience. For example one job position or open source project. Following keywords are available for each entry.

• title
• company
• homepage
• technologies
• description
• start_date
• end_date

They can also have multiple bulletin keywords, each of which will be rendered as one bulletin item.

GitHub Repo

GitHub Repo is a special type of entry that given a repository name will fetch and automatically fill in title, homepage and description via GitHub API.

open_source do
  github_repo 'dabrorius/jobless'
end

You can also override existing or add new keywords to that entry.

open_source do
  github_repo 'dabrorius/jobless' do
    description 'A different descrpition'
    technologies 'Ruby'
  end
end

Style

If you don't like the default style, you can provide your custom stylesheet to be used in the CV.

Jobless.cv do
  name "John Doe"
  email "[email protected]"
  stylesheet "my_awesome_style.css"
end

Ports

• Clojure jobless-clj by jbristow

jobless's Issues

Allow easy adding and using themes

Pull GitHub repo data via API

Profile photo

Problems:

• embedding photos?
• photo aspect ratios?

PDF export

Sometimes it's not enough to provide your personal site link with beautiful resume. Many companies require pdf/doc CV file (with blackjack and hookers) to attach it to an internal resource management system or send it to the customer, who doesn't know anything technical (e.g. browsers) except his kangaroo domain.

Add projects

Employee can work on the several projects in the same company, it's reasonable allow to specify projects per company in CV. For this feature we need to introduce groups in the form of the tree, where one node can contain many other nodes. In this case we can write something like this:

employment do
    company "Dream" do
      homepage "http://dream.com/"

      project "A" do
        homepage "http://project-a.com/"

        title "Rails developer"

        technologies "Ruby, Ruby on Rails"

        bulletin "B1."
        bulletin "B2."

        start_date "June 2015"
        end_date "Current"
      end

      project "B" do
        homepage "http://project-b.com/"

        title "JavaScript developer"

        technologies "Javascript, Ruby on Rails"

        bulletin "B3."
        bulletin "B4."

        start_date "June 2014"
        end_date "June 2015"
      end
    end
  end
end

Make jobless-cv repo

It will include example jobless CV that can be forked and used for version control of your CV.