From 4a4b28dbf3af9a1871f00dfeded6da9eda557412 Mon Sep 17 00:00:00 2001 From: Igor Minar Date: Mon, 20 Aug 2012 08:28:04 -0700 Subject: 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 --- 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 +++++++ 6 files changed, 141 insertions(+), 4 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 (limited to 'docs') 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 @@ AngularJS Docs E2E Test Runner - - + diff --git a/docs/src/templates/favicon.ico b/docs/src/templates/favicon.ico new file mode 100644 index 00000000..fe24a63a Binary files /dev/null and b/docs/src/templates/favicon.ico differ diff --git a/docs/src/templates/index.html b/docs/src/templates/index.html index 4c6dc2cb..49a1beec 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. + -- cgit v1.2.3