# 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)