Skip to content

Latest commit

 

History

History
97 lines (65 loc) · 2.51 KB

README.md

File metadata and controls

97 lines (65 loc) · 2.51 KB
Raw

dapper-invoice

A billable-time invoice featuring style over substance.

Example Screenshot

Pre-Requisites

  • TeX Live
  • TeX xetex (siunitx.sty)
  • TeX science (fontawesome.sty)

— or —

— or —

Generating an Invoice

Using TeX Live Locally

cp example.tex your-invoice-101.tex
# make some changes to your-invoice-101.tex
make your-invoice-101.pdf

Your invoice will be created as your-invoice-101.pdf

Using Vagrant

cp example.tex your-invoice-101.tex
vagrant up  # this may take a while the first time
vagrant ssh -c 'cd /vagrant; make REPORT=your-invoice-101 watch'

Now whenever you make changes to your-invoice-101.tex on your host machine, the watcher inside the VM will automatically build your-invoice-101.pdf, which will be saved back to the host machine.

When finished editing, input Control-C to stop the watcher, then run:

vagrant halt

Using Docker

Use Docker Hub's blang/latex image that comes with a matching .sh file. When you first run this .sh file, it will pull the docker image that includes all of the latex dependencies.

wget https://raw.githubusercontent.com/blang/latex-docker/master/latexdockercmd.sh
chmod +x latexdockercmd.sh
./latexdockercmd.sh  # will pull down image on first use

Then, you can use the .sh file as you would xelatex:

cp example.tex your-invoice-101.tex
latexdockercmd.sh xelatex [options] your-invoice-101.tex

You invoice will be created as your-invoice-101.pdf

Documentation

See example.tex and dapper-invoice.cls for details.

Inspiration

I am not a designer. Inspiration for the design comes from borrowing design ideas from good looking invoices people have published on the net. The resulting design is not even in the same league, but I think it gets the job done.

I am also not a LaTeX author. The code borrows heavily from the moderncv package (which I can't recommend enough), as well as numerous other packages.

Licensing

The code I have written I release under the MIT license.

Two different font packages are included in the repo for convenience:

  • OpenSans (Apache License v2.00)
  • Font Awesome (SIL OFL 1.1)