Usage

PyResume Builder is a command line tool that takes a path to a YAML file containing resume data and produces a LaTeX document. The following is an example of YAML that will produce a resume using all features of the basic template.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
basic:
  name: McMeow
  address:
    - 1537 Paper St
  contact:
    email: meow@meow.meow
    phone: 867 5309
  websites:
    - text: Cats-R-Us
      url: https://meow.meow/meow
    - text: Cats-N-Computers
      url: https://miaow.miaow/miaow

objective: >
  I am currently looking for someone to pay me to meow.

education:
  - school: Southern Meowniversity
    startdate: Fall 2005
    enddate: Spring 2009
    degrees:
      - Bachelor of Meow, Computer Meongineering
      - "Minor, Mewthematics \\& Bit Meowta"
    achievements:
      - "Dean's Cat List"
    gpa: 3.meow/4.0

experience:
  - company: Meow Meow Inc
    titles:
      - name: Lead Meower
        startdate: April 2016
        enddate: May 2017
    projects:
      - "Tech lead on project involving meowing until food appears."
      - "Mrowled at the moon."
  
  - company: Mewling Daycare
    titles:
      - name: Quality Eng.
        startdate: March 2014
        enddate: March 2016
    projects:
      - "Designated mew troubleshooter."
      - "Trained 5994 kittens in litterbox usage."

activities:
  - name: "Meowing Endlessly"
    startdate: "Fall 2016"
    enddate: "Spring 2017"
  - name: "Core Meower's Team"
    startdate: "Fall 2010"
    enddate: "Fall 2010"

skills:
  - category: Caterwauling Languages
    skills:
      - category: Advanced
        skills:
          - Mew
          - Pur
      - category: Intermediate
        skills:
          - Meow
          - Mrow
      - category: Beginner
        skills:
          - Miaow
          - Meao
  - category: Cat Skills
    skills:
      - meowing
      - sleeping
      - eating
      - pooping
      - chasing insects

Before you begin, please be sure to read installation instructions. If you have any trouble, please be sure that all the Requirements have been satisfied. Also consider submitting feedback if you encounter any issues (bug, problem with docs, deepfelt yearning for existential meaning)

You will have the best chance of successfully using pyresume if you are running either Linux or Mac.

Basic

Basic usage is basic because it assumes that all you care about is generating LaTeX. If you want to go further and produce a PDF or some other output format supported by LaTeX, see the Advanced section below.

Single Yaml -> LaTeX

The following command assumes you have a file called ./attributes.yaml in the directory in which you are running commands. If you don’t, feel free to copy the contents of the full example shown above into a new file called ./attributes.yaml.

$ pyresume create tex ./attributes.yaml > my-resume.tex

The result is a file called my-resume.tex. You can open this file with a text editor, but it will look like gibberish unless you are familiar with TeX, LaTeX, or etc. To quote https://www-project.org/about/ ,

LaTeX, which is pronounced «Lah-tech» or «Lay-tech» (to rhyme with «blech» or «Bertolt Brecht»), is a document preparation system for high-quality typesetting. It is most often used for medium-to-large technical or scientific documents but it can be used for almost any form of publishing.

Most people may not care about that so it will be left to the reader to decide whether to `learn more about LaTeX<https://latex-project.org>`_. (You may need to learn more if you aren’t running a linux distro with either docker or some kind of software that can read LaTeX and spit out PDFs.)

Multi Yaml -> LaTeX

What if you want to keep different types of attributes in their own file? See below, where the ./basic.yaml contains all the contact information that you might (for example) want to keep out of a git repository, or in a more private git repository.

$ pyresume create tex ./attributes.yaml ./basic.yaml > my-resume.tex

As with the single yaml to LaTeX use case, the result here is a file called my-resume.tex.

Advanced

These are considered “advanced” usage because it involves using programs other than pyresume itself.

Generate PDF Using Docker Image

This usage assumes that you have docker installed. If you don’t have it installed, then you should figure that out before continuing. The docker website has some `good documentation for getting started<https://docs.docker.com/get-started/>`_.

The following commands will run a docker container that uses an image known to have a complete installation of texlive. Note that this assumes you have an attributes.yaml file in your current working directory:

$ pyresume create tex /path/to/attributes.yaml > my-resume.tex
$ docker run --rm -it -v $PWD:/doc/ thomasweise/texlive pdflatex.sh /doc/my-resume.tex

This should result in a my-resume.pdf file in your current working directory. If it doesn’t, then please feel free to Report Bugs!

Generate PDF on Linux Using texlive

These instructions should vary depending on the specific distro you are using. If your distro is not listed here but you happen to know how to adapt these instructions for it, please consider contributing documentation.

Debian 9/Stretch

You should install and texlive and latexmk if you haven’t already:

$ sudo apt-get install texlive latexmk

Once you have, the following will create your PDF resume:

$ pyresume create tex /path/to/attributes.yaml > my-resume.tex
$ latexmk -pdf my-resume.tex

This should result in a my-resume.pdf file in your current working directory. If it doesn’t, then please feel free to Report Bugs!

Tips & Tricks

Version Control

Create a git repository to version-control your resume:

$ mkdir -p /home/me/projects/personal-resume
$ cd /home/me/projects/personal-resume

$ git init

$ $EDITOR attributes.yaml # Fill it with all your secrets.
$ git add attributes.yaml
$ git commit -m "My very first version-controlled resume."

If you also consider pushing it to a public git repo be careful not to add personal contact info that you wouldn’t want everyone to see! One way to avoid this is to keep your “basic” section out of the bulk of your resume attributes, like so:

$ $EDITOR attributes.yaml # Fill it your skills, education, work history, etc
$ $EDITOR basic.yaml # Fill it your pyresume "basic" section.
$ git add attributes.yaml
$ echo "basic.yaml" >> .gitignore
$ git add .gitignore
$ git commit -m "My very first version-controlled resume."

Have your own tips & tricks? Consider writing some documentation!