Go CSS Shell Ruby HTML
Need help with gobyexample?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
mmcgrana

Description

Go by Example

4.5K Stars 875 Forks 1.1K Commits 13 Opened issues

Services available

Need anything else?

Go by Example

Content and build toolchain for Go by Example, a site that teaches Go via annotated example programs.

Overview

The Go by Example site is built by extracting code and comments from source files in

examples
and rendering them via the
templates
into a static
public
directory. The programs implementing this build process are in
tools
, along with some vendor'd dependencies in
vendor
.

The built

public
directory can be served by any static content system. The production site uses S3 and CloudFront, for example.

Building

Build Status

To build the site you'll need Go and Python installed. Run:

$ go get github.com/russross/blackfriday
$ tools/build

To build continuously in a loop:

$ tools/build-loop

To see the site locally:

$ tools/serve

and open

http://127.0.0.1:8000/
in your browser.

Publishing

To upload the site:

$ gem install aws-sdk
$ export AWS_ACCESS_KEY_ID=...
$ export AWS_SECRET_ACCESS_KEY=...
$ tools/upload

License

This work is copyright Mark McGranaghan and licensed under a Creative Commons Attribution 3.0 Unported License.

The Go Gopher is copyright Renée French and licensed under a Creative Commons Attribution 3.0 Unported License.

Translations

Contributor translations of the Go by Example site are available in:

Thanks

Thanks to Jeremy Ashkenas for Docco, which inspired this project.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.