Skip to content
Branch: app
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time


You see, yak shaving is what you are doing when you're doing some stupid, fiddly little task that bears no obvious relationship to what you're supposed to be working on, but yet a chain of twelve causal relations links what you're doing to the original meta-task.

- Jeremy H. Brown

Kill The Yak is a website with guides that will reduce the time you spend yak shaving.

Contribute content

If you are interested in contributing content, see the killtheyak-pages repo.


Kill The Yak is a small Flask app that uses Flask-FlatPages and Frozen-Flask to build the static content. The app itself lives in the killtheyak/ directory. Feel free to use, modify, or just browse around.

Setting up

Clone the repo

$ git clone --recursive

The --recursive option clones the killtheyak-pages submodule.

Install the necessary Python packages (requires Python 2.7 with pip):

# After activating your virtualenv
$ pip install -r requirements.txt

Building the site

To run the local development server

$ python runserver

You can browse to http://localhost:5000/ to view the site.

To build the static version of the site:

$ python build

This will build the static site to the build/ directory.


To deploy to GitHub Pages:

$ python deploy

This will build the site, commit to the master branch, and push to GitHub.


Copyrights to the guides are owned by their original authors and are licensed under the Creative Commons Attribution-Share-Alike license. The website is licensed under the MIT License.


Yak shaving sucks. So let's kill the yak.




No releases published
You can’t perform that action at this time.