mirror of
https://github.com/zap-proto/cpp-core.git
synced 2026-10-30 15:06:00 +00:00
Kenton Varda
057d3a60b5
Historically, `post.url` did not include a leading slash, but now it does apparently, which means that when prefixed with `site.baseurl`, we end up with two slashes, which is wrong. I don't know how to strip the leading slash from `post.url` so I'll just not care that the feed doesn't work when generating the site somewhere other than at root.
Cap'n Proto Documentation
This directory contains the "source code" for the Cap'n Proto web site.
The site is built with Jekyll, which depends on Ruby. Start by installing ruby1.9.1-dev. On Debian-based operating systems:
sudo apt-get install ruby-dev
Then install Jekyll 3.8.1 (Jekyll 4.x will NOT work due as they removed Pygments support):
sudo gem install jekyll -v 3.8.1
sudo gem install pygments.rb
Now install Pygments and SetupTools to be able to install the CapnProto lexer. On Debian based operating systems:
sudo apt-get install python-pygments python-setuptools
Next, install the custom Pygments syntax highlighter:
cd _plugins
sudo python capnp_lexer.py install
cd ..
Now you can launch a local server:
jekyll _3.8.1_ serve --watch
Edit, test, commit.
If you have permission, after you've pushed your changes back to github, you can make your changes live by running:
./push-site.sh
Otherwise, send a pull request and let someone else actually push the new site.