site: support permalinks. fixes googleapis#184

Author: stephenplusplus

docs/components/docs/docs.html

@@ -48,12 +48,17 @@ <h1>{{module[0].toUpperCase() + module.substr(1)}}</h1>
       </article>
     </article>
 
-    <article ng-repeat="method in methods" id="{{method.name}}">
+    <article
+      ng-repeat="method in methods"
+      ng-hide="singleMethod && method.name !== singleMethod">
       <h2 ng-if="method.name[0].toUpperCase() === method.name[0]">
         {{method.name}}
       </h2>
       <h3 ng-if="method.name[0].toUpperCase() !== method.name[0]">
-        {{method.name}}
+        <a ng-if="!singleMethod" ng-href="{{activeUrl + '/' + method.name}}">
+          {{method.name}}
+        </a>
+        <span ng-if="singleMethod">{{method.name}}</span>
       </h3>
       <p ng-if="method.description" ng-bind-html="method.description"></p>
       <h4 ng-show="method.params">Parameters</h4>

docs/components/docs/docs.js

@@ -133,6 +133,30 @@ angular
                 .then(filterDocJson($sce));
           }
         }
+      })
+      .when('/docs/:module/:class/:method', {
+        controller: 'DocsCtrl',
+        templateUrl: '/gcloud-node/components/docs/docs.html',
+        resolve: {
+          methods: function($q, $http, $route, $sce, $location) {
+            var module = $route.current.params.module;
+            var cl = $route.current.params.class;
+            var method = $route.current.params.method;
+            return $http.get('/gcloud-node/json/' + module + '/' + cl + '.json')
+                .then(filterDocJson($sce))
+                .then(function(methods) {
+                  var methodExists = methods.some(function(methodObj) {
+                    return method === methodObj.name;
+                  });
+                  if (methodExists) {
+                    methods.singleMethod = method;
+                    return methods;
+                  } else {
+                    $location.path('/docs/' + module + '/' + cl);
+                  }
+                });
+          }
+        }
       });
   })
   .controller('DocsCtrl', function($location, $scope, $routeParams, methods) {
@@ -146,6 +170,8 @@ angular
       return doc.toLowerCase() === $routeParams.module;
     };
 
+    $scope.activeUrl = '/gcloud-node/#' + $location.path();
+    $scope.singleMethod = methods.singleMethod;
     $scope.methods = methods;
     $scope.module = $routeParams.module;
     $scope.pages = [

docs/home.js

@@ -7,4 +7,14 @@ angular
       .when('/', {
         templateUrl: '/gcloud-node/home.html'
       });
+  })
+  .run(function($rootScope, $location) {
+    $rootScope.$on('$routeChangeStart', function(event) {
+      var hash = $location.hash();
+      if (hash) {
+        event.preventDefault();
+        $location.hash('');
+        $location.replace().path($location.path() + '/' + hash);
+      }
+    });
   });