Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
70 lines (56 sloc) 2.38 KB
The dartlang.org site. Built with Jekyll (https://github.com/mojombo/jekyll)
and hosted on App Engine.
File issues and bugs here: http://dartbug.com/new
Fork and submit patches here: https://github.com/dart-lang/dartlang.org
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.
Jump to Line
Something went wrong with that request. Please try again.