From 60a12b416104697d48a465bffbcfefbec35f06ea Mon Sep 17 00:00:00 2001
From: Igor Minar <igor@angularjs.org>
Date: Mon, 20 Aug 2012 08:28:04 -0700
Subject: [PATCH] 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
---
 Rakefile                              |  13 ++++-
 docs/src/gen-docs.js                  |   7 ++-
 docs/src/templates/app.yaml           |  66 ++++++++++++++++++++++++++
 docs/src/templates/docs-scenario.html |  39 ++++++++++++++-
 docs/src/templates/favicon.ico        | Bin 0 -> 1150 bytes
 docs/src/templates/index.html         |  21 +++++++-
 docs/src/templates/index.yaml         |  12 +++++
 lib/nodeserver/server.js              |   4 ++
 version.yaml                          |   1 +
 9 files changed, 157 insertions(+), 6 deletions(-)
 create mode 100644 docs/src/templates/app.yaml
 create mode 100644 docs/src/templates/favicon.ico
 create mode 100644 docs/src/templates/index.yaml

diff --git a/Rakefile b/Rakefile
index 9c18da9d..f887237b 100644
--- a/Rakefile
+++ b/Rakefile
@@ -19,12 +19,13 @@ task :init do
   v = YAML::load( File.open( 'version.yaml' ) )
   match = v['version'].match(/^([^-]*)(-snapshot)?$/)
 
-  NG_VERSION = Struct.new(:full, :major, :minor, :dot, :codename).
+  NG_VERSION = Struct.new(:full, :major, :minor, :dot, :codename, :stable).
                       new(match[1] + (match[2] ? ('-' + %x(git rev-parse HEAD)[0..7]) : ''),
                           match[1].split('.')[0],
                           match[1].split('.')[1],
                           match[1].split('.')[2].sub(/\D+.*$/, ''),
-                          v['codename'])
+                          v['codename'],
+                          v['stable'])
 end
 
 
@@ -115,6 +116,14 @@ task :docs => [:init] do
   rewrite_file(path_to('docs/.htaccess')) do |content|
     content.sub!('"NG_VERSION_FULL"', NG_VERSION.full)
   end
+  rewrite_file(path_to('docs/index.html')) do |content|
+    content.sub!('"NG_VERSION_FULL"', NG_VERSION.full).
+            sub!('"NG_VERSION_STABLE"', NG_VERSION.stable)
+  end
+  rewrite_file(path_to('docs/docs-scenario.html')) do |content|
+      content.sub!('"NG_VERSION_FULL"', NG_VERSION.full).
+              sub!('"NG_VERSION_STABLE"', NG_VERSION.stable)
+    end
 end
 
 
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'));
 }
 
 
diff --git a/docs/src/templates/app.yaml b/docs/src/templates/app.yaml
new file mode 100644
index 00000000..c204b150
--- /dev/null
+++ b/docs/src/templates/app.yaml
@@ -0,0 +1,66 @@
+application: docs-angularjs-org
+version: 1
+runtime: python27
+api_version: 1
+threadsafe: yes
+default_expiration: "2h"
+
+handlers:
+- url: /
+  static_files: index.html
+  upload: index.html
+
+- url: /appcache.manifest
+  static_files: appcache.manifest
+  upload: appcache\.manifest
+
+- url: /docs-scenario.html
+  static_files: docs-scenario.html
+  upload: docs-scenario\.html
+
+- url: /docs-scenario.js
+  static_files: docs-scenario.js
+  upload: docs-scenario\.js
+
+- url: /favicon\.ico
+  static_files: favicon.ico
+  upload: favicon\.ico
+
+- url: /robots.txt
+  static_files: robots.txt
+  upload: robots\.txt
+
+- url: /sitemap.xml
+  static_files: sitemap.xml
+  upload: sitemap\.xml
+
+- url: /css
+  static_dir: css
+
+- url: /font
+  static_dir: font
+
+- url: /img
+  static_dir: img
+
+- url: /js
+  static_dir: js
+
+- url: /partials/(.+):(.+)
+  static_files: partials/\1_\2
+  upload: partials/.*
+
+- url: /partials
+  static_dir: partials
+
+- url: /syntaxhighlighter
+  static_dir: syntaxhighlighter
+
+- url: /.*
+  static_files: index.html
+  upload: index.html
+
+
+libraries:
+- name: webapp2
+  version: "2.5.1"
diff --git a/docs/src/templates/docs-scenario.html b/docs/src/templates/docs-scenario.html
index 49b9bf89..f1816947 100644
--- a/docs/src/templates/docs-scenario.html
+++ b/docs/src/templates/docs-scenario.html
@@ -2,8 +2,43 @@
 <html xmlns:ng="http://angularjs.org">
 <head>
   <title>AngularJS Docs E2E Test Runner</title>
-  <script type="text/javascript" src="../angular-scenario.js" ng:autotest></script>
-  <script type="text/javascript" src="docs-scenario.js"></script>
+  <script>
+    var gae = (location.pathname.split('/').length == 2),
+        headEl = document.head,
+        angularVersion = {
+          current: '"NG_VERSION_FULL"', // rewrite during build
+          stable: '"NG_VERSION_STABLE"'
+        };
+
+    addTag('script', {src: path('angular-scenario.js')}, function() {
+      addTag('script', {src: 'docs-scenario.js'}, function() {
+        angular.scenario.setUpAndRun();
+      });
+    });
+
+    function addTag(name, attributes, callback) {
+      var el = document.createElement(name),
+          attrName;
+
+      for (attrName in attributes) {
+        el.setAttribute(attrName, attributes[attrName]);
+      }
+
+      if (callback) {
+        el.onload = callback;
+      }
+
+      headEl.appendChild(el);
+    }
+
+
+    function path(name) {
+      return gae
+          ? 'http://code.angularjs.org/' + angularVersion.stable + '/' +
+              name.replace(/\.js$/, '-' + angularVersion.stable + '.js')
+          : '../' + name;
+    }
+  </script>
 </head>
 <body>
 </body>
diff --git a/docs/src/templates/favicon.ico b/docs/src/templates/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..fe24a63a6ba4c4b4fb0e960abb60e51dc9097d43
GIT binary patch
literal 1150
zcmZuxZAep57(QaqUkSemBP}6IGixM-R$2;?eQEiH)}M%sFz|;4MNX|WiYN&)b(!;H
z6Y*nt*TibqTMgRG)HS!ek&a*=1<Q{unF`&#opWPz>h9&ehx^|5d7kq==bVdB5WYh~
z5Pn9Zl1&JOBZT5`;1tgM&*K3h{B8XO04Pv69FAiQqf%+L-x}R+cT}L7K)Hp5g#({H
zs)ujg7~xW4RgiVK6Q0-0+&Z1^>C)0tWFQR5EiNv`j*gB=t1D>k=&rAj6sm=NVV@x`
zw2hCPj4lwp82qEx>mRPHtc3aV7>%aNIw8HBkub*N2zEW5@azt2gMusxh+8R_*=)Y<
z<q$WkOo9k4NJTbier)k^`0K|<v_Z}7UMRcT0|$4Cfnh#O5Io0m!F81*ZlWi8VgaYq
z33+Mk2L0l5-9S+k<e!xA{k)bb<_I2pyS2Q8;Rrr6VG4dboS^9c38jVK;adJAU!QkE
z0-`1v?qA0DKzeCu9N@4ITV`ixQ?KNzd~@z<wt~y$;=^XM@tQ=J1nJ%D=YyI)z-zVN
zVzCtGrmKDUEP)>8=bRvJutLfX4G3b|p{YRzFR?!H&x@}p?E$;po?|kZ?qnve^}WB-
z4mRsN9Ew)M*>nl7U3gmR!xE0m1>G<`JzX|FKGB*SHR01IKAcZw@!XtnuR;$E^#jn_
zB7;5QtJ(ygeY^|so_h9fSglM7om_(_976-Yz&vAx!9fa&&aBlY_#=rOpwVb3X$NB#
zL~g_vWg3C__e!);o8Sd8VxX1ul+kDuzL7I*^-Y>1J_;gMx#WE_a1pONsV9-NO$>#n
zBv32t<%SgRXIPfK>)nHR-y~wL8ac%ns>*5ZLYf+~Q@=oRY&%@ak;0?<ecan&C2KGk
zYRMV%csv2mE#bpl@tCVxA*c09C9NZK#JRm*E&tIYL}+<CLO(Vm!~`Q$6%;u9{~J~K
Jh1CDW*nfR%q%Hse

literal 0
HcmV?d00001

diff --git a/docs/src/templates/index.html b/docs/src/templates/index.html
index 22642687..b16f44de 100644
--- a/docs/src/templates/index.html
+++ b/docs/src/templates/index.html
@@ -22,8 +22,13 @@
           baseUrl = location.href.replace(rUrl, indexFile),
           jQuery = /index-jq[^\.]*\.html$/.test(baseUrl),
           debug = /index[^\.]*-debug\.html$/.test(baseUrl),
+          gae = (baseUrl.split('/').length == 4),
           headEl = document.getElementsByTagName('head')[0],
-          sync = true;
+          sync = true,
+          angularVersion = {
+            current: '"NG_VERSION_FULL"', // rewrite during build
+            stable: '"NG_VERSION_STABLE"'
+          };
 
       addTag('base', {href: baseUrl});
       addTag('link', {rel: 'stylesheet', href: 'css/bootstrap.min.css', type: 'text/css'});
@@ -40,6 +45,20 @@
       addTag('script', {src: 'js/docs-keywords.js'}, sync);
 
       function path(name) {
+        if (gae) {
+          if (name.match(/^angular(-\w+)?\.js/) && !name.match(/bootstrap/)) {
+            name =  '//ajax.googleapis.com/ajax/libs/angularjs/' +
+                angularVersion.stable +
+                '/' +
+                name.replace(/\.js$/, '.min.js');
+          } else {
+            name =  'http://code.angularjs.org/' +
+                angularVersion.stable +
+                '/' +
+                name.replace(/\.js$/, '-' + angularVersion.stable +'.min.js');
+          }
+          return name;
+        }
         return '../' + name.replace(/\.js$/, debug ? '.js' : '.min.js');
       }
 
diff --git a/docs/src/templates/index.yaml b/docs/src/templates/index.yaml
new file mode 100644
index 00000000..8e6046de
--- /dev/null
+++ b/docs/src/templates/index.yaml
@@ -0,0 +1,12 @@
+indexes:
+
+# AUTOGENERATED
+
+# This index.yaml is automatically updated whenever the dev_appserver
+# detects that a new type of query is run.  If you want to manage the
+# index.yaml file manually, remove the above marker line (the line
+# saying "# AUTOGENERATED").  If you want to manage some indexes
+# manually, move them above the marker line.  The index.yaml file is
+# automatically uploaded to the admin console when you next deploy
+# your application using appcfg.py.
+
diff --git a/lib/nodeserver/server.js b/lib/nodeserver/server.js
index ab79c299..f4f9457a 100644
--- a/lib/nodeserver/server.js
+++ b/lib/nodeserver/server.js
@@ -108,6 +108,10 @@ StaticServlet.prototype.handleRequest = function(req, res) {
       path = path.replace(match[0], '/index.html');
       sys.puts('Rewrite to ' + path);
   }
+
+  // rewrite : to _ to be GAE-friendly
+  path = path.replace(':', '_');
+
   // end of docs rewriting
 
   fs.stat(path, function(err, stat) {
diff --git a/version.yaml b/version.yaml
index 78a77f5c..69eb6d7a 100644
--- a/version.yaml
+++ b/version.yaml
@@ -2,3 +2,4 @@
 ---
 version: 1.0.2-snapshot
 codename: debilitating-awesomeness
+stable: 1.0.1