cannam@48: # Cap'n Proto Documentation
cannam@48: 
cannam@48: This directory contains the "source code" for the Cap'n Proto web site.
cannam@48: 
cannam@48: The site is built with [Jekyll](http://jekyllrb.com/), which depends on Ruby. 
cannam@48: Start by installing ruby1.9.1-dev. On Debian-based operating systems:
cannam@48: 
cannam@48:     sudo apt-get install ruby1.9.1-dev
cannam@48: 
cannam@48: Then install Jekyll:
cannam@48: 
cannam@48:     sudo gem install jekyll
cannam@48: 
cannam@48: Now install Pygments and SetupTools to be able to install the CapnProto lexer.
cannam@48: On Debian based operating systems:
cannam@48: 
cannam@48:     sudo apt-get install python-pygments python-setuptools
cannam@48: 
cannam@48: Next, install the custom Pygments syntax highlighter:
cannam@48: 
cannam@48:     cd _plugins
cannam@48:     sudo python capnp_lexer.py install
cannam@48:     cd ..
cannam@48: 
cannam@48: Now you can launch a local server:
cannam@48: 
cannam@48:     jekyll serve highlighter --watch
cannam@48: 
cannam@48: Edit, test, commit.
cannam@48: 
cannam@48: If you have permission, after you've pushed your changes back to github, you can make your changes live by running:
cannam@48: 
cannam@48:     ./push-site.sh
cannam@48: 
cannam@48: Otherwise, send a pull request and let someone else actually push the new site.