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.
capnproto/doc
Jim Garrison 7cf7511ee3 Fix typo in roadmap.md 3 years ago
..
_includes Remove Google Analytics from web site. 7 years ago
_layouts Remove Google Analytics from web site. 7 years ago
_plugins Add future 'bulk' and 'realtime' keywords to highlighting. 8 years ago
_posts Blog post for release 0.9. 3 years ago
go/capnp Put /go/capnp/ in the right place. 4 years ago
images Add missing file from previous commit. 10 years ago
javascripts Add slides for meetup talk. 8 years ago
news In mobile view, put the sidebar at the bottom, not the top. Duh. 8 years ago
slides-2017.05.18 Remove threads slide. Too boring. 8 years ago
stylesheets Add slides for meetup talk. 8 years ago
README.md Jekyll 4.x broke the site, explicitly use an older version. 5 years ago
_config.yml Force Jekyll to use Pygments because that's what I wrote the capnp plugin for. 9 years ago
_config_next.yml Add RSS feed to site (will go live with 0.6 release). 8 years ago
capnp-tool.md fix(doc): remove small typos 5 years ago
cxx.md Document new features in 0.5: Generics and canonicalization. 10 years ago
cxxrpc.md Use archive of "All Concurrency Models Suck" 4 years ago
encoding.md Clarify canonicalization behavior on zero-sized values. 4 years ago
faq.md Fight common misconception that Cap'n Proto doesn't validate input. 10 years ago
feed.xml Fix feed.xml. 3 years ago
index.md Update protobuf link 4 years ago
install.md Fixes #1288. 3 years ago
language.md Fix markup of code blocks within lists. 5 years ago
otherlang.md Consistent "JavaScript" casing 5 years ago
push-site.sh Update server hostname. 4 years ago
roadmap.md Fix typo in roadmap.md 3 years ago
rpc.md Consistent "JavaScript" casing 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.