forked from mirror/capnproto
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
7cf7511ee3 | 3 years ago | |
---|---|---|
.. | ||
_includes | 7 years ago | |
_layouts | 7 years ago | |
_plugins | 8 years ago | |
_posts | 3 years ago | |
go/capnp | 4 years ago | |
images | 10 years ago | |
javascripts | 8 years ago | |
news | 8 years ago | |
slides-2017.05.18 | 8 years ago | |
stylesheets | 8 years ago | |
README.md | 5 years ago | |
_config.yml | 9 years ago | |
_config_next.yml | 8 years ago | |
capnp-tool.md | 5 years ago | |
cxx.md | 10 years ago | |
cxxrpc.md | 4 years ago | |
encoding.md | 4 years ago | |
faq.md | 10 years ago | |
feed.xml | 3 years ago | |
index.md | 4 years ago | |
install.md | 3 years ago | |
language.md | 5 years ago | |
otherlang.md | 5 years ago | |
push-site.sh | 4 years ago | |
roadmap.md | 3 years ago | |
rpc.md | 5 years ago |
README.md
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.