/resume

automated document conversion using fabric, pandoc, and travis-ci.org

Primary LanguagePython

resume

Greg Forties latest resume: here

Overview

This repo serves as a place to get a copy of my latest resume in multiple formats, as well as an example of how to automate any task using fabric and travis-ci. It relies on the pandoc command line utility for doing the actual document conversion from markdown to various other formats.

Workflow

The basic workflow looks like this:

  1. edit the main markdown file
  2. convert it to various formats with fab build
  3. check the converted files in build/ to make sure they are what you want
  4. commit your changes back to github (.gitignore excludes build/ artifacts)
  1. if everything still looks good, tag your commit and push --tags to github
  1. enjoy not having to edit dozens of files

Example local build

$ ls -l build 
total 0
$ fab install_pandoc
System Type: Linux
Linux Distro: Ubuntu
[localhost] local: sudo apt-get install -y pandoc texlive
Reading package lists... Done
Building dependency tree       
Reading state information... Done
texlive is already the newest version.
pandoc is already the newest version.
0 upgraded, 0 newly installed, 0 to remove and 26 not upgraded.

Done.
$ fab build
Building plain...done.
Building docx...done.
Building html...done.
Building odt...done.
Building asciidoc...done.
Finished building.

Done.
$ # pdf not built by default due to dependancies, so build it separately:
$ fab build:pdf
Building pdf...done.
Finished building.

Done.
$ ls -l build 
total 148
-rw-rw-r-- 1 gforties gforties  6264 Feb 26 16:20 greg_forties_resume.asciidoc
-rw-rw-r-- 1 gforties gforties 11729 Feb 26 16:20 greg_forties_resume.docx
-rw-rw-r-- 1 gforties gforties  6823 Feb 26 16:20 greg_forties_resume.html
-rw-rw-r-- 1 gforties gforties 13899 Feb 26 16:20 greg_forties_resume.odt
-rw-rw-r-- 1 gforties gforties 97510 Feb 26 16:20 greg_forties_resume.pdf
-rw-rw-r-- 1 gforties gforties  5829 Feb 26 16:20 greg_forties_resume.txt
$ 

See Also

Fabric
Homepage - fabric's homepage
Installation Instructions - use pip
API Docs - Super useful
Fabric's own Fabfile
fabfile/ - this projects fabfile.

Travis
Homepage
Docs
.travis.yml - this project's travis configuration file

Pandoc
Homepage
Installation Instructions
Github - the README.md is especially useful if you're doing something complex

Markdown
Adam P's Markdown Cheat Sheet
https://stackedit.io/ - useful in-browser markdown editor with visual feedback. great if you're just getting started with markdown.