Skip to content

Instantly share code, notes, and snippets.

@chrisbrasington
Last active August 29, 2015 14:01
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save chrisbrasington/a8afdb31b1f5bd10895a to your computer and use it in GitHub Desktop.
Save chrisbrasington/a8afdb31b1f5bd10895a to your computer and use it in GitHub Desktop.
what is bl.ocks?

bl.ocks, the Gists viewer

Well, it's this thing you're looking at right now. But where does it come from?

Given you have an account to github because you're a cool programmer, you have have available something called Gists. Gists exists to share snippets and blurbs of code with others outside the context of a project or repository.

bl.ocks.org piggy-backs off your Gists post and builds a page for you. So all my posts at https://gist.github.com/chrisbrasington create a page on http://bl.ocks.org/chrisbrasington.

Checkout a cool example from its creator, mbostock.

At minimum the post likely needs 3 items:

  • README.md (markdown file). This text you are seeing here.
  • index.html - which is rendered above the readme
  • thumbnail.png (used on the main page)

The thumbnail is about the only odd part since you can't directly upload it on Gist. However each Gist is technically its own tiny GIT repository, so you can commit a thumbnail in that manner. Thumbnail must be 230x120 pixels. more information on thumbnails

For me this is a good alternative to a code blog, and convienent as it is tied into github. Also there's a browser plugin/extension to add a button to gists -> bl.ocks which is handy.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment