# sef.kloninger.com AKA sefk.github.io This is my personal blog. It is a Nikola static site hosted by Github pages. This repo contains both the source files: the source files are in the "dev" branch (the default for this repo) and the build products are on "master". # Instructions The general workflow is: 1. **Write**. I like writing in Markdown with vi. Green characters on a black background. Old school is the good school. 2. **Review**. Nikola has a nice feature to automatically rebuild your project whenever something changes. The -b option fires up a localhost browser that refreshes with every save. Very nice workflow. Command is ```nikola -b -p 8888```. The extra port because the default, 8000, usually collides with my dev environment or something similar. 3. **Publish**. Check the changes to the dev branch and push that branch. Then run the command ```nikola github_deploy``` to build and publish the build product to the master branch. github_deploy builds, commits, and pushes in one fell swoop. 4. **Repeat** ## Install Notes ### Python Nikola seems to require python 3 now. So start with that brew install python3 mkvirtualenv -p `which python3` sefk.github.io pip install --upgrade pip (note the backticks in the code above ### lxml error If you're seeing this: fatal error: 'libxml/xmlversion.h' file not found error: command 'cc' failed with exit status 1 Then try this: brew install libxml2 brew install libxslt brew link libxml2 --force brew link libxslt --force CPATH=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.9.sdk/usr/include/libxml2 CFLAGS=-Qunused-arguments CPPFLAGS=-Qunused-arguments pip install lxml Not sure the brew steps are req'd or not. That last step is what did it. From [this StackOverflow answer](http://stackoverflow.com/questions/19548011/cannot-install-lxml-on-mac-os-x-10-9)