1. Node.js

When running basic make tasks, make <task> is supported for *nix users and node make <task> is supported for Windows users.

npm install

[node] make test run

There are two ways of using local popular.json data.

The first is to use the stubbed version in the test framework, this can be done by changing config/_config.yml and setting extras to stub...

####
# Turn stats on or off.
# - Use 'stub' to develop against test stub.
# extras: true
extras: stub

The second method would be to copy tests/stubs/popular.json to your system's temp directory as .popular.json – e.g. /tmp/.popular.json on Linux and Mac.

If you're unsure of the location of the temp directory on your system, do the following:

$ node
> os.tmpdir()
'/tmp'

##
# for the following make tasks, you can also run:
#
# npm <task name>
##

# start server
node make start

# stop server
node make stop

# restart server
node make restart

# server status
node make status

# view logs
tail -f ./logs/server.log

Nginx tasks are only supported on *nix platforms which support make.

# generate nginx conf for your checkout and start nginx
node make nginx/start

# stop nginx
node make nginx/stop

# restart (stop then start) nginx
node make nginx/restart

# HUP nginx process to reload configs
node make nginx/reload

# to regnerate nginx.conf
rm nginx.conf

Key Overview:

1. port: Integer value of the Node application port.
2. theme: Integer value of the array index from the bootswatch section below.
3. authors: Array of Author Strings
4. description: String containing the meta descript of the site.
5. extras: Turn on extras functionality. Requires config/_oauth.yml update with correct key and security tokens.
6. favicon: Hash containing the favicon path.
7. google_analytics: Hash containing GA account_id and domain_name.
8. stylesheets: Array containing stylesheet files to be loaded at the top of the site.
9. javascripts: Array containing javascript files to be loaded either before (at the top) or after (at the bottom) of the site.
10. bootswatch: Hash containing current Bootswatch meta data and themes.
11. bootlint: Array of Hashes containing Bootlint meta data and pathing.
12. bootstrap: Array of Hashes containing Bootstrap meta data and pathing.

To add new tweets to the "Mad Love" section, follow these steps:

1. Copy the full <blockquote> HTML from the "Embed Tweet" source obtained via Twitter.
2. Replace all double quotes (") with single quotes (').
3. Wrap entire HTML block in double quotes (").
4. Add to _tweets.yml, preceeded with a dash (-), which signifies an array item in YAML.

This is reserved for MaxCDN and NetDNA installation only at this time. Contact @jdorfman for more information.