feat(gen) add grunt-ngdoc

Add jsdoc to generated text and add grunt-ngdocs generated documentation to /docs. Add grunt-ngdocs to package.json & Gruntfile.js. Basic support in js templates. Watch for changes in js files & autoreload docs after regeneration. Init work at yeoman#550
marcin-wosinek · Jan 20, 2014 · 5564641 · 5564641
1 parent 605f3cb
commit 5564641
Show file tree

Hide file tree

Showing 12 changed files with 83 additions and 2 deletions.
diff --git a/templates/common/Gruntfile.js b/templates/common/Gruntfile.js
@@ -37,7 +37,7 @@ module.exports = function (grunt) {
       },<% } else { %>
       js: {
         files: ['<%%= yeoman.app %>/scripts/{,*/}*.js'],
-        tasks: ['newer:jshint:all'],
+        tasks: ['ngdocs', 'newer:jshint:all'],
         options: {
           livereload: true
         }
@@ -393,6 +393,13 @@ module.exports = function (grunt) {
         configFile: 'karma.conf.js',
         singleRun: true
       }
+    },
+    ngdocs: {
+      options: {
+        dest: '.tmp/docs',
+        html5Mode: false
+      },
+      api: ['<%%= yeoman.app %>/scripts/{,*/}*.js'],
     }
   });
 
@@ -407,6 +414,7 @@ module.exports = function (grunt) {
       'bower-install',
       'concurrent:server',
       'autoprefixer',
+      'ngdocs',
       'connect:livereload',
       'watch'
     ]);

diff --git a/templates/common/_package.json b/templates/common/_package.json
@@ -27,7 +27,8 @@
     "grunt-usemin": "~2.0.0",
     "jshint-stylish": "~0.1.3",
     "load-grunt-tasks": "~0.2.0",
-    "time-grunt": "~0.2.1"
+    "time-grunt": "~0.2.1",
+    "grunt-ngdocs": "~0.1.7"
   },
   "engines": {
     "node": ">=0.10.0"

diff --git a/templates/javascript/app.js b/templates/javascript/app.js
@@ -1,5 +1,13 @@
 'use strict';
 
+/**
+ * @ngdoc overview
+ * @name <%= scriptAppName %>
+ * @description
+ * # <%= scriptAppName %>
+ *
+ * Main module of the application.
+ */
 angular.module('<%= scriptAppName %>', [<%= angularModules %>])<% if (ngRoute) { %>
   .config(function ($routeProvider) {
     $routeProvider

diff --git a/templates/javascript/controller.js b/templates/javascript/controller.js
@@ -1,5 +1,12 @@
 'use strict';
 
+/**
+ * @ngdoc function
+ * @name <%= scriptAppName %>.controller:<%= classedName %>Ctrl
+ * @description
+ * # <%= classedName %>Ctrl
+ * Controller of the <%= scriptAppName %>
+ */
 angular.module('<%= scriptAppName %>')
   .controller('<%= classedName %>Ctrl', function ($scope) {
     $scope.awesomeThings = [

diff --git a/templates/javascript/decorator.js b/templates/javascript/decorator.js
@@ -1,5 +1,12 @@
 'use strict';
 
+/**
+ * @ngdoc function
+ * @name <%= scriptAppName %>.decorator:<%= classedName %>
+ * @description
+ * # <%= classedName %>Ctrl
+ * Decorator of the <%= scriptAppName %>
+ */
 angular.module('<%= scriptAppName %>')
     .config(function ($provide) {
         $provide.decorator('<%= cameledName %>', function ($delegate) {

diff --git a/templates/javascript/directive.js b/templates/javascript/directive.js
@@ -1,5 +1,12 @@
 'use strict';
 
+/**
+ * @ngdoc directive
+ * @name <%= scriptAppName %>.directive:<%= cameledName %>
+ * @description
+ * # <%= cameledName %>
+ * Directive to replace content with custom text.
+ */
 angular.module('<%= scriptAppName %>')
   .directive('<%= cameledName %>', function () {
     return {

diff --git a/templates/javascript/filter.js b/templates/javascript/filter.js
@@ -1,5 +1,13 @@
 'use strict';
 
+/**
+ * @ngdoc filter
+ * @name <%= scriptAppName %>.filter:<%= cameledName %>
+ * @function
+ * @description
+ * # <%= cameledName %>
+ * Filter to change your value.
+ */
 angular.module('<%= scriptAppName %>')
   .filter('<%= cameledName %>', function () {
     return function (input) {

diff --git a/templates/javascript/service/constant.js b/templates/javascript/service/constant.js
@@ -1,4 +1,11 @@
 'use strict';
 
+/**
+ * @ngdoc service
+ * @name <%= scriptAppName %>.<%= cameledName %>
+ * @description
+ * # <%= cameledName %>
+ * Constat in the <%= scriptAppName %>.
+ */
 angular.module('<%= scriptAppName %>')
   .constant('<%= cameledName %>', 42);
diff --git a/templates/javascript/service/factory.js b/templates/javascript/service/factory.js
@@ -1,5 +1,12 @@
 'use strict';
 
+/**
+ * @ngdoc service
+ * @name <%= scriptAppName %>.<%= cameledName %>
+ * @description
+ * # <%= cameledName %>
+ * Factory in the <%= scriptAppName %>.
+ */
 angular.module('<%= scriptAppName %>')
   .factory('<%= cameledName %>', function () {
     // Service logic

diff --git a/templates/javascript/service/provider.js b/templates/javascript/service/provider.js
@@ -1,5 +1,12 @@
 'use strict';
 
+/**
+ * @ngdoc service
+ * @name <%= scriptAppName %>.<%= cameledName %>
+ * @description
+ * # <%= cameledName %>
+ * Provider in the <%= scriptAppName %>.
+ */
 angular.module('<%= scriptAppName %>')
   .provider('<%= cameledName %>', function () {
 

diff --git a/templates/javascript/service/service.js b/templates/javascript/service/service.js
@@ -1,5 +1,12 @@
 'use strict';
 
+/**
+ * @ngdoc service
+ * @name <%= scriptAppName %>.<%= cameledName %>
+ * @description
+ * # <%= cameledName %>
+ * Service in the <%= scriptAppName %>.
+ */
 angular.module('<%= scriptAppName %>')
   .service('<%= classedName %>', function <%= classedName %>() {
     // AngularJS will instantiate a singleton by calling "new" on this function

diff --git a/templates/javascript/service/value.js b/templates/javascript/service/value.js
@@ -1,4 +1,11 @@
 'use strict';
 
+/**
+ * @ngdoc service
+ * @name <%= scriptAppName %>.<%= cameledName %>
+ * @description
+ * # <%= cameledName %>
+ * Value in the <%= scriptAppName %>.
+ */
 angular.module('<%= scriptAppName %>')
   .value('<%= cameledName %>', 42);