Generate a responsive CSS3 and HTML5 resume with Markdown, with optional PDF output.
Go to file
Craig Davis ae6550dbe6 Add composer.json file in preparation for V2 refactoring
Add changelog and contributors to the README
2014-01-08 08:05:08 -06:00
bin Fix output path 2013-10-01 00:38:51 +05:30
output Add a new pdf generation option using wkhtmltopdf 2012-03-04 15:09:53 -06:00
resume add resume/zhsample.md 2013-12-31 12:11:30 +08:00
templates Fix content size of dls in the modern template when pdf-izing 2013-11-24 21:39:47 -05:00
vendor Initial work towards template support 2013-03-18 21:36:06 -05:00
.gitignore Add composer.json file in preparation for V2 refactoring 2014-01-08 08:05:08 -06:00
README.md Add composer.json file in preparation for V2 refactoring 2014-01-08 08:05:08 -06:00
composer.json Add composer.json file in preparation for V2 refactoring 2014-01-08 08:05:08 -06:00

README.md

Markdown Resume Generator

Turn a simple Markdown document into an elegant resume with both a perfect pdf printable format, and a responsive css3 html5 file. You can view a sample at the blog post for the project.

Features

  • Three styles to choose from: modern, blockish, unstyled
  • PDF generation via wkhtmltopdf
  • Responsive design for multiple device viewport sizes
  • Simple Markdown formatting
  • Single file deployment
  • You can now version control and branch your resume.

Quickstart

php ./bin/resume.php --source resume/sample.md
php ./bin/resume.php --source resume/sample.md --pdf

Options

Choose a template with the -t option.

php ./bin/resume.php --source resume/sample.md -t blockish

If you want to edit your markdown resume in your editor while watching it update in your browser, run this command:

watch php ./bin/resume.php -s resume/sample.md -r

This makes the build script run periodically, and html document will refresh every two seconds via a meta tag. Open the ./ouput/sample.html file in your browser, and then just save your markdown document when you want to see a fresh preview.

Development

Markdown is limited to basic html markup. Follow the resume/sample.md file as a guideline. This file includes various headers and several nested elements. This allows us to construct a semantic HTML document for the resume, and then use a CSS rules to display a very nice resume. Note that because we have very few ways to nest or identify elements that many of the css rules are based on descendant and adjacent selectors.

TODO

  • Google Analytics include

Acknowledgments

The initial inspiration is from the Sample Resume Template. However, no HTML from that project has been used in this. General layout has been reused, and media queries have been added. It's a nice template, and if you are a more comfortable with html than markdown, you should use it.

Changelog

  • 0.9.0 : Add composer and update README with new changelog
  • 0.8.8 : Add Chinese text example (@ishitcno1)
  • 0.8.7 : Update pdf formatting of the modern template (@roleary)
  • 0.8.6 : Fix output path (@abhikandoi2000)
  • 0.8.5 : Fix issue #2
  • 0.8.4 : Correct chmod and add parameter for output directory (@kevinxucs)
  • 0.8.2 : Update build script and add refresh command option
  • 0.8.1 : Updating formatting of initial templates
  • 0.8 : Initial Release to Public