Go by Example

Content and toolchain source for the Go by Example site.

Overview

This repo contains:

• src: Go and Bash source code for the site
• meta: metadata used to generate the site
• tool: toolchain used to generate the site
• template: HTML templates and CSS for the site

The site is built by extracting the code & comments from the .go and .sh source files in src and rendering that data according to meta and templates via programs in tool.

Usage

To validate the source, generate the site, and open the home page in your browser:

$ tool/build
$ open site/index.html

To build continuously in a loop:

$ tool/build-loop

Generation requires the pygmentize binary for syntax highlighting.

Serving

The site is served by the gobyexample-server tool. To export to this tool:

$ SITEDIR = ../gobyexample-server/public tool/build

License

This work is licensed under a Creative Commons Attribution 3.0 Unported License.