| OLD | NEW |
|---|
| 1 The dartlang.org site. Built with Jekyll (https://github.com/mojombo/jekyll) | 1 The dartlang.org site. Built with Jekyll (https://github.com/mojombo/jekyll) |
| 2 and hosted on App Engine. | 2 and hosted on App Engine. |
| 3 | 3 |
| 4 ORIENTATION | 4 ORIENTATION |
| 5 | 5 |
| 6 * ./src | 6 * ./src |
| 7 * contains all the working files | 7 * contains all the working files |
| 8 | 8 |
| 9 * ./src/appengine | 9 * ./src/appengine |
| 10 * contains app engine configuration files | 10 * contains app engine configuration files |
| 11 | 11 |
| 12 * ./src/site | 12 * ./src/site |
| 13 * documents, HTML files, images, etc. | 13 * documents, HTML files, images, etc. |
| 14 * you will work out of here normally | 14 * you will work out of here normally |
| 15 | 15 |
| 16 * ./build | 16 * ./build |
| 17 * generated by jekyll, to be deployed to server | 17 * generated by jekyll, to be deployed to server |
| 18 * this directory is transient, can be deleted | 18 * this directory is transient, can be deleted |
| 19 | 19 |
| 20 CONFIGURING YOUR MAC SYSTEM | 20 CONFIGURING YOUR MAC SYSTEM |
| 21 | 21 |
| 22 * Ensure you have Python 2.7. | 22 * Ensure you have Python 2.7. |
| 23 * On a mac? You might want the binary install of Python at http://www.python.o
rg/download/releases/2.7.3/ | 23 * On a mac? You might want the binary install of Python at http://www.python.o
rg/download/releases/2.7.3/ |
| 24 * Open a new Terminal. | 24 * Open a new Terminal. |
| 25 * run 'gem install jekyll' | 25 * run 'gem install jekyll' |
| 26 * ensure you are using 0.11.2 or higher | 26 * ensure you are using 0.11.2 or higher |
| 27 * run 'gem install kramdown' | 27 * run 'gem install kramdown' |
| 28 * run 'gem install pygments.rb' | 28 * run 'gem install pygments.rb' |
| 29 * run 'gem install compass' |
| 30 * Install a forked version of compass-twitter-bootstrap |
| 31 * git clone git://github.com/toao/compass-twitter-bootstrap.git |
| 32 * cd compass-twitter-bootstrap |
| 33 * run 'rake build' |
| 34 * cd pkg |
| 35 * run 'gem install compass_twitter_bootstrap' |
| 29 * install the bleeding edge of Pygments | 36 * install the bleeding edge of Pygments |
| 30 * hg clone https://bitbucket.org/olov/pygments-main | 37 * hg clone https://bitbucket.org/olov/pygments-main |
| 31 * cd pygments-main | 38 * cd pygments-main |
| 32 * python setup.py install | 39 * python setup.py install |
| 33 * Download and install the App Engine launcher: https://developers.google.com/ap
pengine/downloads | 40 * Download and install the App Engine launcher: https://developers.google.com/ap
pengine/downloads |
| 34 * Tell App Engine to use Python 2.7 if it's not | 41 * Tell App Engine to use Python 2.7 if it's not |
| 35 * It will say, in the log "you're using 2.6" | 42 * It will say, in the log "you're using 2.6" |
| 36 * On a Mac? | 43 * On a Mac? |
| 37 * Go to Preferences, and enter the direct path to the Python 2.7 binary, | 44 * Go to Preferences, and enter the direct path to the Python 2.7 binary, |
| 38 which you downloaded from http://www.python.org/download/releases/2.7.3/ | 45 which you downloaded from http://www.python.org/download/releases/2.7.3/ |
| 39 * The full path is /Library/Frameworks/Python.framework/Versions/2.7/bin
/python2.7 | 46 * The full path is /Library/Frameworks/Python.framework/Versions/2.7/bin
/python2.7 |
| 40 | 47 |
| 41 DEVELOPMENT | 48 DEVELOPMENT |
| 42 | 49 |
| 43 * Make sure you are in the root of this project. | 50 * Make sure you are in the root of this project. |
| 44 * Run the server: 'make server' | 51 * Run the server: 'make server' |
| 45 * Your web browser opens to http://localhost:8080 | 52 * Your web browser opens to http://localhost:8080 |
| 46 * You may need to reload once. | 53 * You may need to reload once. |
| 47 * Edit, create docs as normal. | 54 * Edit, create docs as normal. |
| 48 | 55 |
| 49 DEPLOYMENT | 56 DEPLOYMENT |
| 50 | 57 |
| 51 * run 'make clean && make deploy' | 58 * run 'make clean && make deploy' |
| 52 * this builds the site and places everything into 'build' | 59 * this builds the site and places everything into 'build' |
| 53 * this command also uses the current branch for the app engine version name | 60 * this command also uses the current branch for the app engine version name |
| 54 * this command will then deploy the site | 61 * this command will then deploy the site |
| 55 * You will probably need to grab a unique password from your Google Account sett
ings. | 62 * You will probably need to grab a unique password from your Google Account sett
ings. |
| 56 * Save this into the App Engine Launcher during the first deployment. | 63 * Save this into the App Engine Launcher during the first deployment. |
| OLD | NEW |
|---|
Chromium Code Reviews
Issue 10700168:
massive CL is massive (Closed)
Base URL: https://code.google.com/p/dartlang-site/@master