Polymer documentation site
The documentation site runs in Google App Engine, using the App Engine Python standard environment. Before you start you'll need the following prerequisites:
App Engine Python standard environment. Ensure this is installed by running the following command:
gcloud components install app-engine-python
Or, if you installed via apt:
sudo apt-get install google-cloud-sdk-app-engine-python
Set up your repo:
git clone https://github.com/Polymer/docs cd docs npm install
Running the site
The first time you run the site, run
gulp to build the site in its entirety:
Then start the App Engine dev server on
The site will be served from http://localhost:8080.
Making changes / watching files / live reload
If you're making changes use the
watch task. Optionally add
--reload to live
reload the tab when changes are saved.
gulp watch --reload
The site will be served on http://localhost:3000. Making changes will refresh the browser tab.
--reload: refreshes the browser tab when changes are made
--open: opens a new browser tab when
gulp watchis started
Tip - run
gulp help to see the list of available gulp tasks.
Install WebTest framework:
pip install WebTest
If your Google Cloud SDK isn't installed in
~/google-cloud-sdk, set the
variable to the path to the Cloud SDK:
Build and deploy version
YYY-MM-DD of the site:
gulp npm run deploy YYYY-MM-DD