Motivation

I wanted to create visualizations of a git history similar to those in the Git Book. I found a StackOverflow question that gave multiple ways to create graphics, and one of them is gitdags, a LaTeX package.

This tool uses gitdags to automatically generate a graphic visualizing the history of a repo. It is "dumb" because sometimes the branch tags overlap the commit hashes. The tool will generate the .tex file, and you can edit to fix this issue.

NOTE: You CANNOT name a branch with an _ (underscore) in it. This a sepcial character in latex, and the gitdags library also uses the name as an identifier. So you can't simply replace it with \_.

Requirements

• gitPython[https://gitpython.readthedocs.io/en/stable/index.html]
• pdflatex - On a Mac, I suggest MacTex
• gitdags. The .sty file must be accessible. If you installed MacTex, you can put the .sty in ~/Library/texmf/tex/latex