Impossible to build and run Polymer Docs Repo on Windows 10

[Carl Bentle]

I was hoping to fix a broken image on:

https://elements.polymer-project.org/browse?package=paper-elements&view=cards

It's the one for paper-dropdown-menu

I forked the repo:

https://github.com/Polymer/docs

And followed the instructions, however it was basically impossible to get it to run. NPM showed several warnings about dependencies being out of date and bower being called incorrectly (it shows the bower help)

_______________________________________

D:\dev\docs>npm install

> Polym...@1.0.0 postinstall D:\dev\docs

> bower install; gulp

Usage:

    bower <command> [<args>] [<options>]

...

npm WARN optional Skipping failed optional dependency /chokidar/fsevents:

npm WARN notsup Not compatible with your operating system or architecture: fsev...@1.0.14

_____________________________________

Then Gulp shows several errors:

D:\dev\docs>gulp

[16:34:42] Using gulpfile D:\dev\docs\gulpfile.js

[16:34:42] Starting 'clean'...

[16:34:42] Starting 'jshint'...

[16:34:42] Finished 'clean' after 213 ms

[16:34:42] Finished 'jshint' after 363 ms

[16:34:42] Starting 'default'...

[16:34:42] Starting 'style'...

[16:34:42] Starting 'images'...

[16:34:43] Starting 'vulcanize'...

[16:34:43] Starting 'vulcanize-demos'...

[16:34:43] Starting 'jshint'...

ERROR finding /dev/docs/app/bower_components/iron-doc-viewer/iron-doc-viewer.html

ERROR finding /dev/docs/app/bower_components/iron-flex-layout/iron-flex-layout-classes.html

ERROR finding /dev/docs/app/bower_components/iron-icon/iron-icon.html

ERROR finding /dev/docs/app/bower_components/paper-button/paper-button.html

ERROR finding /dev/docs/app/bower_components/polymer/polymer.html

ERROR finding /dev/docs/app/bower_components/google-youtube/google-youtube.html

ERROR finding /dev/docs/app/bower_components/webcomponentsjs/webcomponents-lite.min.js

ERROR finding /dev/docs/app/bower_components/google-map/google-map.html

ERROR finding /dev/docs/app/bower_components/paper-styles/typography.html

ERROR finding /dev/docs/app/bower_components/app-layout/helpers/helpers.html

ERROR finding /dev/docs/app/bower_components/iron-iconset-svg/iron-iconset-svg.html

ERROR finding /dev/docs/app/bower_components/paper-tabs/paper-tabs.html

ERROR finding /dev/docs/app/bower_components/paper-tabs/paper-tab.html

ERROR finding /dev/docs/app/bower_components/iron-pages/iron-pages.html

ERROR finding /dev/docs/app/bower_components/app-layout/app-drawer/app-drawer.html

ERROR finding /dev/docs/app/bower_components/app-layout/app-header/app-header.html

ERROR finding /dev/docs/app/bower_components/app-route/app-location.html

ERROR finding /dev/docs/app/bower_components/app-route/app-route.html

ERROR finding /dev/docs/app/bower_components/iron-ajax/iron-ajax.html

ERROR finding /dev/docs/app/bower_components/iron-collapse/iron-collapse.html

ERROR finding /dev/docs/app/bower_components/iron-media-query/iron-media-query.html

ERROR finding /dev/docs/app/bower_components/iron-selector/iron-selector.html

ERROR finding /dev/docs/app/bower_components/paper-icon-button/paper-icon-button.html

[16:34:44] Finished 'jshint' after 577 ms

[16:34:44] Starting 'js'...

[16:34:44] Finished 'js' after 110 ms

[16:34:44] Finished 'style' after 1.75 s

[16:35:08] gulp-imagemin: Minified 84 images (saved 4.64 MB - 33%)

[16:35:09] Finished 'images' after 26 s

____________________________________________________________________

Finally can't this run in any web server? It's really annoying to have to install App Engine. And it's even more annoying because App Engine couldn't correctly server the dist directory. The command:

dev_appserver.py dist/

Doesn't work, although:

dev_appserver.py D:\dev\docs\

does at least start App Engine, but when the site runs I get:

Internal Server Error

The server has either erred or is incapable of performing the requested operation.

Traceback (most recent call last):
  File "C:\Program Files (x86)\Google\google_appengine\lib\webapp2-2.5.2\webapp2.py", line 1535, in __call__
    rv = self.handle_exception(request, response, e)
  File "C:\Program Files (x86)\Google\google_appengine\lib\webapp2-2.5.2\webapp2.py", line 1595, in handle_exception
    return handler(request, response, e)
TypeError: handle_500() takes exactly 4 arguments (3 given)

____________________________________________________________________

Torture!