Generate a responsive CSS3 and HTML5 resume with Markdown, with optional PDF output.
Go to file
Erik Waibel 1c0779b05d Add composer.phar and composer.lock to .gitignore 2018-02-07 15:26:42 -07:00
bin Direct errors from `git describe` to `/dev/null` 2017-11-13 22:29:33 +01:00
build Remove legacy phar file build and update composer tooling (#63) 2017-10-19 16:42:54 -07:00
examples Add outputs built from tool. 2017-12-11 15:31:23 -08:00
src/Resume Fix incorrect wkhtmltopdf command 2017-10-19 16:59:16 -07:00
templates Add new Roboto template and update versions for composer.json (#62) 2017-10-16 15:40:06 -07:00
tests Remove legacy phar file build and update composer tooling (#63) 2017-10-19 16:42:54 -07:00
.gitignore Add composer.phar and composer.lock to .gitignore 2018-02-07 15:26:42 -07:00
.travis.yml Remove legacy phar file build and update composer tooling (#63) 2017-10-19 16:42:54 -07:00
LICENSE Add MIT License to the project 2017-08-06 17:58:27 -07:00
README.md Update README.md 2017-12-11 15:33:33 -08:00
composer.json Add '@dev' for phpunit to fix error about incorrect versions 2018-02-07 15:22:48 -07:00
phpunit.xml Code formatting and general cleaning. 2014-01-12 15:31:27 -07:00

README.md

Markdown Resume Generator Build Status

Convert markdown to HTML and PDF resumes

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, or look in examples/output to see sample PDFs.

Features

  • Multiple styles to choose from: modern, blockish, unstyled, readable, swissen (Fork and add more!)
  • PDF generation via wkhtmltopdf
  • Responsive design for multiple device viewport sizes
  • Simple Markdown formatting
  • Single file deployment (no external stylesheets)
  • You can now version control and branch your resume.

Install

OSX

  1. The simplest installation of the PDF to HTML conversion tool is via Homebrew Cask
brew cask install wkhtmltopdf
  1. Download as .zip (cloning has an issue as of Dec 2017) and unzip.
  2. Install PHP 7 and be sure to update your PATH variable.
  3. Install 'composer', a per-project package installer to setup the rest of the requirements. You may need to run './composer.phar update' to get the correct versions of dependencies.
  4. Now you should be ready to continue down in Quickstart.

Debian

sudo apt install php7.0-mbstring wkhtmltopdf

Fedora

sudo dnf install php-mbstring wkhtmltopdf

Quickstart

    ./bin/md2resume html examples/source/sample.md examples/output/
    ./bin/md2resume pdf examples/source/sample.md examples/output/

Help

Markdown Resume Generator version 2.2.1 by Craig Davis

Usage:
  [options] command [arguments]

Options:
  --help           -h Display this help message.
  --quiet          -q Do not output any message.
  --verbose        -v|vv|vvv Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
  --version        -V Display this application version.
  --ansi              Force ANSI output.
  --no-ansi           Disable ANSI output.
  --no-interaction -n Do not ask any interactive question.

Available commands:
  help        Displays help for a command
  html        Generate an HTML resume from a markdown file
  list        Lists commands
  pdf         Generate a PDF from a markdown file
  stats       Generate a word frequency analysis of your resume
  templates   List available templates
  version     Show current version information

Examples

Choose a template with the -t option.

`./bin/md2resume html --template blockish examples/source/sample.md examples/output/`

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

`watch ./bin/md2resume html --refresh yes --template modern examples/source/sample.md examples/output/`

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

For information about running this inside a Docker container, please read Issue 46 where Sebastian Klose has shared his approach.

Authoring Your Resume

Markdown is limited to basic html markup. Follow the examples/source/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 CSS rules to display a nicely formatted 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.

Feature Development

In order to add new commands, you'll need to first install the dependencies:

  • composer install

After that, you can run the md2resume_dev.php file from the command line.

Building a Release

  1. Tag the repo with the new build number.
  2. Run composer build.
  3. Push both the tag and the code.

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

  • 2.2.0 : Dropped phar file distribution, removed Pake and migrated to composer commands
  • 2.1.0 : Dropped PHP5 support
  • 2.0.12 : Added new Roboto template from @ejwaibel
  • 2.0.10 : Updated spacing in moder template with commites from @501st-alpha1
  • 2.0.9 : Updated Modern template with improved spacing. Update parsing of --template option to close issue #7
  • 2.0.8 : New readable theme contributed by @ahmadnazir, minor refactor to support a /links directory
  • 2.0.7 : Update composer to use sunra/php-simple-html-dom-parser this appears to be better maintained and more popular to close #27
  • 2.0.6 : Fix empty template list from phar file to close #24
  • 2.0.5 : Remove default value for the --refresh option to close #22
  • 2.0.4 : Fix path resolution problem with absolute paths to close #16
  • 2.0.3 : Add optional duration to the --refresh option to close #15
  • 2.0.2 : Add new dependency check for mbstring to close #20
  • 2.0.1 : Add new swissen template with Helvetica styling @beautifulcode
  • 2.0.0 : Complete rewrite with the symfony console component. Deployment is now done with a compiled phar file, and development dependencies are managed with composer.
  • 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

HELLO