The dartlang.org site. Built with Jekyll (https://github.com/mojombo/jekyll)
and hosted on App Engine.

ORIENTATION

* ./src
  * contains all the working files
  
* ./src/appengine
  * contains app engine configuration files
  
* ./src/site
  * documents, HTML files, images, etc.
  * you will work out of here normally
  
* ./build
  * generated by jekyll, to be deployed to server
  * this directory is transient, can be deleted

CONFIGURING YOUR MAC SYSTEM

* Ensure you have Python 2.7.
  * On a mac? You might want the binary install of Python at http://www.python.org/download/releases/2.7.3/
* Open a new Terminal.
* run 'gem install jekyll'
  * ensure you are using 0.11.2 or higher
* run 'gem install kramdown'
* run 'gem install pygments.rb'
* run 'gem install compass'
* Install a forked version of compass-twitter-bootstrap
  * git clone git://github.com/toao/compass-twitter-bootstrap.git
  * cd compass-twitter-bootstrap
  * (ensure you have bundler installed. try running 'sudo gem install bundler')
  * run 'bundle'
  * run 'rake build'
  * cd pkg
  * run 'gem install compass_twitter_bootstrap'
* install the bleeding edge of Pygments
  * hg clone https://bitbucket.org/olov/pygments-main
  * cd pygments-main
  * python setup.py install
* Download and install the App Engine launcher: https://developers.google.com/appengine/downloads
  * Tell App Engine to use Python 2.7 if it's not
    * It will say, in the log "you're using 2.6"
    * On a Mac?
      * Go to Preferences, and enter the direct path to the Python 2.7 binary,
      which you downloaded from http://www.python.org/download/releases/2.7.3/
        * The full path is /Library/Frameworks/Python.framework/Versions/2.7/bin/python2.7

DEVELOPMENT

* Make sure you are in the root of this project.
* Run the server: 'make server'
* Your web browser opens to http://localhost:8080
  * You may need to reload once.
* Edit, create docs as normal.

DEPLOYMENT

* run 'make clean && make deploy'
  * this builds the site and places everything into 'build'
  * this command also uses the current branch for the app engine version name
  * this command will then deploy the site
* You will probably need to grab a unique password from your Google Account settings.
  * Save this into the App Engine Launcher during the first deployment.