chore(docs): use GAE and Google CDN for docs

Short summary: if you use local node server everything should work as before,
if you use GAE, everything should work now as well, but we pull assets from CDN.

- GAE doesn't support ':' in filenames, so I had to replace it with '_'
  but only in the filename, all servers were reconfigured to rewrite the
  urls from : to _ when doing file lookup
- We now pull angular assets from google CDN when deployed on GAE (locally
  or in production). When running on a non GAE server we pull assets from
  ../ directory as before
- Since only certain versions of Angular are available on CDN and we want
  to be able to autodeploy docs, I had to pin down the Angular files
  to a "stable" version when running on GAE

1 files changed, 6 insertions, 1 deletions

diff --git a/docs/src/gen-docs.js b/docs/src/gen-docs.js
index 2f72f404..67923fbc 100755
--- a/docs/src/gen-docs.js
+++ b/docs/src/gen-docs.js
@@ -21,7 +21,8 @@ writer.makeDir('build/docs/syntaxhighlighter').then(function() {
   var fileFutures = [];
   docs.forEach(function(doc){
     // this hack is here because on OSX angular.module and angular.Module map to the same file.
-    var id = doc.id.replace('angular.Module', 'angular.IModule');
+    var id = doc.id.replace('angular.Module', 'angular.IModule').
+                    replace(':', '_'); // rewrite : to _ to be GAE-friendly
     fileFutures.push(writer.output('partials/' + doc.section + '/' + id + '.html', doc.html()));
   });
 
@@ -89,6 +90,10 @@ function writeTheRest(writesFuture) {
   writesFuture.push(writer.copyTpl('font/fontawesome-webfont.svgz'));
   writesFuture.push(writer.copyTpl('font/fontawesome-webfont.ttf'));
   writesFuture.push(writer.copyTpl('font/fontawesome-webfont.woff'));
+
+  writesFuture.push(writer.copyTpl('app.yaml'));
+  writesFuture.push(writer.copyTpl('index.yaml'));
+  writesFuture.push(writer.copyTpl('favicon.ico'));
 }