lisawilliams / d3-exercises

D3 exercises from Interactive Data Visualization for the web. Examples:

Exercises from the book Interactive Data Visualization for the Web by Scott Murray

This is my "scratchpad" repo for work I do following along with Scott Murray's excellent book.

Working through the book encouraged me to create a simple D3.js starter template, which you can find here.

Details on the starter template below, from that repo's README:

Simple D3.js Starter Template

This starter template contains an index.html which links to a local, non-minified D3.js. If it's working properly, it will show a "Hello World" page locally using grunt serve and on Github Pages once you change your repository settings.

I built the following starter template for myself with two objectives:

Quickly spin up a repository that used grunt serve

This repository supports the Grunt task runner. After following the instructions in Setup, you can run grunt serve at the command line in the root directory of your project and see your site at localhost:9000.

Have a repository that published cleanly to Github Pages

As-is, once you add files to your repository, you should be able to push it to Github and see the results on Github Pages. Once you've pushed, you'll need to go to Settings > Github Pages and tell Github which branch should publish a Github Pages site for you. The .gitignore ignores environmental variables and node_modules.

Setup

Fork and clone this repository.

Once you have it in a local directory, you can change its name.

At the command line, run npm install.

Run grunt serve and then check http://localhost:9000/index.html to see if you see a "Hello World!" page. If it is, you are up and running!

Once you make any changes you want, push your changes and visit Settings to turn on Github Pages.