├── .bowerrc
├── .gitignore
├── .npmignore
├── LICENSE
├── README.md
├── index.js
├── package.json
├── spec
    ├── domSpec.js
    ├── fixtures
    │   ├── error
    │   │   └── foo.js
    │   └── watch
    │   │   ├── bar.js
    │   │   └── foo.js
    └── ngdocSpec.js
└── src
    ├── dom.js
    ├── example.js
    ├── ignore.words
    ├── ngdoc.js
    ├── reader.js
    └── templates
        ├── css
            ├── animations.css
            ├── bootstrap.min.css
            ├── doc_widgets.css
            ├── docs.css
            ├── font-awesome.css
            └── prettify.css
        ├── font
            ├── FontAwesome.otf
            ├── fontawesome-webfont.eot
            ├── fontawesome-webfont.svg
            ├── fontawesome-webfont.ttf
            └── fontawesome-webfont.woff
        ├── index.tmpl
        └── js
            ├── angular-bootstrap-prettify.js
            ├── angular-bootstrap.js
            ├── docs.js
            └── prettify.js


/.bowerrc:
--------------------------------------------------------------------------------
1 | {
2 | 	"directory": "bower_components"
3 | }


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # Directories
 2 | .DS_Store
 3 | .tmp
 4 | .idea
 5 | node_modules
 6 | bower_components
 7 | dist
 8 | coverage
 9 | test-reports
10 | build
11 | 
12 | # Files
13 | *.log
14 | 


--------------------------------------------------------------------------------
/.npmignore:
--------------------------------------------------------------------------------
 1 | # Directories
 2 | .DS_Store
 3 | .tmp
 4 | node_modules
 5 | bower_components
 6 | dist
 7 | coverage
 8 | test-reports
 9 | build
10 | spec
11 | 
12 | # Files
13 | *.log
14 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) 2014 nikhilmodak
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 
23 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | gulp-ngdocs
  2 | ===========
  3 | 
  4 | Gulp plugin for building [AngularJS](http://docs.angularjs.org) like documentation. This is inspired from [grunt-ngdocs](https://www.npmjs.org/package/grunt-ngdocs).
  5 | 
  6 | ##Setup
  7 | 
  8 | `npm install gulp-ngdocs --save-dev`
  9 | 
 10 | ##Usage
 11 | 
 12 | Create a `ngdocs` gulp task
 13 | 
 14 | ```js
 15 | gulp.task('ngdocs', [], function () {
 16 |   var gulpDocs = require('gulp-ngdocs');
 17 |   return gulp.src('path/to/src/*.js')
 18 |     .pipe(gulpDocs.process())
 19 |     .pipe(gulp.dest('./docs'));
 20 | });
 21 | ```
 22 | Create a `ngdocs` gulp task with options
 23 | 
 24 | ```js
 25 | gulp.task('ngdocs', [], function () {
 26 |   var gulpDocs = require('gulp-ngdocs');
 27 |   var options = {
 28 |     scripts: ['../app.min.js'],
 29 |     html5Mode: true,
 30 |     startPage: '/api',
 31 |     title: "My Awesome Docs",
 32 |     image: "path/to/my/image.png",
 33 |     imageLink: "http://my-domain.com",
 34 |     titleLink: "/api"
 35 |   }
 36 |   return gulp.src('path/to/src/*.js')
 37 |     .pipe(gulpDocs.process(options))
 38 |     .pipe(gulp.dest('./docs'));
 39 | });
 40 | ```
 41 | 
 42 | To use a different AngularJS version pass `angular` and `angular-animate` files in scripts.
 43 | 
 44 | ```js
 45 | gulp.task('ngdocs', [], function () {
 46 |   var gulpDocs = require('gulp-ngdocs');
 47 |   var options = {
 48 |     /* pass both .min.js and .min.js.map files for angular and angular-animate */
 49 |     scripts: [
 50 |       'bower_components/angular/angular.min.js',
 51 |       'bower_components/angular/angular.min.js.map',
 52 |       'bower_components/angular-animate/angular-animate.min.js',
 53 |       'bower_components/angular-animate/angular-animate.min.js.map'
 54 |     ]
 55 |   }
 56 | 
 57 |   /*
 58 |   If you choose to use the remote links pass in the .min.js links for angular and angular-animate
 59 | 
 60 |   var options = {
 61 |     scripts: [
 62 |       'http://ajax.googleapis.com/ajax/libs/angularjs/<version>/angular.min.js',
 63 |       'http://ajax.googleapis.com/ajax/libs/angularjs/<version>/angular-animate.min.js'
 64 |     ]
 65 |   }
 66 |   */
 67 |   return gulp.src('path/to/src/*.js')
 68 |     .pipe(gulpDocs.process(options))
 69 |     .pipe(gulp.dest('./docs'));
 70 | });
 71 | ```
 72 | 
 73 | If you would like to divide your documentation into different sections, use `gulpDocs.sections` instead of `gulp.src`.
 74 | 
 75 | ```js
 76 | gulp.task('ngdocs', [], function () {
 77 |   var gulpDocs = require('gulp-ngdocs');
 78 |   var options = {
 79 |     //options
 80 |   }
 81 |   return gulpDocs.sections({
 82 |     api: {
 83 |       glob:['src/**/*.js', '!src/**/*.spec.js'],
 84 |       api: true,
 85 |       title: 'API Documentation'
 86 |     },
 87 |     tutorial: {
 88 |       glob: ['content/tutorial/*.ngdoc'],
 89 |       title: 'Tutorial'
 90 |     }
 91 |   }).pipe(gulpDocs.process(options)).pipe(gulp.dest('./docs'));
 92 | });
 93 | ```
 94 | #### Serving index.html file
 95 | 
 96 | Opening *index.html* file via **file://** protocol will cause a number of troubles.
 97 | The easier way to avoid it is to run local server.
 98 | As an options you can use [gulp-connect](https://www.npmjs.com/package/gulp-connect)
 99 | ```
100 | npm install gulp-connect
101 | ```
102 | 
103 | ```
104 | gulp.task('connect_ngdocs', function() {
105 | var connect = require('gulp-connect');
106 |   connect.server({
107 |     root: 'docs',
108 |     livereload: false,
109 |     fallback: 'docs/index.html',
110 |     port: 8083
111 |   });
112 | });
113 | ```
114 | 
115 | ###Doc comment example
116 | 
117 | A doc comment looks like this:
118 | ```js
119 | /**
120 |  * @ngdoc directive
121 |  * @name rfx.directive:rAutogrow
122 |  * @element textarea
123 |  * @function
124 |  *
125 |  * @description
126 |  * Resize textarea automatically to the size of its text content.
127 |  *
128 |  * **Note:** ie<9 needs polyfill for window.getComputedStyle
129 |  *
130 |  * @example
131 |    <example module="rfx">
132 |      <file name="index.html">
133 |          <textarea ng-model="text"rx-autogrow class="input-block-level"></textarea>
134 |          <pre>{{text}}</pre>
135 |      </file>
136 |    </example>
137 |  */
138 | angular.module('rfx', []).directive('rAutogrow', function() {
139 |   //some nice code
140 | });
141 | ```
142 | 
143 | Check out the [Writing AngularJS documentation wiki article](https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation) to see what's possible,
144 | or take a look at the [AngularJS source code](https://github.com/angular/angular.js/tree/master/src/ng) for more examples.
145 | 
146 | ##Options
147 | 
148 | ####scripts
149 | Set additional custom JS files are loaded to the app. This allows the live examples to use custom directives, services, etc. The documentation app works with AngularJS 1.2+ and 1.3+. If you include a different version of AngularJS, make sure to include angular-animate.js as well.
150 | 
151 | Possible values:
152 | 
153 |   - `['path/to/file.js']` file will be copied into the docs, into a `js` folder
154 |   - `['http://example.com/file.js', 'https://example.com/file.js', '//example.com/file.js']` reference remote files (eg from a CDN)
155 |   - `['../app.js']` reference file relative to the dest folder
156 | 
157 | ####styles
158 | [default] `[]`
159 | Copy additional css files to the documentation app
160 | 
161 | ####analytics
162 | Optional include Google Analytics in the documentation app.
163 | 
164 | Example usage:
165 | 
166 | ```js
167 | var opts = {
168 |   analytics: {
169 |     account: 'UA-XXXXXX-YY',
170 |     domainName: 'http://mywebpage.com/'
171 |   }
172 | };
173 | ```
174 | 
175 | ####discussions
176 | Optional include [discussions](http://disqus.com) in the documentation app.
177 | 
178 | ####editExample
179 | [default] `true`
180 | Show Edit Button for examples.
181 | 
182 | ####title
183 | [default] `"API Documentation"`
184 | Title to put on the navbar and the page's `title` attribute.
185 | 
186 | ####startPage
187 | [default] `'/api'`
188 | Set first page to open.
189 | 
190 | ####html5Mode
191 | [default] `true`
192 | Whether or not to enable `html5Mode` in the docs application.  If true, then links will be absolute.  If false, they will be prefixed by `#/`.
193 | 
194 | ####image
195 | A URL or relative path to an image file to use in the top navbar.
196 | 
197 | ####titleLink
198 | [default] no anchor tag is used
199 | Wraps the title text in an anchor tag with the provided URL.
200 | 
201 | ####imageLink
202 | [default] no anchor tag is used
203 | Wraps the navbar image in an anchor tag with the provided URL.
204 | 
205 | ####bestMatch
206 | [default] `false`
207 | The best matching page for a search query is highlighted and get selected on return.
208 | If this option is set to true the best match is shown below the search field in an dropdown menu. Use this for long lists where the highlight is often not visible.
209 | 
210 | ####navTemplate
211 | [default] `null`
212 | Path to a template of a nav HTML template to include.  The css for it
213 | should be that of listitems inside a bootstrap navbar:
214 | ```html
215 | <header class="header">
216 |   <div class="navbar">
217 |     <ul class="nav">
218 |       {{links to all the docs pages}}
219 |     </ul>
220 |     {{YOUR_NAV_TEMPLATE_GOES_HERE}}
221 |   </div>
222 | </header>
223 | ```
224 | Example: 'templates/my-nav.html'
225 | 
226 | The template, if specified, is pre-processed using [_.template](http://lodash.com/docs#template).
227 | 
228 | ####loadDefaults
229 | Use this option to disable any of the four scripts `angular`, `angularAnimate`, `marked`, and `prettify` (google) which are loaded by default. This would give the user the ability to disable any scripts if they are using methods outside of regular angular/animate loading like browserify.
230 | 
231 | Example usage:
232 | ```js
233 | var opts = {
234 |   loadDefaults: {
235 |     angularAnimate: false
236 |   }
237 | }
238 | ```
239 | 
240 | ##Options for Sections
241 | 
242 | ####glob
243 | 
244 | [required] glob pattern of files to parse for documentation comments.
245 | 
246 | ###title
247 | 
248 | [default] name of the section. Set the title for the section in the documentation app.
249 | 
250 | ###api
251 | 
252 | [default] `true` Set the name for the section in the documentation app.
253 | 


--------------------------------------------------------------------------------
/index.js:
--------------------------------------------------------------------------------
  1 | 'use strict';
  2 | 
  3 | var dom = require('./src/dom');
  4 | var ngdoc = require('./src/ngdoc');
  5 | var reader = require('./src/reader');
  6 | 
  7 | var fs = require('fs');
  8 | var vfs = require('vinyl-fs');
  9 | var through2 = require('through2');
 10 | var extend = require('extend');
 11 | var _ = require('lodash');
 12 | var gutil = require('gulp-util');
 13 | var File = gutil.File;
 14 | var PluginError = gutil.PluginError;
 15 | var path = require('canonical-path');
 16 | var StringDecoder = require('string_decoder').StringDecoder;
 17 | var decoder = new StringDecoder('utf8');
 18 | var merge = require('merge-stream');
 19 | 
 20 | var setup = {sections: {}, pages: [], apis: {}};
 21 | var fakeDest = '_FAKE_DEST_';
 22 | var templates = path.resolve(__dirname, 'src/templates');
 23 | var nodeModules = path.resolve(__dirname, 'node_modules');
 24 | var flattenedNodeModules = path.resolve(__dirname, '../');
 25 | 
 26 | function copyTemplates() {
 27 |   return function () {
 28 |     return vfs.src(['**/*', '!**/*.tmpl'], {cwd: templates});
 29 |   };
 30 | }
 31 | 
 32 | function streamFile(src, dir, dest, name) {
 33 |   return function () {
 34 |     return vfs.src(src).pipe(through2.obj(function (file, enc, callback) {
 35 |       name = name === undefined ? path.normalize(file.path).split('/').pop() : name;
 36 |       this.push(new File({
 37 |         base: dest,
 38 |         cwd: dest,
 39 |         path: path.join(dest, dir, name),
 40 |         contents: file.contents
 41 |       }));
 42 |       callback(null);
 43 |     }));
 44 |   };
 45 | }
 46 | 
 47 | function sections(sects) {
 48 |   return merge(_.map(sects, function (data, key) {
 49 |     if (data instanceof String) {
 50 |       data = {glob: data};
 51 |     }
 52 |     if (!data.hasOwnProperty('glob')) {
 53 |       throw new PluginError('gulp-ngdocs', 'Invalid sections, please refer to the documentation.');
 54 |     }
 55 |     if (!data.hasOwnProperty('title')) {
 56 |       data.title = key;
 57 |     }
 58 |     if (!data.hasOwnProperty('api')) {
 59 |       data.api = true;
 60 |     }
 61 |     var glob = data.glob;
 62 |     var opts = data.globOpts;
 63 |     setup.sections[key] = data.title;
 64 |     setup.apis[key] = data.api;
 65 |     return vfs.src(glob, opts)
 66 |       .pipe(through2.obj(
 67 |         function (file, enc, cb) {
 68 |           file.section = key;
 69 |           this.push(file);
 70 |           cb(null);
 71 |         }
 72 |       ));
 73 |     }));
 74 | }
 75 | 
 76 | function processDoc(opts) {
 77 |   opts = opts || {};
 78 | 
 79 |   var options = extend({
 80 |     startPage: '/api',
 81 |     scripts: [],
 82 |     styles: [],
 83 |     title: 'API Documentation',
 84 |     html5Mode: true,
 85 |     editExample: true,
 86 |     navTemplate: false,
 87 |     navContent: '',
 88 |     navTemplateData: {}
 89 |   }, opts);
 90 | 
 91 |   setup.pages = [];
 92 |   //Extend loadDefaults
 93 |   options.loadDefaults = extend({
 94 |       angular: true,
 95 |       angularAnimate: true,
 96 |       marked: true
 97 |     }, opts.loadDefaults);
 98 | 
 99 |   if (options.scripts && !(options.scripts instanceof Array)) {
100 |     options.scripts = [options.scripts];
101 |   }
102 |   if (options.styles && !(options.styles instanceof Array)) {
103 |     options.styles = [options.styles];
104 |   }
105 |   var defaultSection = 'api';
106 |   var defaultScripts = [];
107 | 
108 |   //Default root paths for scripts
109 |   var scriptPaths = {
110 |     angular : [
111 |       'angular/angular.min.js',
112 |       'angular/angular.min.js.map'
113 |     ],
114 |     angularAnimate: [
115 |       'angular-animate/angular-animate.min.js',
116 |       'angular-animate/angular-animate.min.js.map'
117 |     ],
118 |     marked: [
119 |       'marked/lib/marked.js'
120 |     ]
121 |   };
122 | 
123 |   //Sets default script paths
124 |   function joinNodeModules(jsPaths){
125 |     _.each(jsPaths, function(jsPath){
126 |       var libPath = path.join(nodeModules, jsPath),
127 |           flattenedLibPath = path.join(flattenedNodeModules, jsPath);
128 | 
129 |       if (fs.existsSync(libPath)) {
130 |         defaultScripts.push(libPath);
131 |       } else if (fs.existsSync(flattenedLibPath)) {
132 |         defaultScripts.push(flattenedLibPath);
133 |       } else {
134 |         console.error('Could not find ' + jsPath);
135 |       }
136 |     });
137 |   }
138 |   //Iterate and checks to join paths
139 |   _.each(scriptPaths, function(paths, key){
140 |     if(options.loadDefaults[key])
141 |       joinNodeModules(paths);
142 |   });
143 | 
144 |   function writeSetup() {
145 |     var options = setup.__options,
146 |         content, data = {
147 |           scripts: options.scripts,
148 |           styles: options.styles,
149 |           sections: _.keys(setup.sections).join('|'),
150 |           discussions: options.discussions,
151 |           analytics: options.analytics,
152 |           navContent: options.navContent,
153 |           title: options.title,
154 |           image: options.image,
155 |           titleLink: options.titleLink,
156 |           imageLink: options.imageLink,
157 |           bestMatch: options.bestMatch,
158 |           deferLoad: !!options.deferLoad
159 |         };
160 | 
161 |     // create index.html
162 |     var index = path.resolve(templates, 'index.tmpl');
163 |     if (options.template && path.resolve(options.template)) {
164 |       index = options.template;
165 |     }
166 |     content = fs.readFileSync(index, 'utf8');
167 |     content = _.template(content, data);
168 |     docsStream.push(new File({
169 |       base: fakeDest,
170 |       cwd: fakeDest,
171 |       path: path.join(fakeDest, 'index.html'),
172 |       contents: new Buffer(content, 'utf8')
173 |     }));
174 |     // create setup file
175 |     setup.html5Mode = options.html5Mode;
176 |     setup.editExample = options.editExample;
177 |     setup.startPage = options.startPage;
178 |     setup.discussions = options.discussions;
179 |     setup.scripts = options.scripts;
180 |     docsStream.push(new File({
181 |       base: fakeDest,
182 |       cwd: fakeDest,
183 |       path: setup.__file,
184 |       contents: new Buffer('NG_DOCS=' + JSON.stringify(setup, null, 2) + ';', 'utf8')
185 |     }));
186 |   }
187 | 
188 |   function transformFunction (file, enc, callback) {
189 |     if (file.isNull()) {
190 |       callback(null);
191 |       return; // ignore
192 |     }
193 |     if (file.isStream()) {
194 |       callback(new gutil.PluginError('gulp-ngdocs', 'Streaming not supported'));
195 |       return;
196 |     }
197 |     if (file.contents) {
198 |       if (!merged) {
199 |         merged = merge(fstreams.map(function (f) {
200 |           var s = f();
201 |           s.on('data', function (file) {
202 |             docsStream.push(file);
203 |           });
204 |           return s;
205 |         }));
206 | 
207 |         merged.on('end', function () {
208 |           mergedEnded = true;
209 |           if (docsStreamEndCb) {
210 |             docsStreamEndCb(null);
211 |           }
212 |         });
213 |       }
214 |       var content = decoder.write(file.contents);
215 |       if (!file.section) {
216 |         file.section = defaultSection;
217 |       }
218 |       reader.process(content, file.path, file.section, options);
219 |     }
220 |     callback(null);
221 |   }
222 | 
223 |   function flushFunction (cb) {
224 |     if (merged) {
225 |       docsStreamEndCb = cb;
226 |       // IMPORTANT: If you do not want an error here to destroy a gulp watch,
227 |       // see: http://stackoverflow.com/questions/23971388/prevent-errors-from-breaking-crashing-gulp-watch
228 |       try{
229 |         ngdoc.merge(reader.docs);
230 |         reader.docs.forEach(function(doc){
231 |           try {
232 |             // this hack is here because on OSX angular.module and angular.Module map to the same file.
233 |             var id = doc.id.replace('angular.Module', 'angular.IModule').replace(':', '.'),
234 |                 file = path.join(fakeDest, 'partials', doc.section, id + '.html'),
235 |                 dir = path.join(fakeDest, 'partials', doc.section);
236 |             docsStream.push(new File({
237 |               base: fakeDest,
238 |               cwd: fakeDest,
239 |               path: file,
240 |               contents: new Buffer(doc.html(), 'utf8')
241 |             }));
242 |           } catch (docError) {
243 |             var cause = docError.name + ': ' + docError.message,
244 |                 placement = doc.file + ':' + doc.line,
245 |                 message = cause + ' at ' + placement;
246 |             throw new Error(message);
247 |           }
248 |         });
249 | 
250 |         ngdoc.checkBrokenLinks(reader.docs, setup.apis, options);
251 | 
252 |         setup.pages = _.union(setup.pages, ngdoc.metadata(reader.docs));
253 |       } catch (flushError) {
254 |         console.log(flushError);
255 |         cb(flushError);
256 |       }
257 |       writeSetup(this);
258 | 
259 |       if (mergedEnded) {
260 |         docsStreamEndCb(null);
261 |         docsStreamEndCb = false;
262 |       }
263 |     } else {
264 |       cb(null);
265 |     }
266 |   }
267 | 
268 |   var fstreams = [];
269 |   var docsStream = through2.obj(transformFunction, flushFunction);
270 |   var merged = false;
271 |   var mergedEnded = false;
272 |   var docsStreamEndCb = false;
273 |   if (options.navTemplate) {
274 |     options.navContent = _.template(
275 |       fs.readFileSync(options.navTemplate, 'utf8'),
276 |       options.navTemplateData);
277 |   }
278 | 
279 |   if (options.image) {
280 |     if (!/^((https?:)?\/\/|\.\.\/)/.test(options.image)) {
281 |       fstreams.push(streamFile(options.image, 'img', fakeDest));
282 |       options.image = 'img/' + path.basename(options.image);
283 |     }
284 |   }
285 | 
286 |   var scriptNames = [];
287 |   options.scripts = _.map(options.scripts, function (file) {
288 |     var fileName = path.normalize(file);
289 |     scriptNames.push(fileName);
290 |     if (/^((https?:)?\/\/)/.test(file)) {
291 |       return file;
292 |     } else {
293 |       fstreams.push(streamFile(file, path.join('js', path.dirname(fileName)), fakeDest));
294 |       return path.join('js', fileName);
295 |     }
296 |   });
297 | 
298 |   _.forEach(defaultScripts, function (script, i) {
299 |     var fileName = path.normalize(script).split('/').pop();
300 |     if (scriptNames.indexOf(fileName) === -1) {
301 |       fstreams.push(streamFile(script, 'js', fakeDest));
302 |       options.scripts.splice(i, 0, path.join('js', fileName));
303 |     }
304 |   });
305 | 
306 |   //Filter the maps
307 |   options.scripts = _.filter(options.scripts, function (file) {
308 |     return !(/^.*\.map$/.test(file));
309 |   });
310 | 
311 |   options.styles = _.map(options.styles, function(file) {
312 |       var fileName = path.normalize(file);
313 |     if (/^((https?:)?\/\/)/.test(file)) {
314 |       return file;
315 |     } else {
316 |       fstreams.push(streamFile(file, path.join('css', path.dirname(fileName)), fakeDest));
317 |       return path.join('css', fileName);
318 |     }
319 |   });
320 | 
321 |   fstreams.push(copyTemplates(templates));
322 |   setup.__file = path.join(fakeDest, 'js/docs-setup.js');
323 |   setup.__options = options;
324 | 
325 |   reader.docs = [];
326 |   if (Object.keys(setup.sections).length === 0) {
327 |     setup.sections[defaultSection] = options.title;
328 |     setup.apis[defaultSection] = true;
329 |   }
330 | 
331 |   return docsStream;
332 | }
333 | 
334 | module.exports = {
335 |   process: processDoc,
336 |   sections: sections
337 | };
338 | 


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "gulp-ngdocs",
 3 |   "version": "0.2.13",
 4 |   "author": "nikhilmodak",
 5 |   "description": "gulp plugin for angularjs documentation",
 6 |   "main": "index",
 7 |   "repository": {
 8 |     "type": "git",
 9 |     "url": "https://github.com/nikhilmodak/gulp-ngdocs.git"
10 |   },
11 |   "keywords": [
12 |     "gulpplugin",
13 |     "angular",
14 |     "gulp",
15 |     "ngdocs",
16 |     "documention"
17 |   ],
18 |   "license": "MIT",
19 |   "readmeFilename": "README.md",
20 |   "dependencies": {
21 |     "angular": "~1.3.1",
22 |     "angular-animate": "~1.3.1",
23 |     "canonical-path": "0.0.2",
24 |     "extend": "1.3.0",
25 |     "gulp-util": "3.0.0",
26 |     "lodash": "2.4.1",
27 |     "marked": "0.3.2",
28 |     "merge-stream": "0.1.5",
29 |     "path": "0.4.9",
30 |     "string_decoder": "0.10.31",
31 |     "through2": "0.6.1",
32 |     "vinyl-fs": "0.3.7"
33 |   },
34 |   "devDependencies": {
35 |     "del": "^1.1.1",
36 |     "gulp": "^3.8.10",
37 |     "jasmine-node": "^1.14.5"
38 |   },
39 |   "scripts": {
40 |     "test": "jasmine-node --color spec"
41 |   }
42 | }
43 | 


--------------------------------------------------------------------------------
/spec/domSpec.js:
--------------------------------------------------------------------------------
  1 | var DOM = require('../src/dom.js').DOM;
  2 | var normalizeHeaderToId = require('../src/dom.js').normalizeHeaderToId;
  3 | 
  4 | describe('dom', function() {
  5 |   var dom;
  6 | 
  7 |   beforeEach(function() {
  8 |     dom = new DOM();
  9 |   });
 10 | 
 11 |   describe('html', function() {
 12 |     it('should add ids to all h tags', function() {
 13 |       dom.html('<h1>Some Header</h1>');
 14 |       expect(dom.toString()).toContain('<h1 id="some-header">Some Header</h1>');
 15 |     });
 16 | 
 17 |     it('should collect <a name> anchors too', function() {
 18 |       dom.html('<h2>Xxx <a name="foo"></a> and bar <a name="bar"></a>');
 19 |       expect(dom.anchors).toContain('foo');
 20 |       expect(dom.anchors).toContain('bar');
 21 |     })
 22 |   });
 23 | 
 24 |   it('should collect h tag ids', function() {
 25 |     dom.h('Page Title', function() {
 26 |       dom.html('<h1>Second</h1>xxx <h2>Third</h2>');
 27 |       dom.h('Another Header', function() {});
 28 |     });
 29 | 
 30 |     expect(dom.anchors).toContain('page-title');
 31 |     expect(dom.anchors).toContain('second');
 32 |     expect(dom.anchors).toContain('second_third');
 33 |     expect(dom.anchors).toContain('another-header');
 34 |   });
 35 | 
 36 |   describe('h', function() {
 37 | 
 38 |     it('should render using function', function() {
 39 |       var cbThis;
 40 |       var cdValue;
 41 |       dom.h('heading', 'content', function(value){
 42 |         cbThis = this;
 43 |         cbValue = value;
 44 |       });
 45 |       expect(cbThis).toEqual(dom);
 46 |       expect(cbValue).toEqual('content');
 47 |     });
 48 | 
 49 |     it('should update heading numbers', function() {
 50 |       dom.h('heading', function() {
 51 |         this.html('<h1>sub-heading</h1>');
 52 |       });
 53 |       expect(dom.toString()).toContain('<h1 id="heading">heading</h1>');
 54 |       expect(dom.toString()).toContain('<h2 id="sub-heading">sub-heading</h2>');
 55 |     });
 56 | 
 57 |     it('should properly number nested headings', function() {
 58 |       dom.h('heading', function() {
 59 |         dom.h('heading2', function() {
 60 |           this.html('<h1>heading3</h1>');
 61 |         });
 62 |       });
 63 |       dom.h('other1', function() {
 64 |         this.html('<h1>other2</h1>');
 65 |       });
 66 | 
 67 |       expect(dom.toString()).toContain('<h1 id="heading">heading</h1>');
 68 |       expect(dom.toString()).toContain('<h2 id="heading2">heading2</h2>');
 69 |       expect(dom.toString()).toContain('<h3 id="heading2_heading3">heading3</h3>');
 70 | 
 71 |       expect(dom.toString()).toContain('<h1 id="other1">other1</h1>');
 72 |       expect(dom.toString()).toContain('<h2 id="other2">other2</h2>');
 73 |     });
 74 | 
 75 | 
 76 |     it('should add nested ids to all h tags', function() {
 77 |       dom.h('Page Title', function() {
 78 |         dom.h('Second', function() {
 79 |           dom.html('some <h1>Third</h1>');
 80 |         });
 81 |       });
 82 | 
 83 |       var resultingHtml = dom.toString();
 84 |       expect(resultingHtml).toContain('<h1 id="page-title">Page Title</h1>');
 85 |       expect(resultingHtml).toContain('<h2 id="second">Second</h2>');
 86 |       expect(resultingHtml).toContain('<h3 id="second_third">Third</h3>');
 87 |     });
 88 | 
 89 |   });
 90 | 
 91 | 
 92 |   describe('normalizeHeaderToId', function() {
 93 |     it('should ignore content in the parenthesis', function() {
 94 |       expect(normalizeHeaderToId('One (more)')).toBe('one');
 95 |     });
 96 | 
 97 |     it('should ignore html content', function() {
 98 |       expect(normalizeHeaderToId('Section <a name="section"></a>')).toBe('section');
 99 |     });
100 | 
101 |     it('should ignore special characters', function() {
102 |       expect(normalizeHeaderToId('Section \'!?')).toBe('section');
103 |     });
104 | 
105 |     it('should ignore html entities', function() {
106 |       expect(normalizeHeaderToId('angular&#39;s-jqlite')).toBe('angulars-jqlite');
107 |     });
108 |   });
109 | 
110 | });
111 | 


--------------------------------------------------------------------------------
/spec/fixtures/error/foo.js:
--------------------------------------------------------------------------------
 1 | 'use strict';
 2 | 
 3 | /**
 4 |   * @ngdoc servicesdfasdf
 5 |   * @name foo
 6 |   * @description Malformed docblock
 7 | **/
 8 | angular.module('foo', [])
 9 | .factory('foo', function() {
10 |   return {};
11 | });


--------------------------------------------------------------------------------
/spec/fixtures/watch/bar.js:
--------------------------------------------------------------------------------
 1 | 'use strict';
 2 | 
 3 | angular.module('my.services', [])
 4 | 
 5 | /**
 6 |   * @ngdoc service
 7 |   * @name my.services.bar
 8 |   * @requires other
 9 | **/
10 | .service('bar', function() {
11 |   this.baz = function() {
12 |     console.log('boop');
13 |   }
14 | });


--------------------------------------------------------------------------------
/spec/fixtures/watch/foo.js:
--------------------------------------------------------------------------------
 1 | 'use strict';
 2 | 
 3 | angular.module('my.directives', [])
 4 | 
 5 | /**
 6 |   * @ngdoc directive
 7 |   * @name my.directives.directive:foo
 8 |   * @restrict E
 9 |   * @description A custom element-directive that does nothing in particular
10 |   * @param {Object} bar An argument that does nothing in particular.
11 |   * @example 
12 | **/ 
13 | .directive('foo', function() {
14 |   return {
15 |     scope: {
16 |       bar: '='
17 |     }
18 |   };
19 | });


--------------------------------------------------------------------------------
/spec/ngdocSpec.js:
--------------------------------------------------------------------------------
  1 | var ngdoc = require('../src/ngdoc.js');
  2 | var DOM = require('../src/dom.js').DOM;
  3 | var index = require('../index');
  4 | var gulp = require('gulp');
  5 | var merge = require('merge-stream');
  6 | var fs = require('fs');
  7 | var del = require('del');
  8 | 
  9 | // Location for temporary test files
 10 | var tmpTestFiles = './tmp-test-files';
 11 | 
 12 | describe('ngdoc', function() {
 13 |   var Doc = ngdoc.Doc;
 14 |   var dom;
 15 | 
 16 |   beforeEach(function() {
 17 |     dom = new DOM();
 18 |     this.addMatchers({
 19 |       toContain: function(text) {
 20 |         this.actual = this.actual.toString();
 21 |         return this.actual.indexOf(text) > -1;
 22 |       }
 23 |     });
 24 | 
 25 |     try {
 26 |       del.sync([tmpTestFiles])
 27 |     } catch(e) {
 28 | 
 29 |     }
 30 |   });
 31 | 
 32 |   afterEach(function() {
 33 |     del.sync([tmpTestFiles])
 34 |   });
 35 | 
 36 |   describe('Doc', function() {
 37 |     describe('metadata', function() {
 38 | 
 39 |       it('should find keywords and filter ignored words', function() {
 40 |         expect(new Doc('\nHello: World! @ignore. $abc').keywords()).toEqual('$abc hello world');
 41 |         expect(new Doc('The `ng:class-odd` and').keywords()).toEqual('ng:class-odd');
 42 |       });
 43 | 
 44 |       it('should get property and methods', function() {
 45 |         var doc = new Doc('Document');
 46 |         doc.properties.push(new Doc('Proprety'));
 47 |         doc.properties.push(new Doc('Method'));
 48 |         expect(doc.keywords()).toEqual('document method proprety');
 49 |       });
 50 | 
 51 |       it('should have shortName', function() {
 52 |         var d1 = new Doc('@name a.b.c').parse();
 53 |         var d2 = new Doc('@name a.b.ng-c').parse();
 54 |         var d3 = new Doc('@name some text: more text').parse();
 55 |         expect(ngdoc.metadata([d1])[0].shortName).toEqual('a.b.c');
 56 |         expect(ngdoc.metadata([d2])[0].shortName).toEqual('a.b.ng-c');
 57 |         expect(ngdoc.metadata([d3])[0].shortName).toEqual('more text');
 58 |       });
 59 | 
 60 |       it('should support module names with dots', function() {
 61 |         var d1 = new Doc('@name a.b.c').parse();
 62 |         var d2 = new Doc('@name a.b.ng-c').parse();
 63 |         var d3 = new Doc('@name some.more.text: more text').parse();
 64 |         expect(ngdoc.metadata([d1])[0].moduleName).toEqual('a.b');
 65 |         expect(ngdoc.metadata([d2])[0].moduleName).toEqual('a.b');
 66 |         expect(ngdoc.metadata([d3])[0].moduleName).toEqual('some.more');
 67 |       });
 68 | 
 69 |       it('should allow to overwrite module name', function() {
 70 |         var d1 = new Doc('@name a.b.c').parse();
 71 |         var d2 = new Doc('@name a.b.c\n@module d.e.f').parse();
 72 |         expect(ngdoc.metadata([d1])[0].moduleName).toEqual('a.b');
 73 |         expect(ngdoc.metadata([d2])[0].shortName).toEqual('a.b.c');
 74 |         expect(ngdoc.metadata([d2])[0].moduleName).toEqual('d.e.f');
 75 |       });
 76 |     });
 77 | 
 78 |     describe('parse', function() {
 79 |       it('should convert @names into properties', function() {
 80 |         var doc = new Doc('\n@name name\n@desc\ndesc\ndesc2\n@dep\n');
 81 |         doc.parse();
 82 |         expect(doc.name).toEqual('name');
 83 |         expect(doc.desc).toEqual('desc\ndesc2');
 84 |         expect(doc.dep).toEqual('');
 85 |       });
 86 | 
 87 |       it('should parse parameters', function() {
 88 |         var doc = new Doc(
 89 |             '@name a\n' +
 90 |             '@param {*} a short\n' +
 91 |             '@param {Type} b med\n' +
 92 |             '@param {Class=} [c=2] long\nline\n' +
 93 |             '@param {function(number, string=)} d fn with optional arguments');
 94 |         doc.parse();
 95 |         expect(doc.param).toEqual([
 96 |            {name:'a', description:'<div class="a-page"><p>short</p>\n</div>', type:'*', optional:false, 'default':undefined},
 97 |            {name:'b', description:'<div class="a-page"><p>med</p>\n</div>', type:'Type', optional:false, 'default':undefined},
 98 |            {name:'c', description:'<div class="a-page"><p>long\nline</p>\n</div>', type:'Class', optional:true, 'default':'2'},
 99 |            {name:'d', description:'<div class="a-page"><p>fn with optional arguments</p>\n</div>',
100 |              type: 'function(number, string=)', optional: false, 'default':undefined}
101 |          ]);
102 |       });
103 | 
104 |       it('should parse return', function() {
105 |         var doc = new Doc('@name a\n@returns {Type} text *bold*.');
106 |         doc.parse();
107 |         expect(doc.returns).toEqual({
108 |           type: 'Type',
109 |           description: '<div class="a-page"><p>text <em>bold</em>.</p>\n</div>'
110 |         });
111 |       });
112 | 
113 |       it('should parse eventType', function() {
114 |         var doc = new Doc('@name a\n@eventType broadcast');
115 |         doc.parse();
116 |         expect(doc.returns).toEqual({
117 |           type: 'broadcast'
118 |         });
119 |       });
120 | 
121 |       it('should parse filename', function() {
122 |         var doc = new Doc('@name friendly name', 'docs/a.b.ngdoc', 1);
123 |         doc.parse(0);
124 |         expect(doc.id).toEqual('a.b');
125 |         expect(doc.name).toEqual('friendly name');
126 |       });
127 | 
128 |       it('should store all links', function() {
129 |         var doc = new Doc('@name a\n@description {@link api/angular.link}');
130 |         doc.parse();
131 | 
132 |         expect(doc.links).toContain('api/angular.link');
133 |       });
134 | 
135 |       it('should correctly parse capitalized service names', function(){
136 |         var doc = new Doc('@ngdoc service\n@name my.module.Service');
137 |         doc.parse();
138 |         expect(ngdoc.metadata([doc])[0].shortName).toEqual('my.module.Service');
139 |         expect(ngdoc.metadata([doc])[0].moduleName).toEqual('my.module');
140 |       });
141 | 
142 |       describe('convertUrlToAbsolute', function() {
143 |         var doc;
144 | 
145 |         beforeEach(function() {
146 |           doc = new Doc({section: 'section'});
147 |         });
148 | 
149 |         it('should not change absolute url', function() {
150 |           expect(doc.convertUrlToAbsolute('guide/index')).toEqual('#/guide/index');
151 |         });
152 | 
153 |         it('should prepend current section to relative url', function() {
154 |           expect(doc.convertUrlToAbsolute('angular.widget')).toEqual('#/section/angular.widget');
155 |         });
156 | 
157 |         it('should change id to index if not specified', function() {
158 |           expect(doc.convertUrlToAbsolute('guide/')).toEqual('#/guide/index');
159 |         });
160 |       });
161 | 
162 |       describe('convertUrlToAbsolute HTML5 mode', function() {
163 |         var doc;
164 | 
165 |         beforeEach(function() {
166 |           doc = new Doc({section: 'section'}, 'a', 1, {html5Mode: true});
167 |         });
168 | 
169 |         it('should not change absolute url', function() {
170 |           expect(doc.convertUrlToAbsolute('guide/index')).toEqual('guide/index');
171 |         });
172 | 
173 |         it('should prepend current section to relative url', function() {
174 |           expect(doc.convertUrlToAbsolute('angular.widget')).toEqual('section/angular.widget');
175 |         });
176 | 
177 |         it('should change id to index if not specified', function() {
178 |           expect(doc.convertUrlToAbsolute('guide/')).toEqual('guide/index');
179 |         });
180 |       });
181 | 
182 |       describe('sorting', function() {
183 |         function property(name) {
184 |           return function(obj) {return obj[name];};
185 |         }
186 |         var dev_guide_overview = new Doc({ngdoc:'overview', id:'dev_guide.overview', text: ''});
187 |         var dev_guide_bootstrap = new Doc({ngdoc:'function', id:'dev_guide.bootstrap', text: ''});
188 | 
189 |         it('should put angular.fn() in front of dev_guide.overview, etc', function() {
190 |           expect(ngdoc.metadata([dev_guide_overview, dev_guide_bootstrap]).map(property('id')))
191 |             .toEqual(['dev_guide.overview', 'dev_guide.bootstrap']);
192 |         });
193 |       });
194 |     });
195 |   });
196 | 
197 |   describe('markdown', function() {
198 |     it('should not replace anything in <pre>, but escape the html escape the content', function() {
199 |       expect(new Doc().markdown('bah x\n<pre>\n<b>angular</b>.k\n</pre>\n asdf x')).
200 |         toEqual(
201 |             '<div class="docs-page"><p>bah x\n' +
202 |             '<pre class="prettyprint linenums">\n' +
203 |             '&lt;b&gt;angular&lt;/b&gt;.k\n' +
204 |             '</pre>\n' +
205 |             ' asdf x</p>\n</div>');
206 |     });
207 | 
208 |     it('should wrap everything inside a container tag', function() {
209 |       var doc = new Doc('@name superman').parse();
210 |       var content = doc.markdown('hello');
211 | 
212 |       expect(content).toMatch('<div class="superman-page"><p>hello</p>\n</div>');
213 |     });
214 | 
215 |     it('should use the content before a colon as the name prefix for the className of the tag container', function() {
216 |       var doc = new Doc('@name super: man').parse();
217 |       var content = doc.markdown('hello');
218 | 
219 |       expect(content).toMatch('<div class="super-page super-man-page"><p>hello</p>\n</div>');
220 |     });
221 | 
222 |     it('should replace text between two <pre></pre> tags', function() {
223 |       expect(new Doc().markdown('<pre>x</pre>\n# One\n<pre>b</pre>')).
224 |         toMatch('</pre>\n<h1>One</h1>\n<pre');
225 |     });
226 | 
227 |     it('should replace inline variable type hints', function() {
228 |       expect(new Doc().markdown('{@type string}')).
229 |         toMatch(/<a\s+.*?class=".*?type-hint type-hint-string.*?".*?>/);
230 |     });
231 | 
232 |     it('should ignore nested doc widgets', function() {
233 |       expect(new Doc().markdown(
234 |         'before\n<div class="tabbable">\n' +
235 |           '<div class="tab-pane well" id="git-mac" ng:model="Git on Mac/Linux">' +
236 |           '\ngit bla bla\n</div>\n' +
237 |         '</div>')).toEqual(
238 | 
239 |         '<div class="docs-page"><p>before</p>\n<div class="tabbable">\n' +
240 |           '<div class="tab-pane well" id="git-mac" ng:model="Git on Mac/Linux">\n' +
241 |           'git bla bla\n' +
242 |           '</div>\n' +
243 |         '</div></div>');
244 |       });
245 | 
246 |     it('should unindent text before processing based on the second line', function() {
247 |       expect(new Doc().markdown('first line\n' +
248 |                                 '   second line\n\n' +
249 |                                 '       third line\n' +
250 |                                 '        fourth line\n\n' +
251 |                                 '   fifth line')).
252 |         toMatch('<p>first line\n' +
253 |                 'second line</p>\n' +
254 |                 '<pre><code>third line\n' +
255 |                 ' fourth line</code></pre>\n' +
256 |                 '<p>fifth line</p>\n');
257 |     });
258 | 
259 |     it('should unindent text before processing based on the first line', function() {
260 |       expect(new Doc().markdown('   first line\n\n' +
261 |                                 '       second line\n' +
262 |                                 '       third line\n' +
263 |                                 '        fourth line\n\n' +
264 |                                 '   fifth line')).
265 |         toMatch('<div class="docs-page"><p>first line</p>\n' +
266 |                 '<pre><code>second line\n' +
267 |                 'third line\n' +
268 |                 ' fourth line</code></pre>\n' +
269 |                 '<p>fifth line</p>\n</div>');
270 |     });
271 | 
272 |     describe('highlight code fences', function() {
273 |       var tInputCode;
274 | 
275 |       beforeEach(function() {
276 |         tInputCode = 'function myFunction() {\n' +
277 |             'var tSolution;\n' +
278 |             '// tSolution = complexMethod();\n' +
279 |             'tSolution = 42; // expect 42 as correct solution\n' +
280 |             'return tSolution;' +
281 |             '}';
282 | 
283 |       });
284 | 
285 |       it('should replace the ``` fence with a code block', function() {
286 |         var tInput,
287 |             tOutput;
288 | 
289 |         tInput = '```\n' +
290 |             tInputCode +
291 |             '```';
292 | 
293 |         tOutput = new Doc(null, null, null, {highlightCodeFences: true}).markdown(tInput);
294 | 
295 |         expect(tOutput)
296 |             .toEqual('<div class="docs-page">' +
297 |             '<pre class="prettyprint linenums">\n' +
298 |             tInputCode +
299 |             '</pre>\n' +
300 |             '</div>');
301 |       });
302 | 
303 |       it('should replace the ``` fence with a code block containing the type information', function() {
304 |         var tInput,
305 |             tOutput;
306 | 
307 |         tInput = '```js\n' +
308 |             tInputCode +
309 |             '```';
310 | 
311 |         tOutput = new Doc(null, null, null, {highlightCodeFences: true}).markdown(tInput);
312 | 
313 |         expect(tOutput)
314 |             .toEqual('<div class="docs-page">' +
315 |             '<pre class="prettyprint linenums lang-js">\n' +
316 |             tInputCode +
317 |             '</pre>\n' +
318 |             '</div>');
319 |       });
320 | 
321 |       it('should replace the ``` fence with a code block and success alert class', function() {
322 |         var tInput,
323 |             tOutput;
324 | 
325 |         tInput = '```+\n' +
326 |             tInputCode +
327 |             '```';
328 | 
329 |         tOutput = new Doc(null, null, null, {highlightCodeFences: true}).markdown(tInput);
330 | 
331 |         expect(tOutput)
332 |             .toEqual('<div class="docs-page">' +
333 |             '<pre class="prettyprint linenums alert alert-success">\n' +
334 |             tInputCode +
335 |             '</pre>\n' +
336 |             '</div>');
337 |       });
338 | 
339 |       it('should replace the ``` fence with a code block and danger alert class', function() {
340 |         var tInput,
341 |             tOutput;
342 | 
343 |         tInput = '```-\n' +
344 |             tInputCode +
345 |             '```';
346 | 
347 |         tOutput = new Doc(null, null, null, {highlightCodeFences: true}).markdown(tInput);
348 | 
349 |         expect(tOutput)
350 |             .toEqual('<div class="docs-page">' +
351 |             '<pre class="prettyprint linenums alert alert-danger">\n' +
352 |             tInputCode +
353 |             '</pre>\n' +
354 |             '</div>');
355 |       });
356 | 
357 |       it('should replace the ``` fence with a code block containing the type information and the success alert class', function() {
358 |         var tInput,
359 |             tOutput;
360 | 
361 |         tInput = '```+js\n' +
362 |             tInputCode +
363 |             '```';
364 | 
365 |         tOutput = new Doc(null, null, null, {highlightCodeFences: true}).markdown(tInput);
366 | 
367 |         expect(tOutput)
368 |             .toEqual('<div class="docs-page">' +
369 |             '<pre class="prettyprint linenums alert alert-success lang-js">\n' +
370 |             tInputCode +
371 |             '</pre>\n' +
372 |             '</div>');
373 |       });
374 | 
375 |       it('should replace the ``` fence with a code block containing the type information and the danger alert class', function() {
376 |         var tInput,
377 |             tOutput;
378 | 
379 |         tInput = '```-js\n' +
380 |             tInputCode +
381 |             '```';
382 | 
383 |         tOutput = new Doc(null, null, null, {highlightCodeFences: true}).markdown(tInput);
384 | 
385 |         expect(tOutput)
386 |             .toEqual('<div class="docs-page">' +
387 |             '<pre class="prettyprint linenums alert alert-danger lang-js">\n' +
388 |             tInputCode +
389 |             '</pre>\n' +
390 |             '</div>');
391 |       });
392 | 
393 |       it('should not replace the ``` fence', function() {
394 |         var tInput,
395 |             tOutput;
396 | 
397 |         tInput = '```\n' +
398 |             tInputCode +
399 |             '```';
400 | 
401 |         tOutput = new Doc(null, null, null, {highlightCodeFences: false}).markdown(tInput);
402 | 
403 |         expect(tOutput).toEqual('<div class="docs-page"><pre><code>' + tInputCode + '</code></pre>\n</div>');
404 |       });
405 |     });
406 | 
407 | 
408 |     describe('inline annotations', function() {
409 |       it('should convert inline docs annotations into proper HTML', function() {
410 |         expect(new Doc().markdown(
411 |           "<pre>\n//!annotate supertext\n<br />\n</pre>"
412 |           )
413 |         ).toContain('data-popover data-content="supertext"')
414 |       });
415 | 
416 |       it('should allow for a custom regular expression for matching', function() {
417 |         expect(new Doc().markdown(
418 |           "<pre>\n//!annotate=\"soon\" supertext\n<p>soon</p>\n</pre>"
419 |           )
420 |         ).toContain('data-popover data-content="supertext" data-title="Info">soon</div>')
421 |       });
422 | 
423 |       it('should allow for a custom title to be set', function() {
424 |         expect(new Doc().markdown(
425 |           "<pre>\n//!annotate=\"soon\" coming soon|supertext\n<p>soon</p>\n</pre>"
426 |           )
427 |         ).toContain('data-popover data-content="supertext" data-title="coming soon">soon</div>')
428 |       });
429 |     });
430 |   });
431 | 
432 |   describe('trim', function() {
433 |     var trim = ngdoc.trim;
434 |     it('should remove leading/trailing space', function() {
435 |       expect(trim('  \nabc\n  ')).toEqual('abc');
436 |     });
437 | 
438 |     it('should remove leading space on every line', function() {
439 |       expect(trim('\n 1\n  2\n   3\n')).toEqual('1\n 2\n  3');
440 |     });
441 |   });
442 | 
443 |   describe('merge', function() {
444 |     it('should merge child with parent', function() {
445 |       var parent = new Doc({id: 'ng.abc', name: 'ng.abc', section: 'api'});
446 |       var methodA = new Doc({name: 'methodA', methodOf: 'ng.abc', section: 'api'});
447 |       var methodB = new Doc({name: 'methodB', methodOf: 'ng.abc', section: 'api'});
448 |       var propA = new Doc({name: 'propA', propertyOf: 'ng.abc', section: 'api'});
449 |       var propB = new Doc({name: 'propB', propertyOf: 'ng.abc', section: 'api'});
450 |       var eventA = new Doc({name: 'eventA', eventOf: 'ng.abc', section: 'api'});
451 |       var eventB = new Doc({name: 'eventB', eventOf: 'ng.abc', section: 'api'});
452 |       var docs = [methodB, methodA, eventB, eventA, propA, propB, parent]; // keep wrong order;
453 |       ngdoc.merge(docs);
454 |       expect(docs.length).toEqual(1);
455 |       expect(docs[0].id).toEqual('ng.abc');
456 |       expect(docs[0].methods).toEqual([methodA, methodB]);
457 |       expect(docs[0].events).toEqual([eventA, eventB]);
458 |       expect(docs[0].properties).toEqual([propA, propB]);
459 |     });
460 |   });
461 | 
462 | 
463 |   describe('checkBrokenLinks', function() {
464 |     var docs, apis = {'api': true};
465 | 
466 |     beforeEach(function() {
467 |       spyOn(console, 'log');
468 |       docs = [new Doc({section: 'api', id: 'fake.id1', anchors: ['one']}),
469 |               new Doc({section: 'api', id: 'fake.id2'}),
470 |               new Doc({section: 'api', id: 'fake.id3'})];
471 |     });
472 | 
473 |     it('should log warning when a linked page does not exist', function() {
474 |       docs.push(new Doc({section: 'api', id: 'with-broken.link', links: ['non-existing-link']}))
475 |       ngdoc.checkBrokenLinks(docs, apis);
476 |       expect(console.log).toHaveBeenCalled();
477 |       var warningMsg = console.log.argsForCall[0][0]
478 |       expect(warningMsg).toContain('WARNING:');
479 |       expect(warningMsg).toContain('non-existing-link');
480 |       expect(warningMsg).toContain('api/with-broken.link');
481 |     });
482 | 
483 |     it('should log warning when a linked anchor does not exist', function() {
484 |       docs.push(new Doc({section: 'api', id: 'with-broken.link', links: ['api/fake.id1#non-existing']}))
485 |       ngdoc.checkBrokenLinks(docs, apis);
486 |       expect(console.log).toHaveBeenCalled();
487 |       var warningMsg = console.log.argsForCall[0][0]
488 |       expect(warningMsg).toContain('WARNING:');
489 |       expect(warningMsg).toContain('non-existing');
490 |       expect(warningMsg).toContain('api/with-broken.link');
491 |     });
492 |   });
493 | 
494 |   ////////////////////////////////////////
495 | 
496 |   describe('TAG', function() {
497 |     describe('@param', function() {
498 |       it('should parse with no default', function() {
499 |         var doc = new Doc('@name a\n@param {(number|string)} number Number \n to format.');
500 |         doc.parse();
501 |         expect(doc.param).toEqual([{
502 |           type : '(number|string)',
503 |           name : 'number',
504 |           optional: false,
505 |           'default' : undefined,
506 |           description : '<div class="a-page"><p>Number\nto format.</p>\n</div>' }]);
507 |       });
508 | 
509 |       it('should parse with default and optional', function() {
510 |         var doc = new Doc('@name a\n@param {(number|string)=} [fractionSize=2] desc');
511 |         doc.parse();
512 |         expect(doc.param).toEqual([{
513 |           type : '(number|string)',
514 |           name : 'fractionSize',
515 |           optional: true,
516 |           'default' : '2',
517 |           description : '<div class="a-page"><p>desc</p>\n</div>' }]);
518 |       });
519 |     });
520 | 
521 |     describe('@requires', function() {
522 |       it('should parse more @requires tag into array', function() {
523 |         var doc = new Doc('@section api\n@name a\n@requires $service for \n`A`\n@requires $another for `B`',
524 |                           'a', 1, {html5Mode:true});
525 |         doc.ngdoc = 'service';
526 |         doc.parse();
527 |         expect(doc.requires).toEqual([
528 |           {name:'$service', text:'<div class="a-page"><p>for\n<code>A</code></p>\n</div>'},
529 |           {name:'$another', text:'<div class="a-page"><p>for <code>B</code></p>\n</div>'}]);
530 |         expect(doc.html()).toContain('<a href="api/ng.$service">$service</a>');
531 |         expect(doc.html()).toContain('<a href="api/ng.$another">$another</a>');
532 |         expect(doc.html()).toContain('<p>for\n<code>A</code></p>');
533 |         expect(doc.html()).toContain('<p>for <code>B</code></p>');
534 |       });
535 |     });
536 | 
537 |     describe('@scope', function() {
538 |       it('should state the new scope will be created', function() {
539 |         var doc = new Doc('@name a\n@scope');
540 |         doc.ngdoc = 'directive';
541 |         doc.parse();
542 |         expect(doc.scope).toEqual('');
543 |         expect(doc.html()).toContain('This directive creates new scope.');
544 |       });
545 |     });
546 | 
547 |     describe('@priority', function() {
548 |       it('should state the priority', function() {
549 |         var doc = new Doc('@name a\n@priority 123');
550 |         doc.ngdoc = 'directive';
551 |         doc.parse();
552 |         expect(doc.priority).toEqual('123');
553 |         expect(doc.html()).toContain('This directive executes at priority level 123.');
554 |       });
555 |     });
556 | 
557 |     describe('@property', function() {
558 |       it('should parse @property tags into array', function() {
559 |         var doc = new Doc("@name a\n@property {type} name1 desc\n@property {type} name2 desc");
560 |         doc.parse();
561 |         expect(doc.properties.length).toEqual(2);
562 |       });
563 | 
564 |       it('should not parse @property without a type', function() {
565 |         var doc = new Doc("@property fake", 'test.js', '44');
566 |         expect(function() { doc.parse(); }).
567 |           toThrow(new Error("Not a valid 'property' format: fake (found in: test.js:44)"));
568 |       });
569 | 
570 |       it('should parse @property with type', function() {
571 |         var doc = new Doc("@name a\n@property {string} name");
572 |         doc.parse();
573 |         expect(doc.properties[0].name).toEqual('name');
574 |         expect(doc.properties[0].type).toEqual('string');
575 |       });
576 | 
577 |       it('should parse @property with optional description', function() {
578 |         var doc = new Doc("@name a\n@property {string} name desc rip tion");
579 |         doc.parse();
580 |         expect(doc.properties[0].name).toEqual('name');
581 |         expect(doc.properties[0].description).toEqual('<div class="a-page"><p>desc rip tion</p>\n</div>');
582 |       });
583 | 
584 |       it('should parse @property with type and description both', function() {
585 |         var doc = new Doc("@name a\n@property {bool} name desc rip tion");
586 |         doc.parse();
587 |         expect(doc.properties[0].name).toEqual('name');
588 |         expect(doc.properties[0].type).toEqual('bool');
589 |         expect(doc.properties[0].description).toEqual('<div class="a-page"><p>desc rip tion</p>\n</div>');
590 |       });
591 | 
592 |     });
593 | 
594 |     describe('@returns', function() {
595 |       it('should not parse @returns without type', function() {
596 |         var doc = new Doc("@returns lala");
597 |         expect(function() { doc.parse(); }).
598 |             toThrow();
599 |       });
600 | 
601 | 
602 |       it('should not parse @returns with invalid type', function() {
603 |         var doc = new Doc("@returns {xx}x} lala", 'test.js', 34);
604 |         expect(function() { doc.parse(); }).
605 |             toThrow(new Error("Not a valid 'returns' format: {xx}x} lala (found in: test.js:34)"));
606 |       });
607 | 
608 | 
609 |       it('should parse @returns with type and description', function() {
610 |         var doc = new Doc("@name a\n@returns {string} descrip tion");
611 |         doc.parse();
612 |         expect(doc.returns).toEqual({type: 'string', description: '<div class="a-page"><p>descrip tion</p>\n</div>'});
613 |       });
614 | 
615 |       it('should parse @returns with complex type and description', function() {
616 |         var doc = new Doc("@name a\n@returns {function(string, number=)} description");
617 |         doc.parse();
618 |         expect(doc.returns).toEqual({type: 'function(string, number=)', description: '<div class="a-page"><p>description</p>\n</div>'});
619 |       });
620 | 
621 |       it('should transform description of @returns with markdown', function() {
622 |         var doc = new Doc("@name a\n@returns {string} descrip *tion*");
623 |         doc.parse();
624 |         expect(doc.returns).toEqual({type: 'string', description: '<div class="a-page"><p>descrip <em>tion</em></p>\n</div>'});
625 |       });
626 | 
627 |       it('should support multiline content', function() {
628 |         var doc = new Doc("@name a\n@returns {string} description\n new line\n another line");
629 |         doc.parse();
630 |         expect(doc.returns).
631 |           toEqual({type: 'string', description: '<div class="a-page"><p>description\nnew line\nanother line</p>\n</div>'});
632 |       });
633 |     });
634 | 
635 |     describe('@description', function() {
636 |       it('should support pre blocks', function() {
637 |         var doc = new Doc("@name a\n@description <pre><b>abc</b></pre>");
638 |         doc.parse();
639 |         expect(doc.description).
640 |           toBe('<div class="a-page"><pre class="prettyprint linenums">&lt;b&gt;abc&lt;/b&gt;</pre>\n</div>');
641 |       });
642 | 
643 |       it('should support multiple pre blocks', function() {
644 |         var doc = new Doc("@name a\n@description foo \n<pre>abc</pre>\n#bah\nfoo \n<pre>cba</pre>");
645 |         doc.parse();
646 |         expect(doc.description).
647 |           toBe('<div class="a-page"><p>foo\n' +
648 |                '<pre class="prettyprint linenums">abc</pre>\n' +
649 |                '<h1>bah</h1>\n' +
650 |                '<p>foo \n' +
651 |                '<pre class="prettyprint linenums">cba</pre>\n</div>');
652 |       });
653 | 
654 |       it('should support nested @link annotations with or without description', function() {
655 |         var doc = new Doc("@name a\n@description " +
656 |             'foo {@link angular.foo}\n\n da {@link angular.foo bar foo bar } \n\n' +
657 |             'dad{@link angular.foo}\n\n' +
658 |             'external{@link http://angularjs.org}\n\n' +
659 |             'external{@link ./static.html}\n\n' +
660 |             '{@link angular.directive.ng-foo ng:foo}', 'a', 1, {html5Mode:true});
661 | 
662 |         doc.section = 'api';
663 |         doc.parse();
664 | 
665 |         expect(doc.description).
666 |           toContain('foo <a href="api/angular.foo"><code>angular.foo</code></a>');
667 |         expect(doc.description).
668 |           toContain('da <a href="api/angular.foo"><code>bar foo bar</code></a>');
669 |         expect(doc.description).
670 |           toContain('dad<a href="api/angular.foo"><code>angular.foo</code></a>');
671 |         expect(doc.description).
672 |           toContain('<a href="api/angular.directive.ng-foo"><code>ng:foo</code></a>');
673 |         expect(doc.description).
674 |           toContain('<a href="http://angularjs.org">http://angularjs.org</a>');
675 |         expect(doc.description).
676 |           toContain('<a href="./static.html">./static.html</a>');
677 |       });
678 | 
679 |       it('should support line breaks in @link', function() {
680 |         var doc = new Doc("@name a\n@description " +
681 |             '{@link\napi/angular.foo\na\nb}', 'a', 1, {html5Mode:true});
682 |         doc.parse();
683 |         expect(doc.description).
684 |           toContain('<a href="api/angular.foo"><code>a b</code></a>');
685 |       });
686 | 
687 |     });
688 | 
689 |     describe('@example', function() {
690 |       it('should not remove {{}}', function() {
691 |         var doc = new Doc('@name a\n@example text {{ abc }}');
692 |         doc.parse();
693 |         expect(doc.example).toEqual('<div class="a-page"><p>text {{ abc }}</p>\n</div>');
694 |       });
695 |     });
696 | 
697 |     describe('@deprecated', function() {
698 |       it('should parse @deprecated', function() {
699 |         var doc = new Doc('@name a\n@deprecated Replaced with foo.');
700 |         doc.parse();
701 |         expect(doc.deprecated).toBe('Replaced with foo.');
702 |       });
703 |     });
704 | 
705 |     describe('@this', function() {
706 |       it('should render @this', function() {
707 |         var doc = new Doc('@name a\n@this I am self.');
708 |         doc.ngdoc = 'filter';
709 |         doc.parse();
710 |         expect(doc.html()).toContain('<h3>Method\'s <code>this</code></h3>\n' +
711 |             '<div>' +
712 |             '<div class="a-page">' +
713 |             '<p>I am self.</p>\n' +
714 |             '</div>' +
715 |             '</div>\n');
716 |         expect(doc.html()).toContain('<h3>Method\'s <code>this</code></h3>\n' +
717 |             '<div><div class="a-page"><p>I am self.</p>\n</div></div>');
718 |       });
719 |     });
720 | 
721 |     describe('@animations', function() {
722 |       it('should render @this', function() {
723 |         var doc = new Doc('@name a\n@animations\nenter - Add text\nleave - Remove text\n');
724 |         doc.ngdoc = 'filter';
725 |         doc.parse();
726 |         expect(doc.html()).toContain(
727 |             '<h3 id="usage_animations">Animations</h3>\n' +
728 |             '<div class="animations">' +
729 |               '<ul>' +
730 |                 '<li>enter - Add text</li>' +
731 |                 '<li>leave - Remove text</li>' +
732 |               '</ul>' +
733 |             '</div>');
734 |       });
735 |     });
736 |   });
737 | 
738 |   describe('usage', function() {
739 |     describe('overview', function() {
740 |       it('should supress description heading', function() {
741 |         var doc = new Doc('@ngdoc overview\n@name angular\n@description\n#heading\ntext');
742 |         doc.parse();
743 |         expect(doc.html()).toContain('text');
744 |         expect(doc.html()).toContain('<h2 id="heading">heading</h2>');
745 |         expect(doc.html()).not.toContain('Description');
746 |       });
747 |     });
748 | 
749 | 
750 |      describe('function', function() {
751 |       it('should format', function() {
752 |         var doc = new Doc({
753 |           ngdoc:'function',
754 |           name:'some.function:name',
755 |           param: [
756 |             {name:'a', type: 'string', optional: true},
757 |             {name:'b', type: 'someType', optional: true, 'default': '"xxx"'},
758 |             {name:'c', type: 'string', description: 'param desc'}
759 |           ],
760 |           returns: {type: 'number', description: 'return desc'}
761 |         });
762 |         doc.html_usage_function(dom);
763 |         expect(dom).toContain('name([a][, b], c)'); //TODO(i) the comma position here is lame
764 |         expect(dom).toContain('param desc');
765 |         expect(dom).toContain('(optional)');
766 |         expect(dom).toContain('return desc');
767 |       });
768 |     });
769 | 
770 |     describe('filter', function() {
771 |       it('should format', function() {
772 |         var doc = new Doc({
773 |           ngdoc:'formatter',
774 |           shortName:'myFilter',
775 |           param: [
776 |             {name:'a', type:'string'},
777 |             {name:'b', type:'string'}
778 |           ]
779 |         });
780 |         doc.html_usage_filter(dom);
781 |         expect(dom).toContain('myFilter_expression | myFilter:b');
782 |         expect(dom).toContain('$filter(\'myFilter\')(a, b)');
783 |       });
784 |     });
785 | 
786 |     describe('property', function() {
787 |       it('should format', function() {
788 |         var doc = new Doc({
789 |           ngdoc:'property',
790 |           name:'myProp',
791 |           type:'string',
792 |           returns:{type: 'type', description: 'description'}
793 |         });
794 |         doc.html_usage_property(dom);
795 |         expect(dom).toContain('myProp');
796 |         expect(dom).toContain('type');
797 |         expect(dom).toContain('description');
798 |       });
799 |     });
800 | 
801 |     describe('custom', function() {
802 |       it('should format', function() {
803 |         var doc = new Doc({
804 |           ngdoc:'object',
805 |           name:'app.common.object:myObject',
806 |           type:'string',
807 |           returns:{type: 'type', description: 'description'}
808 |         });
809 |         doc.html_usage_property(dom);
810 |         expect(dom).not.toContain('object:myObject');
811 |         expect(dom).toContain('myObject');
812 |         expect(dom).toContain('type');
813 |         expect(dom).toContain('description');
814 |       });
815 |     });
816 |   });
817 | 
818 |   describe('watch', function() {
819 | 
820 |     it('should not duplicate pages if it is run in succession', function(done) {
821 | 
822 |       var targetFiles = __dirname + '/fixtures/watch/*.js';
823 |       var destFiles = tmpTestFiles;
824 | 
825 |       // First go
826 |       gulp.src(targetFiles)
827 |         .pipe(index.process({}))
828 |         .pipe(gulp.dest(destFiles))
829 |         .on('end', function() {
830 |           // Second go
831 |           gulp.src(targetFiles)
832 |             .pipe(index.process({}))
833 |             .pipe(gulp.dest(destFiles))
834 |             .on('end', function() {
835 | 
836 |               var setupContent = fs.readFileSync(destFiles + '/js/docs-setup.js', 'utf-8');
837 |               var setup = eval(setupContent);
838 |               expect(setup.pages.length).toEqual(2);
839 |               done();
840 | 
841 |             })
842 |         });
843 | 
844 |     });
845 | 
846 |   });
847 | 
848 |   describe('error handling', function() {
849 | 
850 | 
851 |     it('should trigger an error event on the stream', function(done) {
852 |       return gulp.src( __dirname + '/fixtures/error/*.js' )
853 |         .pipe( index.process({}) )
854 |         .pipe( gulp.dest( tmpTestFiles ) )
855 |         .on('error', done);
856 |     });
857 | 
858 |   });
859 | 
860 | });
861 | 


--------------------------------------------------------------------------------
/src/dom.js:
--------------------------------------------------------------------------------
  1 | /**
  2 |  * DOM generation class
  3 |  */
  4 | 
  5 | exports.DOM = DOM;
  6 | exports.htmlEscape = htmlEscape;
  7 | exports.normalizeHeaderToId = normalizeHeaderToId;
  8 | 
  9 | //////////////////////////////////////////////////////////
 10 | 
 11 | function htmlEscape(text){
 12 |   return text
 13 |           .replace(/&/g, '&amp;')
 14 |           .replace(/</g, '&lt;')
 15 |           .replace(/>/g, '&gt;')
 16 |           .replace(/\{\{/g, '<span>{{</span>')
 17 |           .replace(/\}\}/g, '<span>}}</span>');
 18 | }
 19 | 
 20 | function nonEmpty(header) {
 21 |   return !!header;
 22 | }
 23 | 
 24 | function idFromCurrentHeaders(headers) {
 25 |   if (headers.length === 1) return headers[0];
 26 |   // Do not include the first level title, as that's the title of the page.
 27 |   return headers.slice(1).filter(nonEmpty).join('_');
 28 | }
 29 | 
 30 | function normalizeHeaderToId(header) {
 31 |   if (typeof header !== 'string') {
 32 |     return '';
 33 |   }
 34 | 
 35 |   return header.toLowerCase()
 36 |       .replace(/<.*>/g, '')         // html tags
 37 |       .replace(/[\!\?\:\.\']/g, '') // special characters
 38 |       .replace(/&#\d\d;/g, '')      // html entities
 39 |       .replace(/\(.*\)/mg, '')      // stuff in parenthesis
 40 |       .replace(/\s$/, '')           // trailing spaces
 41 |       .replace(/\s+/g, '-');        // replace whitespaces with dashes
 42 | }
 43 | 
 44 | 
 45 | function DOM() {
 46 |   this.out = [];
 47 |   this.headingDepth = 0;
 48 |   this.currentHeaders = [];
 49 |   this.anchors = [];
 50 | }
 51 | 
 52 | var INLINE_TAGS = {
 53 |     i: true,
 54 |     b: true,
 55 |     a: true
 56 | };
 57 | 
 58 | DOM.prototype = {
 59 |   toString: function() {
 60 |     return this.out.join('');
 61 |   },
 62 | 
 63 |   text: function(content) {
 64 |     if (typeof content == "string") {
 65 |       this.out.push(htmlEscape(content));
 66 |     } else if (typeof content == 'function') {
 67 |       content.call(this, this);
 68 |     } else if (content instanceof Array) {
 69 |       this.ul(content);
 70 |     }
 71 |   },
 72 | 
 73 |   html: function(html) {
 74 |     if (!html) return;
 75 | 
 76 |     var self = this;
 77 |     // rewrite header levels, add ids and collect the ids
 78 |     html = html.replace(/<h(\d)(.*?)>([\s\S]+?)<\/h\1>/gm, function(_, level, attrs, content) {
 79 |       level = parseInt(level, 10) + self.headingDepth; // change header level based on the context
 80 | 
 81 |       self.currentHeaders[level - 1] = normalizeHeaderToId(content);
 82 |       self.currentHeaders.length = level;
 83 | 
 84 |       var id = idFromCurrentHeaders(self.currentHeaders);
 85 |       self.anchors.push(id);
 86 |       return '<h' + level + attrs + ' id="' + id + '">' + content + '</h' + level + '>';
 87 |     });
 88 | 
 89 |     // collect anchors
 90 |     html = html.replace(/<a name="(\w*)">/g, function(match, anchor) {
 91 |       self.anchors.push(anchor);
 92 |       return match;
 93 |     });
 94 | 
 95 |     this.out.push(html);
 96 |   },
 97 | 
 98 |   tag: function(name, attr, text) {
 99 |     if (!text) {
100 |       text = attr;
101 |       attr = {};
102 |       if (name == 'code')
103 |         attr['ng:non-bindable'] = '';
104 |     }
105 |     this.out.push('<' + name);
106 |     for(var key in attr) {
107 |       this.out.push(" " + key + '="' + attr[key] + '"');
108 |     }
109 |     this.out.push('>');
110 |     this.text(text);
111 |     this.out.push('</' + name + '>');
112 |     if (!INLINE_TAGS[name])
113 |       this.out.push('\n');
114 |   },
115 | 
116 |   code: function(text) {
117 |     this.tag('pre', {'class':"prettyprint linenums"}, text);
118 |   },
119 | 
120 |   div: function(attr, text) {
121 |     this.tag('div', attr, text);
122 |   },
123 | 
124 |   h: function(heading, content, fn){
125 |     if (content==undefined || (content instanceof Array && content.length == 0)) return;
126 | 
127 |     this.headingDepth++;
128 |     this.currentHeaders[this.headingDepth - 1] = normalizeHeaderToId(heading);
129 |     this.currentHeaders.length = this.headingDepth;
130 | 
131 |     var className = null,
132 |         anchor = null;
133 |     if (typeof heading == 'string') {
134 |       var id = idFromCurrentHeaders(this.currentHeaders);
135 |       this.anchors.push(id);
136 |       anchor = {'id': id};
137 |       var classNameValue = this.currentHeaders[this.headingDepth - 1]
138 |       if(classNameValue == 'hide') classNameValue = '';
139 |       className = {'class': classNameValue};
140 |     }
141 |     this.tag('h' + this.headingDepth, anchor, heading);
142 |     if (content instanceof Array) {
143 |       this.ul(content, className, fn);
144 |     } else if (fn) {
145 |       this.tag('div', className, function() {
146 |         fn.call(this, content);
147 |       });
148 |     } else {
149 |       this.tag('div', className, content);
150 |     }
151 |     this.headingDepth--;
152 |   },
153 | 
154 |   h1: function(attr, text) {
155 |     this.tag('h1', attr, text);
156 |   },
157 | 
158 |   h2: function(attr, text) {
159 |     this.tag('h2', attr, text);
160 |   },
161 | 
162 |   h3: function(attr, text) {
163 |     this.tag('h3', attr, text);
164 |   },
165 | 
166 |   p: function(attr, text) {
167 |     this.tag('p', attr, text);
168 |   },
169 | 
170 |   ul: function(list, attr, fn) {
171 |     if (typeof attr == 'function') {
172 |       fn = attr;
173 |       attr = {};
174 |     }
175 |     this.tag('ul', attr, function(dom){
176 |       list.forEach(function(item){
177 |         dom.out.push('<li>');
178 |         dom.text(fn ? fn(item) : item);
179 |         dom.out.push('</li>\n');
180 |       });
181 |     });
182 |   }
183 | 
184 | };
185 | 


--------------------------------------------------------------------------------
/src/example.js:
--------------------------------------------------------------------------------
  1 | var seqCount = 0;
  2 | var usedIds = {};
  3 | var makeUnique = {
  4 |   'index.html': true,
  5 |   'style.css': true,
  6 |   'script.js': true,
  7 |   'unit.js': true,
  8 |   'spec.js': true,
  9 |   'scenario.js': true
 10 | }
 11 | 
 12 | function ids(list) {
 13 |   return list.map(function(item) { return item.id; }).join(' ');
 14 | };
 15 | 
 16 | 
 17 | exports.Example = function(scenarios) {
 18 |   this.module = '';
 19 |   this.deps = ['angular.js'];
 20 |   this.html = [];
 21 |   this.css = [];
 22 |   this.js = [];
 23 |   this.json = [];
 24 |   this.unit = [];
 25 |   this.scenario = [];
 26 |   this.scenarios = scenarios;
 27 | }
 28 | 
 29 | exports.Example.prototype.setModule = function(module) {
 30 |   if (module) {
 31 |     this.module = module;
 32 |   }
 33 | };
 34 | 
 35 | exports.Example.prototype.addDeps = function(deps) {
 36 |   deps && deps.split(/[\s\,]/).forEach(function(dep) {
 37 |     if (dep) {
 38 |       this.deps.push(dep);
 39 |     }
 40 |   }, this);
 41 | };
 42 | 
 43 | exports.Example.prototype.addSource = function(name, content) {
 44 |   var ext = name == 'scenario.js' ? 'scenario' : name.split('.')[1],
 45 |       id = name;
 46 | 
 47 |   if (makeUnique[name] && usedIds[id]) {
 48 |     id = name + '-' + (seqCount++);
 49 |   }
 50 |   usedIds[id] = true;
 51 |   
 52 |   this[ext].push({name: name, content: content, id: id});
 53 |   if (name.match(/\.js$/) && name !== 'spec.js' && name !== 'unit.js' && name != 'scenario.js') {
 54 |     this.deps.push(name);
 55 |   }
 56 |   if (ext == 'scenario') {
 57 |     this.scenarios.push(content);
 58 |   }
 59 | };
 60 | 
 61 | exports.Example.prototype.enableAnimations = function() {
 62 |   this.animations = true;
 63 | };
 64 | 
 65 | exports.Example.prototype.disableAnimations = function() {
 66 |   this.animations = false;
 67 | };
 68 | 
 69 | exports.Example.prototype.toHtml = function() {
 70 |   var html = "<h2>Source</h2>\n";
 71 |   html += this.toHtmlEdit();
 72 |   html += this.toHtmlTabs();
 73 |   if(this.animations) {
 74 |     html += '<div class="pull-right">';
 75 |     html += ' <button class="btn btn-primary" ng-click="animationsOff=true" ng-hide="animationsOff">Animations on</button>';
 76 |     html += ' <button class="btn btn-primary disabled" ng-click="animationsOff=false" ng-show="animationsOff">Animations off</button>';
 77 |     html += '</div>';
 78 |   }
 79 |   html += "<h2>Demo</h2>\n";
 80 |   html += this.toHtmlEmbed();
 81 |   return html;
 82 | };
 83 | 
 84 | 
 85 | exports.Example.prototype.toHtmlEdit = function() {
 86 |   var out = [];
 87 |   out.push('<div source-edit="' + this.module + '"');
 88 |   out.push(' source-edit-deps="' + this.deps.join(' ') + '"');
 89 |   out.push(' source-edit-html="' + ids(this.html) + '"');
 90 |   out.push(' source-edit-css="' + ids(this.css) + '"');
 91 |   out.push(' source-edit-js="' + ids(this.js) + '"');
 92 |   out.push(' source-edit-json="' + ids(this.json) + '"');
 93 |   out.push(' source-edit-unit="' + ids(this.unit) + '"');
 94 |   out.push(' source-edit-scenario="' + ids(this.scenario) + '"');
 95 |   out.push('></div>\n');
 96 |   return out.join('');
 97 | };
 98 | 
 99 | exports.Example.prototype.toHtmlTabs = function() {
100 |   var out = [],
101 |       self = this;
102 | 
103 |   out.push('<div class="tabbable">');
104 |   htmlTabs(this.html);
105 |   htmlTabs(this.css);
106 |   htmlTabs(this.js);
107 |   htmlTabs(this.json);
108 |   htmlTabs(this.unit);
109 |   htmlTabs(this.scenario);
110 |   out.push('</div>');
111 |   return out.join('');
112 | 
113 |   function htmlTabs(sources) {
114 |     sources.forEach(function(source) {
115 |       var wrap = '',
116 |           isCss = source.name.match(/\.css$/),
117 |           name = source.name;
118 | 
119 |       if (name === 'index.html') {
120 |         wrap = ' ng-html-wrap-loaded="' + self.module + ' ' + self.deps.join(' ') + '"';
121 |       }
122 |       if (name == 'scenario.js') name = 'End to end test';
123 | 
124 |       out.push(
125 |         '<div class="tab-pane" title="' + name + '">\n' +
126 |           '<pre class="prettyprint linenums" ng-set-text="' + source.id + '"' + wrap + '></pre>\n' +
127 |           (isCss
128 |              ? ('<style type="text/css" id="' + source.id + '">' + source.content + '</style>\n')
129 |              : ('<script type="text/ng-template" id="' + source.id + '">' + source.content + '</script>\n') ) +
130 |         '</div>\n');
131 |     });
132 |   }
133 | };
134 | 
135 | exports.Example.prototype.toHtmlEmbed = function() {
136 |   var out = [];
137 |   out.push('<div class="well doc-example-live animate-container"');
138 |   if(this.animations) {
139 |     out.push(" ng-class=\"{'animations-off':animationsOff == true}\"");
140 |   }
141 |   out.push(' ng-embed-app="' + this.module + '"');
142 |   out.push(' ng-set-html="' + this.html[0].id + '"');
143 |   out.push(' ng-eval-javascript="' + ids(this.js) + '">');
144 |   out.push('</div>');
145 |   return out.join('');
146 | };
147 | 
148 | 


--------------------------------------------------------------------------------
/src/ignore.words:
--------------------------------------------------------------------------------
  1 | a
  2 | able
  3 | about
  4 | above
  5 | abst
  6 | accordance
  7 | according
  8 | accordingly
  9 | across
 10 | act
 11 | actually
 12 | added
 13 | adj
 14 | adopted
 15 | affected
 16 | affecting
 17 | affects
 18 | after
 19 | afterwards
 20 | again
 21 | against
 22 | ah
 23 | all
 24 | almost
 25 | alone
 26 | along
 27 | already
 28 | also
 29 | although
 30 | always
 31 | am
 32 | among
 33 | amongst
 34 | an
 35 | and
 36 | announce
 37 | another
 38 | any
 39 | anybody
 40 | anyhow
 41 | anymore
 42 | anyone
 43 | anything
 44 | anyway
 45 | anyways
 46 | anywhere
 47 | apparently
 48 | approximately
 49 | are
 50 | aren
 51 | arent
 52 | arise
 53 | around
 54 | as
 55 | aside
 56 | ask
 57 | asking
 58 | at
 59 | auth
 60 | available
 61 | away
 62 | awfully
 63 | b
 64 | back
 65 | be
 66 | became
 67 | because
 68 | become
 69 | becomes
 70 | becoming
 71 | been
 72 | before
 73 | beforehand
 74 | begin
 75 | beginning
 76 | beginnings
 77 | begins
 78 | behind
 79 | being
 80 | believe
 81 | below
 82 | beside
 83 | besides
 84 | between
 85 | beyond
 86 | biol
 87 | both
 88 | brief
 89 | briefly
 90 | but
 91 | by
 92 | c
 93 | ca
 94 | came
 95 | can
 96 | cannot
 97 | can't
 98 | cant
 99 | cause
100 | causes
101 | certain
102 | certainly
103 | co
104 | com
105 | come
106 | comes
107 | contain
108 | containing
109 | contains
110 | could
111 | couldnt
112 | d
113 | date
114 | did
115 | didn't
116 | didnt
117 | different
118 | do
119 | does
120 | doesn't
121 | doesnt
122 | doing
123 | done
124 | don't
125 | dont
126 | down
127 | downwards
128 | due
129 | during
130 | e
131 | each
132 | ed
133 | edu
134 | effect
135 | eg
136 | eight
137 | eighty
138 | either
139 | else
140 | elsewhere
141 | end
142 | ending
143 | enough
144 | especially
145 | et
146 | et-al
147 | etc
148 | even
149 | ever
150 | every
151 | everybody
152 | everyone
153 | everything
154 | everywhere
155 | ex
156 | except
157 | f
158 | far
159 | few
160 | ff
161 | fifth
162 | first
163 | five
164 | fix
165 | followed
166 | following
167 | follows
168 | for
169 | former
170 | formerly
171 | forth
172 | found
173 | four
174 | from
175 | further
176 | furthermore
177 | g
178 | gave
179 | get
180 | gets
181 | getting
182 | give
183 | given
184 | gives
185 | giving
186 | go
187 | goes
188 | gone
189 | got
190 | gotten
191 | h
192 | had
193 | happens
194 | hardly
195 | has
196 | hasn't
197 | hasnt
198 | have
199 | haven't
200 | havent
201 | having
202 | he
203 | hed
204 | hence
205 | her
206 | here
207 | hereafter
208 | hereby
209 | herein
210 | heres
211 | hereupon
212 | hers
213 | herself
214 | hes
215 | hi
216 | hid
217 | him
218 | himself
219 | his
220 | hither
221 | home
222 | how
223 | howbeit
224 | however
225 | hundred
226 | i
227 | id
228 | ie
229 | if
230 | i'll
231 | ill
232 | im
233 | immediate
234 | immediately
235 | importance
236 | important
237 | in
238 | inc
239 | indeed
240 | index
241 | information
242 | instead
243 | into
244 | invention
245 | inward
246 | is
247 | isn't
248 | isnt
249 | it
250 | itd
251 | it'll
252 | itll
253 | its
254 | itself
255 | i've
256 | ive
257 | j
258 | just
259 | k
260 | keep
261 | keeps
262 | kept
263 | keys
264 | kg
265 | km
266 | know
267 | known
268 | knows
269 | l
270 | largely
271 | last
272 | lately
273 | later
274 | latter
275 | latterly
276 | least
277 | less
278 | lest
279 | let
280 | lets
281 | like
282 | liked
283 | likely
284 | line
285 | little
286 | 'll
287 | 'll
288 | look
289 | looking
290 | looks
291 | ltd
292 | m
293 | made
294 | mainly
295 | make
296 | makes
297 | many
298 | may
299 | maybe
300 | me
301 | mean
302 | means
303 | meantime
304 | meanwhile
305 | merely
306 | mg
307 | might
308 | million
309 | miss
310 | ml
311 | more
312 | moreover
313 | most
314 | mostly
315 | mr
316 | mrs
317 | much
318 | mug
319 | must
320 | my
321 | myself
322 | n
323 | na
324 | name
325 | namely
326 | nay
327 | nd
328 | near
329 | nearly
330 | necessarily
331 | necessary
332 | need
333 | needs
334 | neither
335 | never
336 | nevertheless
337 | new
338 | next
339 | nine
340 | ninety
341 | no
342 | nobody
343 | non
344 | none
345 | nonetheless
346 | noone
347 | nor
348 | normally
349 | nos
350 | not
351 | noted
352 | nothing
353 | now
354 | nowhere
355 | o
356 | obtain
357 | obtained
358 | obviously
359 | of
360 | off
361 | often
362 | oh
363 | ok
364 | okay
365 | old
366 | omitted
367 | on
368 | once
369 | one
370 | ones
371 | only
372 | onto
373 | or
374 | ord
375 | other
376 | others
377 | otherwise
378 | ought
379 | our
380 | ours
381 | ourselves
382 | out
383 | outside
384 | over
385 | overall
386 | owing
387 | own
388 | p
389 | page
390 | pages
391 | part
392 | particular
393 | particularly
394 | past
395 | per
396 | perhaps
397 | placed
398 | please
399 | plus
400 | poorly
401 | possible
402 | possibly
403 | potentially
404 | pp
405 | predominantly
406 | present
407 | previously
408 | primarily
409 | probably
410 | promptly
411 | proud
412 | provides
413 | put
414 | q
415 | que
416 | quickly
417 | quite
418 | qv
419 | r
420 | ran
421 | rather
422 | rd
423 | re
424 | readily
425 | really
426 | recent
427 | recently
428 | ref
429 | refs
430 | regarding
431 | regardless
432 | regards
433 | related
434 | relatively
435 | research
436 | respectively
437 | resulted
438 | resulting
439 | results
440 | right
441 | run
442 | s
443 | said
444 | same
445 | saw
446 | say
447 | saying
448 | says
449 | sec
450 | section
451 | see
452 | seeing
453 | seem
454 | seemed
455 | seeming
456 | seems
457 | seen
458 | self
459 | selves
460 | sent
461 | seven
462 | several
463 | shall
464 | she
465 | shed
466 | she'll
467 | shell
468 | shes
469 | should
470 | shouldn't
471 | shouldnt
472 | show
473 | showed
474 | shown
475 | showns
476 | shows
477 | significant
478 | significantly
479 | similar
480 | similarly
481 | since
482 | six
483 | slightly
484 | so
485 | some
486 | somebody
487 | somehow
488 | someone
489 | somethan
490 | something
491 | sometime
492 | sometimes
493 | somewhat
494 | somewhere
495 | soon
496 | sorry
497 | specifically
498 | specified
499 | specify
500 | specifying
501 | state
502 | states
503 | still
504 | stop
505 | strongly
506 | sub
507 | substantially
508 | successfully
509 | such
510 | sufficiently
511 | suggest
512 | sup
513 | sure
514 | t
515 | take
516 | taken
517 | taking
518 | tell
519 | tends
520 | th
521 | than
522 | thank
523 | thanks
524 | thanx
525 | that
526 | that'll
527 | thatll
528 | thats
529 | that've
530 | thatve
531 | the
532 | their
533 | theirs
534 | them
535 | themselves
536 | then
537 | thence
538 | there
539 | thereafter
540 | thereby
541 | thered
542 | therefore
543 | therein
544 | there'll
545 | therell
546 | thereof
547 | therere
548 | theres
549 | thereto
550 | thereupon
551 | there've
552 | thereve
553 | these
554 | they
555 | theyd
556 | they'll
557 | theyll
558 | theyre
559 | they've
560 | theyve
561 | think
562 | this
563 | those
564 | thou
565 | though
566 | thoughh
567 | thousand
568 | throug
569 | through
570 | throughout
571 | thru
572 | thus
573 | til
574 | tip
575 | to
576 | together
577 | too
578 | took
579 | toward
580 | towards
581 | tried
582 | tries
583 | truly
584 | try
585 | trying
586 | ts
587 | twice
588 | two
589 | u
590 | un
591 | under
592 | unfortunately
593 | unless
594 | unlike
595 | unlikely
596 | until
597 | unto
598 | up
599 | upon
600 | ups
601 | us
602 | use
603 | used
604 | useful
605 | usefully
606 | usefulness
607 | uses
608 | using
609 | usually
610 | v
611 | value
612 | various
613 | 've
614 | 've
615 | very
616 | via
617 | viz
618 | vol
619 | vols
620 | vs
621 | w
622 | want
623 | wants
624 | was
625 | wasn't
626 | wasnt
627 | way
628 | we
629 | wed
630 | welcome
631 | we'll
632 | well
633 | went
634 | were
635 | weren't
636 | werent
637 | we've
638 | weve
639 | what
640 | whatever
641 | what'll
642 | whatll
643 | whats
644 | when
645 | whence
646 | whenever
647 | where
648 | whereafter
649 | whereas
650 | whereby
651 | wherein
652 | wheres
653 | whereupon
654 | wherever
655 | whether
656 | which
657 | while
658 | whim
659 | whither
660 | who
661 | whod
662 | whoever
663 | whole
664 | who'll
665 | wholl
666 | whom
667 | whomever
668 | whos
669 | whose
670 | why
671 | widely
672 | will
673 | willing
674 | wish
675 | with
676 | within
677 | without
678 | won't
679 | wont
680 | words
681 | would
682 | wouldn't
683 | wouldnt
684 | www
685 | x
686 | y
687 | yes
688 | yet
689 | you
690 | youd
691 | you'll
692 | youll
693 | your
694 | youre
695 | yours
696 | yourself
697 | yourselves
698 | you've
699 | youve
700 | z
701 | zero
702 | 


--------------------------------------------------------------------------------
/src/reader.js:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * All reading related code here.
 3 |  */
 4 | 
 5 | exports.docs = [];
 6 | exports.process = process;
 7 | 
 8 | var ngdoc = require('./ngdoc.js'),
 9 |     NEW_LINE = /\n\r?/;
10 | 
11 | function process(content, file, section, options) {
12 |   // console.log('-file-----\n' + file)
13 |   // console.log('-section-----\n' + section)
14 |   // console.log('-options-----\n' + JSON.stringify(options, null, 2))
15 |   // console.log('')
16 |   if (/\.js|.ts$/.test(file)) {
17 |     processJsFile(content, file, section, options).forEach(function(doc) {
18 |       exports.docs.push(doc);
19 |     });
20 |   } else if (file.match(/\.ngdoc$/)) {
21 |     var header = '@section ' + section + '\n';
22 |     exports.docs.push(new ngdoc.Doc(header + content.toString(),file, 1, options).parse());
23 |   }
24 | }
25 | 
26 | function processJsFile(content, file, section, options) {
27 |   var docs = [];
28 |   var lines = content.toString().split(NEW_LINE);
29 |   var text;
30 |   var startingLine ;
31 |   var match;
32 |   var inDoc = false;
33 | 
34 |   lines.forEach(function(line, lineNumber){
35 |     lineNumber++;
36 |     // is the comment starting?
37 |     if (!inDoc && (match = line.match(/^\s*\/\*\*\s*(.*)$/))) {
38 |       line = match[1];
39 |       inDoc = true;
40 |       text = [];
41 |       startingLine = lineNumber;
42 |     }
43 |     // are we done?
44 |     if (inDoc && line.match(/\*\//)) {
45 |       text = text.join('\n');
46 |       text = text.replace(/^\n/, '');
47 |       if (text.match(/@ngdoc/)){
48 |         //console.log(file, startingLine)
49 |         docs.push(new ngdoc.Doc('@section ' + section + '\n' + text, file, startingLine, options).parse());
50 |       }
51 |       doc = null;
52 |       inDoc = false;
53 |     }
54 |     // is the comment add text
55 |     if (inDoc){
56 |       text.push(line.replace(/^\s*\*\s?/, ''));
57 |     }
58 |   });
59 |   return docs;
60 | }
61 | 


--------------------------------------------------------------------------------
/src/templates/css/animations.css:
--------------------------------------------------------------------------------
 1 | .slide-reveal.ng-enter {
 2 |   -webkit-transition:0.5s linear all;
 3 |   -moz-transition:0.5s linear all;
 4 |   -o-transition:0.5s linear all;
 5 |   transition:0.5s linear all;
 6 | 
 7 |   opacity:0.5;
 8 |   position:relative;
 9 |   opacity:0;
10 |   top:10px;
11 | }
12 | .slide-reveal.ng-enter-active {
13 |   top:0;
14 |   opacity:1;
15 | }
16 | 
17 | .expand.ng-enter {
18 |   -webkit-transition:0.3s cubic-bezier(0.250, 0.460, 0.450, 0.940) all;
19 |   -moz-transition:0.3s cubic-bezier(0.250, 0.460, 0.450, 0.940) all;
20 |   -o-transition:0.3s cubic-bezier(0.250, 0.460, 0.450, 0.940) all;
21 |   transition:0.3s cubic-bezier(0.250, 0.460, 0.450, 0.940) all;
22 | 
23 |   opacity:0;
24 |   max-height:0;
25 |   overflow:hidden;
26 | }
27 | .expand.ng-enter-active {
28 |   opacity:1;
29 |   max-height:40px;
30 | }
31 | 
32 | .expand.ng-leave {
33 |   -webkit-transition:0.3s cubic-bezier(0.250, 0.460, 0.450, 0.940) all;
34 |   -moz-transition:0.3s cubic-bezier(0.250, 0.460, 0.450, 0.940) all;
35 |   -o-transition:0.3s cubic-bezier(0.250, 0.460, 0.450, 0.940) all;
36 |   transition:0.3s cubic-bezier(0.250, 0.460, 0.450, 0.940) all;
37 | 
38 |   opacity:1;
39 |   max-height:40px;
40 |   overflow:hidden;
41 | }
42 | .expand.ng-leave-active {
43 |   opacity:0;
44 |   max-height:0;
45 | }
46 | 


--------------------------------------------------------------------------------
/src/templates/css/doc_widgets.css:
--------------------------------------------------------------------------------
  1 | ul.doc-example {
  2 |   list-style-type: none;
  3 |   position: relative;
  4 |   font-size: 14px;
  5 | }
  6 | 
  7 | ul.doc-example > li {
  8 |   border: 2px solid gray;
  9 |   border-radius: 5px;
 10 |   -moz-border-radius: 5px;
 11 |   -webkit-border-radius: 5px;
 12 |   background-color: white;
 13 |   margin-bottom: 20px;
 14 | }
 15 | 
 16 | ul.doc-example > li.doc-example-heading {
 17 |   border: none;
 18 |   border-radius: 0;
 19 |   margin-bottom: -10px;
 20 | }
 21 | 
 22 | span.nojsfiddle {
 23 |   float: right;
 24 |   font-size: 14px;
 25 |   margin-right:10px;
 26 |   margin-top: 10px;
 27 | }
 28 | 
 29 | form.jsfiddle {
 30 |   position: absolute;
 31 |   right: 0;
 32 |   z-index: 1;
 33 |   height: 14px;
 34 | }
 35 | 
 36 | form.jsfiddle button {
 37 |   cursor: pointer;
 38 |   padding: 4px 10px;
 39 |   margin: 10px;
 40 |   background-color: #FFF;
 41 |   font-weight: bold;
 42 |   color: #7989D6;
 43 |   border-color: #7989D6;
 44 |   -moz-border-radius: 8px;
 45 |   -webkit-border-radius:8px;
 46 |   border-radius: 8px;
 47 | }
 48 | 
 49 | form.jsfiddle textarea, form.jsfiddle input {
 50 |   display: none;
 51 | }
 52 | 
 53 | li.doc-example-live {
 54 |   padding: 10px;
 55 |   font-size: 1.2em;
 56 | }
 57 | 
 58 | div.syntaxhighlighter {
 59 |   padding-bottom: 1px !important; /* fix to remove unnecessary scrollbars http://is.gd/gSMgC */
 60 | }
 61 | 
 62 | /* TABS - tutorial environment navigation */
 63 | 
 64 | div.tabs-nav {
 65 |   height: 25px;
 66 |   position: relative;
 67 | }
 68 | 
 69 | div.tabs-nav ul li {
 70 |   list-style: none;
 71 |   display: inline-block;
 72 |   padding: 5px 10px;
 73 | }
 74 | 
 75 | div.tabs-nav ul li.current a {
 76 |   color: white;
 77 |   text-decoration: none;
 78 | }
 79 | 
 80 | div.tabs-nav ul li.current {
 81 |   background: #7989D6;
 82 |   -moz-box-shadow: 4px 4px 6px #48577D;
 83 |   -moz-border-radius-topright: 8px;
 84 |   -moz-border-radius-topleft: 8px;
 85 |   box-shadow: 4px 4px 6px #48577D;
 86 |   border-radius-topright: 8px;
 87 |   border-radius-topleft: 8px;
 88 |   -webkit-box-shadow: 4px 4px 6px #48577D;
 89 |   -webkit-border-top-right-radius: 8px;
 90 |   -webkit-border-top-left-radius: 8px;
 91 |   border-top-right-radius: 8px;
 92 |   border-top-left-radius: 8px;
 93 | }
 94 | 
 95 | div.tabs-content {
 96 |   padding: 4px;
 97 |   position: relative;
 98 |   background: #7989D6;
 99 |   -moz-border-radius: 8px;
100 |   border-radius: 8px;
101 |   -webkit-border-radius: 8px;
102 | }
103 | 
104 | div.tabs-content-inner {
105 |   margin: 1px;
106 |   padding: 10px;
107 |   background: white;
108 |   border-radius: 6px;
109 |   -moz-border-radius: 6px;
110 |   -webkit-border-radius: 6px;
111 | }
112 | 
113 | 
114 | /* Tutorial Nav Bar */
115 | 
116 | #tutorial-nav {
117 |   margin: 0.5em 0 1em 0;
118 |   padding: 0;
119 |   list-style-type: none;
120 |   background: #7989D6;
121 | 
122 |   -moz-border-radius: 15px;
123 |   -webkit-border-radius: 15px;
124 |   border-radius: 15px;
125 | 
126 |   -moz-box-shadow: 4px 4px 6px #48577D;
127 |   -webkit-box-shadow: 4px 4px 6px #48577D;
128 |   box-shadow: 4px 4px 6px #48577D;
129 | }
130 | 
131 | 
132 | #tutorial-nav li {
133 |   display: inline;
134 | }
135 | 
136 | 
137 | #tutorial-nav a:link, #tutorial-nav a:visited {
138 |   font-size: 1.2em;
139 |   color: #FFF;
140 |   text-decoration: none;
141 |   text-align: center;
142 |   display: inline-block;
143 |   width: 11em;
144 |   padding: 0.2em 0;
145 | }
146 | 
147 | 
148 | #tutorial-nav a:hover {
149 |   color: #000;
150 | }
151 | 


--------------------------------------------------------------------------------
/src/templates/css/docs.css:
--------------------------------------------------------------------------------
  1 | img.AngularJS-small {
  2 |   width: 95px;
  3 |   height: 25px;
  4 | }
  5 | 
  6 | /* this is here to avoid the display=block shuffling of ngShow */
  7 | .breadcrumb li > * {
  8 |   float:left;
  9 |   margin:0 2px 0 0;
 10 | }
 11 | 
 12 | .breadcrumb {
 13 |   padding-top: 6px;
 14 |   padding-bottom: 0;
 15 |   line-height: 18px
 16 | }
 17 | 
 18 | .navbar img {
 19 |   max-height: 40px;
 20 |   padding-right: 20px;
 21 | }
 22 | 
 23 | .navbar img+.brand {
 24 |   padding: 10px 20px 10px 10px;
 25 | }
 26 | 
 27 | .clear-navbar {
 28 |   margin-top: 60px;
 29 | }
 30 | 
 31 | .footer {
 32 |   padding-top: 2em;
 33 |   background-color: #333;
 34 |   color: white;
 35 |   padding-bottom: 2em;
 36 | }
 37 | 
 38 | .spacer {
 39 |   height: 1em;
 40 | }
 41 | 
 42 | 
 43 | .icon-cog {
 44 |   line-height: 13px;
 45 | }
 46 | 
 47 | /* =============================== */
 48 | 
 49 | .form-search {
 50 |   margin-right: 10px;
 51 | }
 52 | 
 53 | .form-search .search-query {
 54 |   width: 180px;
 55 |   width: 200px \9;
 56 | }
 57 | 
 58 | .form-search .dropdown-menu {
 59 |   margin-left: 10px;
 60 | }
 61 | 
 62 | .form-search .code {
 63 |   font-family: monospace;
 64 |   font-weight: bold;
 65 |   font-size: 13px;
 66 |   color: black;
 67 | }
 68 | 
 69 | .form-search > ul.nav > li > a {
 70 |   margin: 0;
 71 |   overflow: auto;
 72 | }
 73 | 
 74 | .form-search > ul.nav > li.module {
 75 |   background-color: #d3d3d3;
 76 | }
 77 | 
 78 | .form-search > ul.nav > li.section {
 79 |   background-color: #ebebeb;
 80 |   min-height: 14px;
 81 | }
 82 | 
 83 | .form-search > ul.nav > li.first {
 84 |   padding-top: 6px;
 85 | }
 86 | 
 87 | .form-search > ul.nav > li.last {
 88 |   padding-bottom: 6px;
 89 | }
 90 | 
 91 | .form-search > ul.nav > li.last + li.api-list-item {
 92 |   margin-top: -6px;
 93 |   padding-bottom: 6px;
 94 | }
 95 | 
 96 | .form-search .well {
 97 |   border-color: #d3d3d3;
 98 |   padding: 0;
 99 |   margin-bottom: 15px;
100 | }
101 | 
102 | .form-search .well .nav-header {
103 |   text-transform: none;
104 |   padding: 3px 1px;
105 |   margin: 0;
106 | }
107 | 
108 | .form-search .well .nav-header a {
109 |   text-transform: none;
110 |   color: black;
111 | }
112 | .form-search .well .nav-header a:hover {
113 |   background-color: inherit;
114 | }
115 | 
116 | .form-search .well li {
117 |   line-height: 14px;
118 | }
119 | 
120 | .form-search .well li a:focus {
121 | 	outline: none;
122 | }
123 | 
124 | .form-search .well .guide {
125 |   float: right;
126 |   padding-top: 0;
127 |   color: gray;
128 | }
129 | 
130 | .form-search .module .guide {
131 |   line-height: 20px;
132 | }
133 | 
134 | .match > a, .nav > .match > a:hover {
135 | 	background-color: #dbeaf4;
136 | }
137 | 
138 | /* =============================== */
139 | /*            Content              */
140 | /* =============================== */
141 | 
142 | .improve-docs {
143 |   float: right;
144 | }
145 | 
146 | .hint {
147 |   font-size: .6em;
148 |   color: #c0c0c0;
149 |   display: block;
150 | }
151 | 
152 | .content code {
153 |   background-color: inherit;
154 |   color: inherit;
155 |   border: none;
156 |   padding: 0;
157 |   font-size: inherit;
158 |   font-family: monospace;
159 | }
160 | 
161 | .content h2,
162 | .content h3,
163 | .content h4,
164 | .content h5 {
165 |   margin: 1em 0 5px;
166 | }
167 | 
168 | .content h1 {
169 |   font-size: 30px;
170 |   line-height: 36px;
171 | }
172 | 
173 | .content h2 {
174 |   font-size: 24px;
175 |   line-height: 36px;
176 | }
177 | 
178 | .content h3 {
179 |   line-height: 27px;
180 |   font-size: 18px;
181 | }
182 | 
183 | .content h4 {
184 |   font-size: 15px;
185 | }
186 | 
187 | ul.parameters > li > p,
188 | .returns > p {
189 |   display: inline;
190 | }
191 | 
192 | ul.methods > li,
193 | ul.properties > li,
194 | ul.events > li {
195 |   list-style: none;
196 |   min-height: 20px;
197 |   padding: 19px;
198 |   margin-bottom: 20px;
199 |   background-color: #f5f5f5;
200 |   border: 1px solid #eee;
201 |   border: 1px solid rgba(0, 0, 0, 0.05);
202 |   -webkit-border-radius: 4px;
203 |   -moz-border-radius: 4px;
204 |   border-radius: 4px;
205 |   -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05);
206 |   -moz-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05);
207 |   box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05);
208 | }
209 | 
210 | .member.method > h2,
211 | .member.property > h2,
212 | .member.event > h2 {
213 |   margin-bottom: .5em;
214 | }
215 | 
216 | ul.methods > li > h3,
217 | ul.properties > li > h3,
218 | ul.events > li > h3 {
219 |   margin: -19px -19px 1em -19px;
220 |   padding: .25em 19px;
221 |   background-color: #d3d3d3;
222 |   font-family: monospace;
223 | }
224 | 
225 | .center {
226 |   display: block;
227 |   margin: 2em auto;
228 | }
229 | 
230 | .diagram {
231 |   display: block;
232 |   margin: 2em auto;
233 |   padding: 1em;
234 |   border: 1px solid black;
235 | 
236 |   -moz-box-shadow: 4px 4px 6px #48577D;
237 |   -webkit-box-shadow: 4px 4px 6px #48577D;
238 |   box-shadow: 4px 4px 6px #48577D;
239 | 
240 |   -moz-border-radius: 15px;
241 |   -webkit-border-radius: 15px;
242 |   border-radius: 15px;
243 | }
244 | 
245 | .tutorial-nav {
246 |   margin-left: 175px;
247 |   color: black;
248 |   margin-top: 2em;
249 |   margin-bottom: 2em;
250 | }
251 | 
252 | .tutorial-nav a {
253 |   color: white;
254 | }
255 | 
256 | .tutorial-nav a:hover {
257 |   color: white;
258 |   text-decoration: none;
259 | }
260 | 
261 | .clear {
262 |   clear: both;
263 | }
264 | 
265 | .variables-matrix td {
266 |   vertical-align:top;
267 |   padding:5px;
268 | }
269 | 
270 | .type-hint {
271 |   display:inline-block;
272 | }
273 | 
274 | .variables-matrix .type-hint {
275 |   text-align:center;
276 |   display:block;
277 |   min-width:60px;
278 | }
279 | 
280 | .type-hint + .type-hint {
281 |   margin-top:5px;
282 | }
283 | 
284 | .type-hint-string {
285 |   background:#3a87ad;
286 | }
287 | 
288 | .type-hint-object {
289 |   background:#999;
290 | }
291 | 
292 | .type-hint-array {
293 |   background:#F90;;
294 | }
295 | 
296 | .type-hint-boolean {
297 |   background:rgb(18, 131, 39);
298 | }
299 | 
300 | .type-hint-number {
301 |   background:rgb(189, 63, 66);
302 | }
303 | 


--------------------------------------------------------------------------------
/src/templates/css/font-awesome.css:
--------------------------------------------------------------------------------
   1 | /*!
   2 |  *  Font Awesome 3.1.0
   3 |  *  the iconic font designed for Bootstrap
   4 |  *  -------------------------------------------------------
   5 |  *  The full suite of pictographic icons, examples, and documentation
   6 |  *  can be found at: http://fontawesome.io
   7 |  *
   8 |  *  License
   9 |  *  -------------------------------------------------------
  10 |  *  - The Font Awesome font is licensed under the SIL Open Font License v1.1 -
  11 |  *    http://scripts.sil.org/OFL
  12 |  *  - Font Awesome CSS, LESS, and SASS files are licensed under the MIT License -
  13 |  *    http://opensource.org/licenses/mit-license.html
  14 |  *  - Font Awesome documentation licensed under CC BY 3.0 License -
  15 |  *    http://creativecommons.org/licenses/by/3.0/
  16 |  *  - Attribution is no longer required in Font Awesome 3.0, but much appreciated:
  17 |  *    "Font Awesome by Dave Gandy - http://fontawesome.io"
  18 | 
  19 |  *  Contact
  20 |  *  -------------------------------------------------------
  21 |  *  Email: dave@fontawesome.io
  22 |  *  Twitter: http://twitter.com/fortaweso_me
  23 |  *  Work: Lead Product Designer @ http://kyruus.com
  24 |  */
  25 | /* FONT PATH
  26 |  * -------------------------- */
  27 | @font-face {
  28 |   font-family: 'FontAwesome';
  29 |   src: url('../font/fontawesome-webfont.eot?v=3.1.0');
  30 |   src: url('../font/fontawesome-webfont.eot?#iefix&v=3.1.0') format('embedded-opentype'), url('../font/fontawesome-webfont.woff?v=3.1.0') format('woff'), url('../font/fontawesome-webfont.ttf?v=3.1.0') format('truetype'), url('../font/fontawesome-webfont.svg#fontawesomeregular?v=3.1.0') format('svg');
  31 |   font-weight: normal;
  32 |   font-style: normal;
  33 | }
  34 | /* FONT AWESOME CORE
  35 |  * -------------------------- */
  36 | [class^="icon-"],
  37 | [class*=" icon-"] {
  38 |   font-family: FontAwesome;
  39 |   font-weight: normal;
  40 |   font-style: normal;
  41 |   text-decoration: inherit;
  42 |   -webkit-font-smoothing: antialiased;
  43 |   *margin-right: .3em;
  44 | }
  45 | [class^="icon-"]:before,
  46 | [class*=" icon-"]:before {
  47 |   text-decoration: inherit;
  48 |   display: inline-block;
  49 |   speak: none;
  50 | }
  51 | /* makes the font 33% larger relative to the icon container */
  52 | .icon-large:before {
  53 |   vertical-align: -10%;
  54 |   font-size: 1.3333333333333333em;
  55 | }
  56 | /* makes sure icons active on rollover in links */
  57 | a [class^="icon-"],
  58 | a [class*=" icon-"],
  59 | a [class^="icon-"]:before,
  60 | a [class*=" icon-"]:before {
  61 |   display: inline;
  62 | }
  63 | /* increased font size for icon-large */
  64 | [class^="icon-"].icon-fixed-width,
  65 | [class*=" icon-"].icon-fixed-width {
  66 |   display: inline-block;
  67 |   width: 1.2857142857142858em;
  68 |   text-align: center;
  69 | }
  70 | [class^="icon-"].icon-fixed-width.icon-large,
  71 | [class*=" icon-"].icon-fixed-width.icon-large {
  72 |   width: 1.5714285714285714em;
  73 | }
  74 | ul.icons-ul {
  75 |   list-style-type: none;
  76 |   text-indent: -0.7142857142857143em;
  77 |   margin-left: 2.142857142857143em;
  78 | }
  79 | ul.icons-ul > li .icon-li {
  80 |   width: 0.7142857142857143em;
  81 |   display: inline-block;
  82 |   text-align: center;
  83 | }
  84 | [class^="icon-"].hide,
  85 | [class*=" icon-"].hide {
  86 |   display: none;
  87 | }
  88 | .icon-muted {
  89 |   color: #eeeeee;
  90 | }
  91 | .icon-light {
  92 |   color: #ffffff;
  93 | }
  94 | .icon-dark {
  95 |   color: #333333;
  96 | }
  97 | .icon-border {
  98 |   border: solid 1px #eeeeee;
  99 |   padding: .2em .25em .15em;
 100 |   -webkit-border-radius: 3px;
 101 |   -moz-border-radius: 3px;
 102 |   border-radius: 3px;
 103 | }
 104 | .icon-2x {
 105 |   font-size: 2em;
 106 | }
 107 | .icon-2x.icon-border {
 108 |   border-width: 2px;
 109 |   -webkit-border-radius: 4px;
 110 |   -moz-border-radius: 4px;
 111 |   border-radius: 4px;
 112 | }
 113 | .icon-3x {
 114 |   font-size: 3em;
 115 | }
 116 | .icon-3x.icon-border {
 117 |   border-width: 3px;
 118 |   -webkit-border-radius: 5px;
 119 |   -moz-border-radius: 5px;
 120 |   border-radius: 5px;
 121 | }
 122 | .icon-4x {
 123 |   font-size: 4em;
 124 | }
 125 | .icon-4x.icon-border {
 126 |   border-width: 4px;
 127 |   -webkit-border-radius: 6px;
 128 |   -moz-border-radius: 6px;
 129 |   border-radius: 6px;
 130 | }
 131 | .icon-5x {
 132 |   font-size: 5em;
 133 | }
 134 | .icon-5x.icon-border {
 135 |   border-width: 5px;
 136 |   -webkit-border-radius: 7px;
 137 |   -moz-border-radius: 7px;
 138 |   border-radius: 7px;
 139 | }
 140 | .pull-right {
 141 |   float: right;
 142 | }
 143 | .pull-left {
 144 |   float: left;
 145 | }
 146 | [class^="icon-"].pull-left,
 147 | [class*=" icon-"].pull-left {
 148 |   margin-right: .3em;
 149 | }
 150 | [class^="icon-"].pull-right,
 151 | [class*=" icon-"].pull-right {
 152 |   margin-left: .3em;
 153 | }
 154 | /* BOOTSTRAP SPECIFIC CLASSES
 155 |  * -------------------------- */
 156 | /* Bootstrap 2.0 sprites.less reset */
 157 | [class^="icon-"],
 158 | [class*=" icon-"] {
 159 |   display: inline;
 160 |   width: auto;
 161 |   height: auto;
 162 |   line-height: normal;
 163 |   vertical-align: baseline;
 164 |   background-image: none;
 165 |   background-position: 0% 0%;
 166 |   background-repeat: repeat;
 167 |   margin-top: 0;
 168 | }
 169 | /* more sprites.less reset */
 170 | .icon-white,
 171 | .nav-pills > .active > a > [class^="icon-"],
 172 | .nav-pills > .active > a > [class*=" icon-"],
 173 | .nav-list > .active > a > [class^="icon-"],
 174 | .nav-list > .active > a > [class*=" icon-"],
 175 | .navbar-inverse .nav > .active > a > [class^="icon-"],
 176 | .navbar-inverse .nav > .active > a > [class*=" icon-"],
 177 | .dropdown-menu > li > a:hover > [class^="icon-"],
 178 | .dropdown-menu > li > a:hover > [class*=" icon-"],
 179 | .dropdown-menu > .active > a > [class^="icon-"],
 180 | .dropdown-menu > .active > a > [class*=" icon-"],
 181 | .dropdown-submenu:hover > a > [class^="icon-"],
 182 | .dropdown-submenu:hover > a > [class*=" icon-"] {
 183 |   background-image: none;
 184 | }
 185 | /* keeps Bootstrap styles with and without icons the same */
 186 | .btn [class^="icon-"].icon-large,
 187 | .nav [class^="icon-"].icon-large,
 188 | .btn [class*=" icon-"].icon-large,
 189 | .nav [class*=" icon-"].icon-large {
 190 |   line-height: .9em;
 191 | }
 192 | .btn [class^="icon-"].icon-spin,
 193 | .nav [class^="icon-"].icon-spin,
 194 | .btn [class*=" icon-"].icon-spin,
 195 | .nav [class*=" icon-"].icon-spin {
 196 |   display: inline-block;
 197 | }
 198 | .nav-tabs [class^="icon-"],
 199 | .nav-pills [class^="icon-"],
 200 | .nav-tabs [class*=" icon-"],
 201 | .nav-pills [class*=" icon-"],
 202 | .nav-tabs [class^="icon-"].icon-large,
 203 | .nav-pills [class^="icon-"].icon-large,
 204 | .nav-tabs [class*=" icon-"].icon-large,
 205 | .nav-pills [class*=" icon-"].icon-large {
 206 |   line-height: .9em;
 207 | }
 208 | .btn [class^="icon-"].pull-left.icon-2x,
 209 | .btn [class*=" icon-"].pull-left.icon-2x,
 210 | .btn [class^="icon-"].pull-right.icon-2x,
 211 | .btn [class*=" icon-"].pull-right.icon-2x {
 212 |   margin-top: .18em;
 213 | }
 214 | .btn [class^="icon-"].icon-spin.icon-large,
 215 | .btn [class*=" icon-"].icon-spin.icon-large {
 216 |   line-height: .8em;
 217 | }
 218 | .btn.btn-small [class^="icon-"].pull-left.icon-2x,
 219 | .btn.btn-small [class*=" icon-"].pull-left.icon-2x,
 220 | .btn.btn-small [class^="icon-"].pull-right.icon-2x,
 221 | .btn.btn-small [class*=" icon-"].pull-right.icon-2x {
 222 |   margin-top: .25em;
 223 | }
 224 | .btn.btn-large [class^="icon-"],
 225 | .btn.btn-large [class*=" icon-"] {
 226 |   margin-top: 0;
 227 | }
 228 | .btn.btn-large [class^="icon-"].pull-left.icon-2x,
 229 | .btn.btn-large [class*=" icon-"].pull-left.icon-2x,
 230 | .btn.btn-large [class^="icon-"].pull-right.icon-2x,
 231 | .btn.btn-large [class*=" icon-"].pull-right.icon-2x {
 232 |   margin-top: .05em;
 233 | }
 234 | .btn.btn-large [class^="icon-"].pull-left.icon-2x,
 235 | .btn.btn-large [class*=" icon-"].pull-left.icon-2x {
 236 |   margin-right: .2em;
 237 | }
 238 | .btn.btn-large [class^="icon-"].pull-right.icon-2x,
 239 | .btn.btn-large [class*=" icon-"].pull-right.icon-2x {
 240 |   margin-left: .2em;
 241 | }
 242 | /* EXTRAS
 243 |  * -------------------------- */
 244 | /* Stacked and layered icon */
 245 | .icon-stack {
 246 |   position: relative;
 247 |   display: inline-block;
 248 |   width: 2em;
 249 |   height: 2em;
 250 |   line-height: 2em;
 251 |   vertical-align: -35%;
 252 | }
 253 | .icon-stack [class^="icon-"],
 254 | .icon-stack [class*=" icon-"] {
 255 |   display: block;
 256 |   text-align: center;
 257 |   position: absolute;
 258 |   width: 100%;
 259 |   height: 100%;
 260 |   font-size: 1em;
 261 |   line-height: inherit;
 262 |   *line-height: 2em;
 263 | }
 264 | .icon-stack .icon-stack-base {
 265 |   font-size: 2em;
 266 |   *line-height: 1em;
 267 | }
 268 | /* Animated rotating icon */
 269 | .icon-spin {
 270 |   display: inline-block;
 271 |   -moz-animation: spin 2s infinite linear;
 272 |   -o-animation: spin 2s infinite linear;
 273 |   -webkit-animation: spin 2s infinite linear;
 274 |   animation: spin 2s infinite linear;
 275 | }
 276 | @-moz-keyframes spin {
 277 |   0% {
 278 |     -moz-transform: rotate(0deg);
 279 |   }
 280 |   100% {
 281 |     -moz-transform: rotate(359deg);
 282 |   }
 283 | }
 284 | @-webkit-keyframes spin {
 285 |   0% {
 286 |     -webkit-transform: rotate(0deg);
 287 |   }
 288 |   100% {
 289 |     -webkit-transform: rotate(359deg);
 290 |   }
 291 | }
 292 | @-o-keyframes spin {
 293 |   0% {
 294 |     -o-transform: rotate(0deg);
 295 |   }
 296 |   100% {
 297 |     -o-transform: rotate(359deg);
 298 |   }
 299 | }
 300 | @-ms-keyframes spin {
 301 |   0% {
 302 |     -ms-transform: rotate(0deg);
 303 |   }
 304 |   100% {
 305 |     -ms-transform: rotate(359deg);
 306 |   }
 307 | }
 308 | @keyframes spin {
 309 |   0% {
 310 |     transform: rotate(0deg);
 311 |   }
 312 |   100% {
 313 |     transform: rotate(359deg);
 314 |   }
 315 | }
 316 | /* Icon rotations and mirroring */
 317 | .icon-rotate-90:before {
 318 |   -webkit-transform: rotate(90deg);
 319 |   -moz-transform: rotate(90deg);
 320 |   -ms-transform: rotate(90deg);
 321 |   -o-transform: rotate(90deg);
 322 |   transform: rotate(90deg);
 323 |   filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=1);
 324 | }
 325 | .icon-rotate-180:before {
 326 |   -webkit-transform: rotate(180deg);
 327 |   -moz-transform: rotate(180deg);
 328 |   -ms-transform: rotate(180deg);
 329 |   -o-transform: rotate(180deg);
 330 |   transform: rotate(180deg);
 331 |   filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=2);
 332 | }
 333 | .icon-rotate-270:before {
 334 |   -webkit-transform: rotate(270deg);
 335 |   -moz-transform: rotate(270deg);
 336 |   -ms-transform: rotate(270deg);
 337 |   -o-transform: rotate(270deg);
 338 |   transform: rotate(270deg);
 339 |   filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=3);
 340 | }
 341 | .icon-flip-horizontal:before {
 342 |   -webkit-transform: scale(-1, 1);
 343 |   -moz-transform: scale(-1, 1);
 344 |   -ms-transform: scale(-1, 1);
 345 |   -o-transform: scale(-1, 1);
 346 |   transform: scale(-1, 1);
 347 | }
 348 | .icon-flip-vertical:before {
 349 |   -webkit-transform: scale(1, -1);
 350 |   -moz-transform: scale(1, -1);
 351 |   -ms-transform: scale(1, -1);
 352 |   -o-transform: scale(1, -1);
 353 |   transform: scale(1, -1);
 354 | }
 355 | /* Font Awesome uses the Unicode Private Use Area (PUA) to ensure screen
 356 |    readers do not read off random characters that represent icons */
 357 | .icon-glass:before {
 358 |   content: "\f000";
 359 | }
 360 | .icon-music:before {
 361 |   content: "\f001";
 362 | }
 363 | .icon-search:before {
 364 |   content: "\f002";
 365 | }
 366 | .icon-envelope:before {
 367 |   content: "\f003";
 368 | }
 369 | .icon-heart:before {
 370 |   content: "\f004";
 371 | }
 372 | .icon-star:before {
 373 |   content: "\f005";
 374 | }
 375 | .icon-star-empty:before {
 376 |   content: "\f006";
 377 | }
 378 | .icon-user:before {
 379 |   content: "\f007";
 380 | }
 381 | .icon-film:before {
 382 |   content: "\f008";
 383 | }
 384 | .icon-th-large:before {
 385 |   content: "\f009";
 386 | }
 387 | .icon-th:before {
 388 |   content: "\f00a";
 389 | }
 390 | .icon-th-list:before {
 391 |   content: "\f00b";
 392 | }
 393 | .icon-ok:before {
 394 |   content: "\f00c";
 395 | }
 396 | .icon-remove:before {
 397 |   content: "\f00d";
 398 | }
 399 | .icon-zoom-in:before {
 400 |   content: "\f00e";
 401 | }
 402 | .icon-zoom-out:before {
 403 |   content: "\f010";
 404 | }
 405 | .icon-off:before {
 406 |   content: "\f011";
 407 | }
 408 | .icon-signal:before {
 409 |   content: "\f012";
 410 | }
 411 | .icon-cog:before {
 412 |   content: "\f013";
 413 | }
 414 | .icon-trash:before {
 415 |   content: "\f014";
 416 | }
 417 | .icon-home:before {
 418 |   content: "\f015";
 419 | }
 420 | .icon-file:before {
 421 |   content: "\f016";
 422 | }
 423 | .icon-time:before {
 424 |   content: "\f017";
 425 | }
 426 | .icon-road:before {
 427 |   content: "\f018";
 428 | }
 429 | .icon-download-alt:before {
 430 |   content: "\f019";
 431 | }
 432 | .icon-download:before {
 433 |   content: "\f01a";
 434 | }
 435 | .icon-upload:before {
 436 |   content: "\f01b";
 437 | }
 438 | .icon-inbox:before {
 439 |   content: "\f01c";
 440 | }
 441 | .icon-play-circle:before {
 442 |   content: "\f01d";
 443 | }
 444 | .icon-repeat:before,
 445 | .icon-rotate-right:before {
 446 |   content: "\f01e";
 447 | }
 448 | /* F020 doesn't work in Safari. all shifted one down */
 449 | .icon-refresh:before {
 450 |   content: "\f021";
 451 | }
 452 | .icon-list-alt:before {
 453 |   content: "\f022";
 454 | }
 455 | .icon-lock:before {
 456 |   content: "\f023";
 457 | }
 458 | .icon-flag:before {
 459 |   content: "\f024";
 460 | }
 461 | .icon-headphones:before {
 462 |   content: "\f025";
 463 | }
 464 | .icon-volume-off:before {
 465 |   content: "\f026";
 466 | }
 467 | .icon-volume-down:before {
 468 |   content: "\f027";
 469 | }
 470 | .icon-volume-up:before {
 471 |   content: "\f028";
 472 | }
 473 | .icon-qrcode:before {
 474 |   content: "\f029";
 475 | }
 476 | .icon-barcode:before {
 477 |   content: "\f02a";
 478 | }
 479 | .icon-tag:before {
 480 |   content: "\f02b";
 481 | }
 482 | .icon-tags:before {
 483 |   content: "\f02c";
 484 | }
 485 | .icon-book:before {
 486 |   content: "\f02d";
 487 | }
 488 | .icon-bookmark:before {
 489 |   content: "\f02e";
 490 | }
 491 | .icon-print:before {
 492 |   content: "\f02f";
 493 | }
 494 | .icon-camera:before {
 495 |   content: "\f030";
 496 | }
 497 | .icon-font:before {
 498 |   content: "\f031";
 499 | }
 500 | .icon-bold:before {
 501 |   content: "\f032";
 502 | }
 503 | .icon-italic:before {
 504 |   content: "\f033";
 505 | }
 506 | .icon-text-height:before {
 507 |   content: "\f034";
 508 | }
 509 | .icon-text-width:before {
 510 |   content: "\f035";
 511 | }
 512 | .icon-align-left:before {
 513 |   content: "\f036";
 514 | }
 515 | .icon-align-center:before {
 516 |   content: "\f037";
 517 | }
 518 | .icon-align-right:before {
 519 |   content: "\f038";
 520 | }
 521 | .icon-align-justify:before {
 522 |   content: "\f039";
 523 | }
 524 | .icon-list:before {
 525 |   content: "\f03a";
 526 | }
 527 | .icon-indent-left:before {
 528 |   content: "\f03b";
 529 | }
 530 | .icon-indent-right:before {
 531 |   content: "\f03c";
 532 | }
 533 | .icon-facetime-video:before {
 534 |   content: "\f03d";
 535 | }
 536 | .icon-picture:before {
 537 |   content: "\f03e";
 538 | }
 539 | .icon-pencil:before {
 540 |   content: "\f040";
 541 | }
 542 | .icon-map-marker:before {
 543 |   content: "\f041";
 544 | }
 545 | .icon-adjust:before {
 546 |   content: "\f042";
 547 | }
 548 | .icon-tint:before {
 549 |   content: "\f043";
 550 | }
 551 | .icon-edit:before {
 552 |   content: "\f044";
 553 | }
 554 | .icon-share:before {
 555 |   content: "\f045";
 556 | }
 557 | .icon-check:before {
 558 |   content: "\f046";
 559 | }
 560 | .icon-move:before {
 561 |   content: "\f047";
 562 | }
 563 | .icon-step-backward:before {
 564 |   content: "\f048";
 565 | }
 566 | .icon-fast-backward:before {
 567 |   content: "\f049";
 568 | }
 569 | .icon-backward:before {
 570 |   content: "\f04a";
 571 | }
 572 | .icon-play:before {
 573 |   content: "\f04b";
 574 | }
 575 | .icon-pause:before {
 576 |   content: "\f04c";
 577 | }
 578 | .icon-stop:before {
 579 |   content: "\f04d";
 580 | }
 581 | .icon-forward:before {
 582 |   content: "\f04e";
 583 | }
 584 | .icon-fast-forward:before {
 585 |   content: "\f050";
 586 | }
 587 | .icon-step-forward:before {
 588 |   content: "\f051";
 589 | }
 590 | .icon-eject:before {
 591 |   content: "\f052";
 592 | }
 593 | .icon-chevron-left:before {
 594 |   content: "\f053";
 595 | }
 596 | .icon-chevron-right:before {
 597 |   content: "\f054";
 598 | }
 599 | .icon-plus-sign:before {
 600 |   content: "\f055";
 601 | }
 602 | .icon-minus-sign:before {
 603 |   content: "\f056";
 604 | }
 605 | .icon-remove-sign:before {
 606 |   content: "\f057";
 607 | }
 608 | .icon-ok-sign:before {
 609 |   content: "\f058";
 610 | }
 611 | .icon-question-sign:before {
 612 |   content: "\f059";
 613 | }
 614 | .icon-info-sign:before {
 615 |   content: "\f05a";
 616 | }
 617 | .icon-screenshot:before {
 618 |   content: "\f05b";
 619 | }
 620 | .icon-remove-circle:before {
 621 |   content: "\f05c";
 622 | }
 623 | .icon-ok-circle:before {
 624 |   content: "\f05d";
 625 | }
 626 | .icon-ban-circle:before {
 627 |   content: "\f05e";
 628 | }
 629 | .icon-arrow-left:before {
 630 |   content: "\f060";
 631 | }
 632 | .icon-arrow-right:before {
 633 |   content: "\f061";
 634 | }
 635 | .icon-arrow-up:before {
 636 |   content: "\f062";
 637 | }
 638 | .icon-arrow-down:before {
 639 |   content: "\f063";
 640 | }
 641 | .icon-share-alt:before,
 642 | .icon-mail-forward:before {
 643 |   content: "\f064";
 644 | }
 645 | .icon-resize-full:before {
 646 |   content: "\f065";
 647 | }
 648 | .icon-resize-small:before {
 649 |   content: "\f066";
 650 | }
 651 | .icon-plus:before {
 652 |   content: "\f067";
 653 | }
 654 | .icon-minus:before {
 655 |   content: "\f068";
 656 | }
 657 | .icon-asterisk:before {
 658 |   content: "\f069";
 659 | }
 660 | .icon-exclamation-sign:before {
 661 |   content: "\f06a";
 662 | }
 663 | .icon-gift:before {
 664 |   content: "\f06b";
 665 | }
 666 | .icon-leaf:before {
 667 |   content: "\f06c";
 668 | }
 669 | .icon-fire:before {
 670 |   content: "\f06d";
 671 | }
 672 | .icon-eye-open:before {
 673 |   content: "\f06e";
 674 | }
 675 | .icon-eye-close:before {
 676 |   content: "\f070";
 677 | }
 678 | .icon-warning-sign:before {
 679 |   content: "\f071";
 680 | }
 681 | .icon-plane:before {
 682 |   content: "\f072";
 683 | }
 684 | .icon-calendar:before {
 685 |   content: "\f073";
 686 | }
 687 | .icon-random:before {
 688 |   content: "\f074";
 689 | }
 690 | .icon-comment:before {
 691 |   content: "\f075";
 692 | }
 693 | .icon-magnet:before {
 694 |   content: "\f076";
 695 | }
 696 | .icon-chevron-up:before {
 697 |   content: "\f077";
 698 | }
 699 | .icon-chevron-down:before {
 700 |   content: "\f078";
 701 | }
 702 | .icon-retweet:before {
 703 |   content: "\f079";
 704 | }
 705 | .icon-shopping-cart:before {
 706 |   content: "\f07a";
 707 | }
 708 | .icon-folder-close:before {
 709 |   content: "\f07b";
 710 | }
 711 | .icon-folder-open:before {
 712 |   content: "\f07c";
 713 | }
 714 | .icon-resize-vertical:before {
 715 |   content: "\f07d";
 716 | }
 717 | .icon-resize-horizontal:before {
 718 |   content: "\f07e";
 719 | }
 720 | .icon-bar-chart:before {
 721 |   content: "\f080";
 722 | }
 723 | .icon-twitter-sign:before {
 724 |   content: "\f081";
 725 | }
 726 | .icon-facebook-sign:before {
 727 |   content: "\f082";
 728 | }
 729 | .icon-camera-retro:before {
 730 |   content: "\f083";
 731 | }
 732 | .icon-key:before {
 733 |   content: "\f084";
 734 | }
 735 | .icon-cogs:before {
 736 |   content: "\f085";
 737 | }
 738 | .icon-comments:before {
 739 |   content: "\f086";
 740 | }
 741 | .icon-thumbs-up:before {
 742 |   content: "\f087";
 743 | }
 744 | .icon-thumbs-down:before {
 745 |   content: "\f088";
 746 | }
 747 | .icon-star-half:before {
 748 |   content: "\f089";
 749 | }
 750 | .icon-heart-empty:before {
 751 |   content: "\f08a";
 752 | }
 753 | .icon-signout:before {
 754 |   content: "\f08b";
 755 | }
 756 | .icon-linkedin-sign:before {
 757 |   content: "\f08c";
 758 | }
 759 | .icon-pushpin:before {
 760 |   content: "\f08d";
 761 | }
 762 | .icon-external-link:before {
 763 |   content: "\f08e";
 764 | }
 765 | .icon-signin:before {
 766 |   content: "\f090";
 767 | }
 768 | .icon-trophy:before {
 769 |   content: "\f091";
 770 | }
 771 | .icon-github-sign:before {
 772 |   content: "\f092";
 773 | }
 774 | .icon-upload-alt:before {
 775 |   content: "\f093";
 776 | }
 777 | .icon-lemon:before {
 778 |   content: "\f094";
 779 | }
 780 | .icon-phone:before {
 781 |   content: "\f095";
 782 | }
 783 | .icon-check-empty:before {
 784 |   content: "\f096";
 785 | }
 786 | .icon-bookmark-empty:before {
 787 |   content: "\f097";
 788 | }
 789 | .icon-phone-sign:before {
 790 |   content: "\f098";
 791 | }
 792 | .icon-twitter:before {
 793 |   content: "\f099";
 794 | }
 795 | .icon-facebook:before {
 796 |   content: "\f09a";
 797 | }
 798 | .icon-github:before {
 799 |   content: "\f09b";
 800 | }
 801 | .icon-unlock:before {
 802 |   content: "\f09c";
 803 | }
 804 | .icon-credit-card:before {
 805 |   content: "\f09d";
 806 | }
 807 | .icon-rss:before {
 808 |   content: "\f09e";
 809 | }
 810 | .icon-hdd:before {
 811 |   content: "\f0a0";
 812 | }
 813 | .icon-bullhorn:before {
 814 |   content: "\f0a1";
 815 | }
 816 | .icon-bell:before {
 817 |   content: "\f0a2";
 818 | }
 819 | .icon-certificate:before {
 820 |   content: "\f0a3";
 821 | }
 822 | .icon-hand-right:before {
 823 |   content: "\f0a4";
 824 | }
 825 | .icon-hand-left:before {
 826 |   content: "\f0a5";
 827 | }
 828 | .icon-hand-up:before {
 829 |   content: "\f0a6";
 830 | }
 831 | .icon-hand-down:before {
 832 |   content: "\f0a7";
 833 | }
 834 | .icon-circle-arrow-left:before {
 835 |   content: "\f0a8";
 836 | }
 837 | .icon-circle-arrow-right:before {
 838 |   content: "\f0a9";
 839 | }
 840 | .icon-circle-arrow-up:before {
 841 |   content: "\f0aa";
 842 | }
 843 | .icon-circle-arrow-down:before {
 844 |   content: "\f0ab";
 845 | }
 846 | .icon-globe:before {
 847 |   content: "\f0ac";
 848 | }
 849 | .icon-wrench:before {
 850 |   content: "\f0ad";
 851 | }
 852 | .icon-tasks:before {
 853 |   content: "\f0ae";
 854 | }
 855 | .icon-filter:before {
 856 |   content: "\f0b0";
 857 | }
 858 | .icon-briefcase:before {
 859 |   content: "\f0b1";
 860 | }
 861 | .icon-fullscreen:before {
 862 |   content: "\f0b2";
 863 | }
 864 | .icon-group:before {
 865 |   content: "\f0c0";
 866 | }
 867 | .icon-link:before {
 868 |   content: "\f0c1";
 869 | }
 870 | .icon-cloud:before {
 871 |   content: "\f0c2";
 872 | }
 873 | .icon-beaker:before {
 874 |   content: "\f0c3";
 875 | }
 876 | .icon-cut:before {
 877 |   content: "\f0c4";
 878 | }
 879 | .icon-copy:before {
 880 |   content: "\f0c5";
 881 | }
 882 | .icon-paper-clip:before {
 883 |   content: "\f0c6";
 884 | }
 885 | .icon-save:before {
 886 |   content: "\f0c7";
 887 | }
 888 | .icon-sign-blank:before {
 889 |   content: "\f0c8";
 890 | }
 891 | .icon-reorder:before {
 892 |   content: "\f0c9";
 893 | }
 894 | .icon-list-ul:before {
 895 |   content: "\f0ca";
 896 | }
 897 | .icon-list-ol:before {
 898 |   content: "\f0cb";
 899 | }
 900 | .icon-strikethrough:before {
 901 |   content: "\f0cc";
 902 | }
 903 | .icon-underline:before {
 904 |   content: "\f0cd";
 905 | }
 906 | .icon-table:before {
 907 |   content: "\f0ce";
 908 | }
 909 | .icon-magic:before {
 910 |   content: "\f0d0";
 911 | }
 912 | .icon-truck:before {
 913 |   content: "\f0d1";
 914 | }
 915 | .icon-pinterest:before {
 916 |   content: "\f0d2";
 917 | }
 918 | .icon-pinterest-sign:before {
 919 |   content: "\f0d3";
 920 | }
 921 | .icon-google-plus-sign:before {
 922 |   content: "\f0d4";
 923 | }
 924 | .icon-google-plus:before {
 925 |   content: "\f0d5";
 926 | }
 927 | .icon-money:before {
 928 |   content: "\f0d6";
 929 | }
 930 | .icon-caret-down:before {
 931 |   content: "\f0d7";
 932 | }
 933 | .icon-caret-up:before {
 934 |   content: "\f0d8";
 935 | }
 936 | .icon-caret-left:before {
 937 |   content: "\f0d9";
 938 | }
 939 | .icon-caret-right:before {
 940 |   content: "\f0da";
 941 | }
 942 | .icon-columns:before {
 943 |   content: "\f0db";
 944 | }
 945 | .icon-sort:before {
 946 |   content: "\f0dc";
 947 | }
 948 | .icon-sort-down:before {
 949 |   content: "\f0dd";
 950 | }
 951 | .icon-sort-up:before {
 952 |   content: "\f0de";
 953 | }
 954 | .icon-envelope-alt:before {
 955 |   content: "\f0e0";
 956 | }
 957 | .icon-linkedin:before {
 958 |   content: "\f0e1";
 959 | }
 960 | .icon-undo:before,
 961 | .icon-rotate-left:before {
 962 |   content: "\f0e2";
 963 | }
 964 | .icon-legal:before {
 965 |   content: "\f0e3";
 966 | }
 967 | .icon-dashboard:before {
 968 |   content: "\f0e4";
 969 | }
 970 | .icon-comment-alt:before {
 971 |   content: "\f0e5";
 972 | }
 973 | .icon-comments-alt:before {
 974 |   content: "\f0e6";
 975 | }
 976 | .icon-bolt:before {
 977 |   content: "\f0e7";
 978 | }
 979 | .icon-sitemap:before {
 980 |   content: "\f0e8";
 981 | }
 982 | .icon-umbrella:before {
 983 |   content: "\f0e9";
 984 | }
 985 | .icon-paste:before {
 986 |   content: "\f0ea";
 987 | }
 988 | .icon-lightbulb:before {
 989 |   content: "\f0eb";
 990 | }
 991 | .icon-exchange:before {
 992 |   content: "\f0ec";
 993 | }
 994 | .icon-cloud-download:before {
 995 |   content: "\f0ed";
 996 | }
 997 | .icon-cloud-upload:before {
 998 |   content: "\f0ee";
 999 | }
1000 | .icon-user-md:before {
1001 |   content: "\f0f0";
1002 | }
1003 | .icon-stethoscope:before {
1004 |   content: "\f0f1";
1005 | }
1006 | .icon-suitcase:before {
1007 |   content: "\f0f2";
1008 | }
1009 | .icon-bell-alt:before {
1010 |   content: "\f0f3";
1011 | }
1012 | .icon-coffee:before {
1013 |   content: "\f0f4";
1014 | }
1015 | .icon-food:before {
1016 |   content: "\f0f5";
1017 | }
1018 | .icon-file-alt:before {
1019 |   content: "\f0f6";
1020 | }
1021 | .icon-building:before {
1022 |   content: "\f0f7";
1023 | }
1024 | .icon-hospital:before {
1025 |   content: "\f0f8";
1026 | }
1027 | .icon-ambulance:before {
1028 |   content: "\f0f9";
1029 | }
1030 | .icon-medkit:before {
1031 |   content: "\f0fa";
1032 | }
1033 | .icon-fighter-jet:before {
1034 |   content: "\f0fb";
1035 | }
1036 | .icon-beer:before {
1037 |   content: "\f0fc";
1038 | }
1039 | .icon-h-sign:before {
1040 |   content: "\f0fd";
1041 | }
1042 | .icon-plus-sign-alt:before {
1043 |   content: "\f0fe";
1044 | }
1045 | .icon-double-angle-left:before {
1046 |   content: "\f100";
1047 | }
1048 | .icon-double-angle-right:before {
1049 |   content: "\f101";
1050 | }
1051 | .icon-double-angle-up:before {
1052 |   content: "\f102";
1053 | }
1054 | .icon-double-angle-down:before {
1055 |   content: "\f103";
1056 | }
1057 | .icon-angle-left:before {
1058 |   content: "\f104";
1059 | }
1060 | .icon-angle-right:before {
1061 |   content: "\f105";
1062 | }
1063 | .icon-angle-up:before {
1064 |   content: "\f106";
1065 | }
1066 | .icon-angle-down:before {
1067 |   content: "\f107";
1068 | }
1069 | .icon-desktop:before {
1070 |   content: "\f108";
1071 | }
1072 | .icon-laptop:before {
1073 |   content: "\f109";
1074 | }
1075 | .icon-tablet:before {
1076 |   content: "\f10a";
1077 | }
1078 | .icon-mobile-phone:before {
1079 |   content: "\f10b";
1080 | }
1081 | .icon-circle-blank:before {
1082 |   content: "\f10c";
1083 | }
1084 | .icon-quote-left:before {
1085 |   content: "\f10d";
1086 | }
1087 | .icon-quote-right:before {
1088 |   content: "\f10e";
1089 | }
1090 | .icon-spinner:before {
1091 |   content: "\f110";
1092 | }
1093 | .icon-circle:before {
1094 |   content: "\f111";
1095 | }
1096 | .icon-reply:before,
1097 | .icon-mail-reply:before {
1098 |   content: "\f112";
1099 | }
1100 | .icon-folder-close-alt:before {
1101 |   content: "\f114";
1102 | }
1103 | .icon-folder-open-alt:before {
1104 |   content: "\f115";
1105 | }
1106 | .icon-expand-alt:before {
1107 |   content: "\f116";
1108 | }
1109 | .icon-collapse-alt:before {
1110 |   content: "\f117";
1111 | }
1112 | .icon-smile:before {
1113 |   content: "\f118";
1114 | }
1115 | .icon-frown:before {
1116 |   content: "\f119";
1117 | }
1118 | .icon-meh:before {
1119 |   content: "\f11a";
1120 | }
1121 | .icon-gamepad:before {
1122 |   content: "\f11b";
1123 | }
1124 | .icon-keyboard:before {
1125 |   content: "\f11c";
1126 | }
1127 | .icon-flag-alt:before {
1128 |   content: "\f11d";
1129 | }
1130 | .icon-flag-checkered:before {
1131 |   content: "\f11e";
1132 | }
1133 | .icon-terminal:before {
1134 |   content: "\f120";
1135 | }
1136 | .icon-code:before {
1137 |   content: "\f121";
1138 | }
1139 | .icon-reply-all:before {
1140 |   content: "\f122";
1141 | }
1142 | .icon-mail-reply-all:before {
1143 |   content: "\f122";
1144 | }
1145 | .icon-star-half-full:before,
1146 | .icon-star-half-empty:before {
1147 |   content: "\f123";
1148 | }
1149 | .icon-location-arrow:before {
1150 |   content: "\f124";
1151 | }
1152 | .icon-crop:before {
1153 |   content: "\f125";
1154 | }
1155 | .icon-code-fork:before {
1156 |   content: "\f126";
1157 | }
1158 | .icon-unlink:before {
1159 |   content: "\f127";
1160 | }
1161 | .icon-question:before {
1162 |   content: "\f128";
1163 | }
1164 | .icon-info:before {
1165 |   content: "\f129";
1166 | }
1167 | .icon-exclamation:before {
1168 |   content: "\f12a";
1169 | }
1170 | .icon-superscript:before {
1171 |   content: "\f12b";
1172 | }
1173 | .icon-subscript:before {
1174 |   content: "\f12c";
1175 | }
1176 | .icon-eraser:before {
1177 |   content: "\f12d";
1178 | }
1179 | .icon-puzzle-piece:before {
1180 |   content: "\f12e";
1181 | }
1182 | .icon-microphone:before {
1183 |   content: "\f130";
1184 | }
1185 | .icon-microphone-off:before {
1186 |   content: "\f131";
1187 | }
1188 | .icon-shield:before {
1189 |   content: "\f132";
1190 | }
1191 | .icon-calendar-empty:before {
1192 |   content: "\f133";
1193 | }
1194 | .icon-fire-extinguisher:before {
1195 |   content: "\f134";
1196 | }
1197 | .icon-rocket:before {
1198 |   content: "\f135";
1199 | }
1200 | .icon-maxcdn:before {
1201 |   content: "\f136";
1202 | }
1203 | .icon-chevron-sign-left:before {
1204 |   content: "\f137";
1205 | }
1206 | .icon-chevron-sign-right:before {
1207 |   content: "\f138";
1208 | }
1209 | .icon-chevron-sign-up:before {
1210 |   content: "\f139";
1211 | }
1212 | .icon-chevron-sign-down:before {
1213 |   content: "\f13a";
1214 | }
1215 | .icon-html5:before {
1216 |   content: "\f13b";
1217 | }
1218 | .icon-css3:before {
1219 |   content: "\f13c";
1220 | }
1221 | .icon-anchor:before {
1222 |   content: "\f13d";
1223 | }
1224 | .icon-unlock-alt:before {
1225 |   content: "\f13e";
1226 | }
1227 | .icon-bullseye:before {
1228 |   content: "\f140";
1229 | }
1230 | .icon-ellipsis-horizontal:before {
1231 |   content: "\f141";
1232 | }
1233 | .icon-ellipsis-vertical:before {
1234 |   content: "\f142";
1235 | }
1236 | .icon-rss-sign:before {
1237 |   content: "\f143";
1238 | }
1239 | .icon-play-sign:before {
1240 |   content: "\f144";
1241 | }
1242 | .icon-ticket:before {
1243 |   content: "\f145";
1244 | }
1245 | .icon-minus-sign-alt:before {
1246 |   content: "\f146";
1247 | }
1248 | .icon-check-minus:before {
1249 |   content: "\f147";
1250 | }
1251 | .icon-level-up:before {
1252 |   content: "\f148";
1253 | }
1254 | .icon-level-down:before {
1255 |   content: "\f149";
1256 | }
1257 | .icon-check-sign:before {
1258 |   content: "\f14a";
1259 | }
1260 | .icon-edit-sign:before {
1261 |   content: "\f14b";
1262 | }
1263 | .icon-external-link-sign:before {
1264 |   content: "\f14c";
1265 | }
1266 | .icon-share-sign:before {
1267 |   content: "\f14d";
1268 | }
1269 | 


--------------------------------------------------------------------------------
/src/templates/css/prettify.css:
--------------------------------------------------------------------------------
 1 | .pln { color: #000 }  /* plain text */
 2 | 
 3 | @media screen {
 4 |   .str { color: #080 }  /* string content */
 5 |   .kwd { color: #008 }  /* a keyword */
 6 |   .com { color: #800 }  /* a comment */
 7 |   .typ { color: #606 }  /* a type name */
 8 |   .lit { color: #066 }  /* a literal value */
 9 |   /* punctuation, lisp open bracket, lisp close bracket */
10 |   .pun, .opn, .clo { color: #660 }
11 |   .tag { color: #008 }  /* a markup tag name */
12 |   .atn { color: #606 }  /* a markup attribute name */
13 |   .atv { color: #080 }  /* a markup attribute value */
14 |   .dec, .var { color: #606 }  /* a declaration; a variable name */
15 |   .fun { color: red }  /* a function name */
16 | }
17 | 
18 | /* Use higher contrast and text-weight for printable form. */
19 | @media print, projection {
20 |   .str { color: #060 }
21 |   .kwd { color: #006; font-weight: bold }
22 |   .com { color: #600; font-style: italic }
23 |   .typ { color: #404; font-weight: bold }
24 |   .lit { color: #044 }
25 |   .pun, .opn, .clo { color: #440 }
26 |   .tag { color: #006; font-weight: bold }
27 |   .atn { color: #404 }
28 |   .atv { color: #060 }
29 | }
30 | 
31 | pre.prettyprint {
32 |   padding: 8px;
33 |   border: 1px solid #e1e1e8;
34 | }
35 | pre.prettyprint:not(.alert) {
36 |   background-color: #f7f7f9;
37 | }
38 | 
39 | pre.prettyprint.linenums {
40 |   -webkit-box-shadow: inset 40px 0 0 #fbfbfc, inset 41px 0 0 #ececf0;
41 |      -moz-box-shadow: inset 40px 0 0 #fbfbfc, inset 41px 0 0 #ececf0;
42 |           box-shadow: inset 40px 0 0 #fbfbfc, inset 41px 0 0 #ececf0;
43 | }
44 | ol.linenums {
45 |   margin: 0 0 0 33px; /* IE indents via margin-left */
46 | } 
47 | ol.linenums li {
48 |   padding-left: 12px;
49 |   font-size:12px;
50 |   color: #bebec5;
51 |   line-height: 18px;
52 |   text-shadow: 0 1px 0 #fff;
53 |   list-style-type:decimal!important;
54 | }
55 | 


--------------------------------------------------------------------------------
/src/templates/font/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/nikhilmodak/gulp-ngdocs/84d412873727426a0b616243b42668e1e3ba7474/src/templates/font/FontAwesome.otf


--------------------------------------------------------------------------------
/src/templates/font/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/nikhilmodak/gulp-ngdocs/84d412873727426a0b616243b42668e1e3ba7474/src/templates/font/fontawesome-webfont.eot


--------------------------------------------------------------------------------
/src/templates/font/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/nikhilmodak/gulp-ngdocs/84d412873727426a0b616243b42668e1e3ba7474/src/templates/font/fontawesome-webfont.ttf


--------------------------------------------------------------------------------
/src/templates/font/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/nikhilmodak/gulp-ngdocs/84d412873727426a0b616243b42668e1e3ba7474/src/templates/font/fontawesome-webfont.woff


--------------------------------------------------------------------------------
/src/templates/index.tmpl:
--------------------------------------------------------------------------------
  1 | <!doctype html>
  2 | <!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7" <% if(!deferLoad) { %>ng-app="docsApp" <% } %> lang="en" ng-controller="DocsController"> <![endif]-->
  3 | <!--[if IE 7]>    <html class="no-js lt-ie9 lt-ie8" <% if(!deferLoad) { %>ng-app="docsApp" <% } %> lang="en" ng-controller="DocsController"> <![endif]-->
  4 | <!--[if IE 8]>    <html class="no-js lt-ie9" <% if(!deferLoad) { %>ng-app="docsApp" <% } %> lang="en" ng-controller="DocsController"> <![endif]-->
  5 | <!--[if gt IE 8]><!--> <html class="no-js" <% if(!deferLoad) { %>ng-app="docsApp" <% } %> lang="en" ng-controller="DocsController"> <!--<![endif]-->
  6 | <head>
  7 |   <meta charset="utf-8">
  8 |   <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  9 |   <meta name="Description"
 10 |         content="AngularJS is what HTML would have been, had it been designed for building web-apps.
 11 |                  Declarative templates with data-binding, MVC, dependency injection and great
 12 |                  testability story all implemented with pure client-side JavaScript!">
 13 |   <meta name="fragment" content="!">
 14 |   <title ng-bind-template="<%= title || 'Doc' %>: {{partialTitle}}">Docs</title>
 15 |   <script type="text/javascript">
 16 |     // dynamically add base tag as well as css and javascript files.
 17 |     // we can't add css/js the usual way, because some browsers (FF) eagerly prefetch resources
 18 |     // before the base attribute is added, causing 404 and terribly slow loading of the docs app.
 19 |     (function() {
 20 |       var indexFile = (location.pathname.match(/\/(index[^\.]*\.html)/) || ['', ''])[1],
 21 |           rUrl = /((#!\/|<%= sections %>|index)[^\./]*\.html).*$/,
 22 |           origin = location.origin || (window.location.protocol + "//" + window.location.hostname + (window.location.port ? ':' + window.location.port: '')),
 23 |           baseUrl = origin + location.href.substr(origin.length).replace(rUrl, indexFile),
 24 |           headEl = document.getElementsByTagName('head')[0],
 25 |           sync = true;
 26 | 
 27 |       addTag('base', {href: baseUrl});
 28 |       addTag('link', {rel: 'stylesheet', href: 'css/bootstrap.min.css', type: 'text/css'});
 29 |       addTag('link', {rel: 'stylesheet', href: 'css/font-awesome.css', type: 'text/css'});
 30 |       addTag('link', {rel: 'stylesheet', href: 'css/prettify.css', type: 'text/css'});
 31 |       addTag('link', {rel: 'stylesheet', href: 'css/docs.css', type: 'text/css'});
 32 |       addTag('link', {rel: 'stylesheet', href: 'css/animations.css', type: 'text/css'});
 33 | 
 34 |       <% _.forEach(styles, function(url) { %>
 35 |          addTag('link', {rel: 'stylesheet', href: '<%= url %>', type: 'text/css'}, sync);
 36 |       <% }); %>
 37 | 
 38 |       <% _.forEach(scripts, function(url) { %>
 39 |         addTag('script', {src: '<%= url %>'}, sync);
 40 |       <% }); %>
 41 |       <% if(!deferLoad) { %>
 42 |       addTag('script', {src: 'js/angular-bootstrap.js'}, sync);
 43 |       addTag('script', {src: 'js/angular-bootstrap-prettify.js'}, sync);
 44 |       addTag('script', {src: 'js/docs-setup.js'}, sync);
 45 |       addTag('script', {src: 'js/docs.js'}, sync);
 46 |       addTag('script', {src: 'js/prettify.js'}, sync);
 47 |       <% } %>
 48 |       function addTag(name, attributes, sync) {
 49 |         var el = document.createElement(name),
 50 |             attrName;
 51 | 
 52 |         for (attrName in attributes) {
 53 |           el.setAttribute(attrName, attributes[attrName]);
 54 |         }
 55 | 
 56 |         sync ? document.write(outerHTML(el)) : headEl.appendChild(el);
 57 |       }
 58 | 
 59 |       function outerHTML(node){
 60 |         // if IE, Chrome take the internal method otherwise build one
 61 |         return node.outerHTML || (
 62 |             function(n){
 63 |                 var div = document.createElement('div'), h;
 64 |                 div.appendChild(n);
 65 |                 h = div.innerHTML;
 66 |                 div = null;
 67 |                 return h;
 68 |             })(node);
 69 |       }
 70 |     })();
 71 | <% if (analytics) { %>
 72 |     // GA asynchronous tracker
 73 |     var _gaq = _gaq || [];
 74 |     _gaq.push(['_setAccount', '<%= analytics.account %>']);
 75 |     _gaq.push(['_setDomainName', '<%= analytics.domainName %>']);
 76 | 
 77 |     (function() {
 78 |       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 79 |       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 80 |       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 81 |     })();
 82 | <% } %>
 83 |   </script>
 84 | </head>
 85 | 
 86 | <body>
 87 |   <header class="header">
 88 |     <div class="navbar navbar-fixed-top">
 89 |       <div class="navbar-inner">
 90 |         <div class="container">
 91 |           <% if (image) { %>
 92 |             <% if (imageLink) { %>
 93 |               <a href="<%= imageLink %>">
 94 |             <% } %>
 95 |               <img class="pull-left" src="<%= image %>">
 96 |             <% if (imageLink) { %>
 97 |               </a>
 98 |             <% } %>
 99 |           <% } %>
100 |           <% if (title) {%>
101 |             <a <% if (titleLink) { %> href="<%= titleLink %>" <% } %> class="brand"><%= title %></a>
102 |           <% } %>
103 |           <ul class="nav">
104 |             <li ng-repeat="(url, name) in sections" ng-class="{active: isActivePath(url)}">
105 |               <a ng-href="{{url}}"><i class="icon-book icon-white"></i> {{name}}</a>
106 |             </li>
107 |           </ul>
108 |           <%= navContent %>
109 |         </div>
110 |       </div>
111 |     </div>
112 |   </header>
113 | 
114 |   <div role="main" class="container">
115 |     <div class="row clear-navbar"></div>
116 | 
117 |     <div class="row">
118 |       <div class="span12">
119 |         <!--[if lt IE 7]>
120 |         <p class="alert alert-error">Your browser is <em>ancient!</em>
121 |           <a href="http://browsehappy.com/">Upgrade to a different browser</a> or
122 |           <a href="http://www.google.com/chromeframe/?redirect=true">install Google Chrome Frame</a> to
123 |           experience this site.
124 |         </p>
125 |         <![endif]-->
126 | 
127 |         <!--[if lt IE 9]>
128 |         <div class="alert">
129 |           You are using an old version of Internet Explorer.
130 |           For better and safer browsing experience please <a href="http://www.microsoft.com/IE9">upgrade IE</a>
131 |           or install <a href="http://google.com/chrome">Google Chrome browser</a>.
132 |         </div>
133 |         <![endif]-->
134 |       </div>
135 | 
136 |     </div>
137 | 
138 |     <div class="row">
139 |       <div class="span3">
140 |         <form class="form-search" ng-submit="submitForm()">
141 |           <% if (bestMatch) { %>
142 |           <div class="dropdown search"
143 |                ng-class="{open: focused && bestMatch.rank > 0 && bestMatch.page != currentPage}">
144 |             <input type="text" ng-model="search" placeholder="search the docs"
145 |                    tabindex="1" accesskey="s" class="search-query" focused="focused">
146 |             <ul class="dropdown-menu">
147 |               <li>
148 |                 <a href="{{bestMatch.page.url}}">{{bestMatch.page.shortName}}</a>
149 |               </li>
150 |             </ul>
151 |           </div>
152 |           <% } else { %>
153 |           <input type="text" ng-model="search" placeholder="search the docs"
154 |                  tabindex="1" accesskey="s" class="search-query">
155 |           <% } %>
156 |           <div class="spacer"></div>
157 | 
158 |           <ul class="nav nav-list well" ng-show="pages.length">
159 |             <li ng-repeat="page in pages track by page.url" ng-class="navClass(page)" class="api-list-item expand">
160 |               <a href="{{page.url}}" tabindex="2">{{page.shortName}}</a>
161 |             </li>
162 |           </ul>
163 | 
164 |           <ul class="nav nav-list well" ng-repeat="module in modules track by module.url" class="api-list-item">
165 |             <li class="nav-header module">
166 |               <a class="guide">module</a>
167 |               <a class="code" href="{{module.url}}">{{module.name}}</a>
168 |             </li>
169 | 
170 |             <li ng-repeat="page in module.others track by page.url" ng-class="navClass(page)" class="api-list-item expand">
171 |               <a href="{{page.url}}" tabindex="2">{{page.shortName}}</a>
172 |             </li>
173 | 
174 |             <li class="nav-header section" ng-show="module.directives.length">
175 |               <a class="guide">directive</a>
176 |             </li>
177 |             <li ng-repeat="page in module.directives track by page.url" ng-class="navClass(page)" class="api-list-item expand">
178 |               <a href="{{page.url}}" tabindex="2">{{page.shortName}}</a>
179 |             </li>
180 | 
181 |             <li class="nav-header section" ng-show="module.controllers.length">
182 |               <a class="guide">controller</a>
183 |             </li>
184 |             <li ng-repeat="page in module.controllers track by page.url" ng-class="navClass(page)" class="api-list-item expand">
185 |               <a href="{{page.url}}" tabindex="2">{{page.shortName}}</a>
186 |             </li>
187 | 
188 |             <li class="nav-header section" ng-show="module.filters.length">
189 |               <a class="guide">filter</a>
190 |             </li>
191 |             <li ng-repeat="page in module.filters track by page.url" ng-class="navClass(page)" class="api-list-item expand">
192 |               <a href="{{page.url}}" tabindex="2">{{page.shortName}}</a>
193 |             </li>
194 | 
195 |             <li class="nav-header section" ng-show="module.services.length">
196 |               <a class="guide">service</a>
197 |             </li>
198 |             <li ng-repeat="service in module.services track by service.instance.url" ng-class="navClass(service.instance, service.provider)" class="api-list-item expand">
199 |               <a ng-show="service.provider" class="pull-right" href="{{service.provider.url}}" tabindex="2"><i class="icon-cog"></i></a>
200 |               <a href="{{service.instance.url}}" tabindex="2">{{service.name}}</a>
201 |             </li>
202 | 
203 |             <li class="nav-header section" ng-show="module.types.length">
204 |               <a class="guide">Types</a>
205 |             </li>
206 |             <li ng-repeat="page in module.types track by page.url" ng-class="navClass(page)" class="api-list-item expand">
207 |               <a href="{{page.url}}" tabindex="2">{{page.shortName}}</a>
208 |             </li>
209 | 
210 |             <li class="nav-header section" ng-show="module.globals.length">
211 |               <a class="global guide">global APIs</a>
212 |               &nbsp;
213 |             </li>
214 |             <li ng-repeat="page in module.globals track by page.url" ng-class="navClass(page)" class="api-list-item expand">
215 |               <a href="{{page.url}}" tabindex="2">{{page.id}}</a>
216 |             </li>
217 | 
218 |           </ul>
219 | 
220 |         </form>
221 |       </div>
222 |       <div class="span9">
223 | 
224 |         <ul class="breadcrumb">
225 |           <li ng-repeat="crumb in breadcrumb">
226 |             <span ng-hide="crumb.url">{{crumb.name}}</span>
227 |             <a ng-show="crumb.url" href="{{crumb.url}}">{{crumb.name}}</a>
228 |             <span ng-show="crumb.url" class="divider">/</span>
229 |           </li>
230 |         </ul>
231 | 
232 |         <div id="loading" ng-show="loading">Loading...</div>
233 | 
234 |         <div ng-hide="loading" ng-include src="currentPage.partialUrl" onload="afterPartialLoaded()" autoscroll class="content slide-reveal"></div>
235 | <% if (discussions) { %>
236 |         <div id="disqus" class="disqus">
237 |           <h2>Discussion</h2>
238 |           <div id="disqus_thread" class="content-panel-content"></div>
239 |         </div>
240 | <% } %>
241 |       </div>
242 |     </div>
243 |   </div>
244 | 
245 | </body>
246 | </html>
247 | 


--------------------------------------------------------------------------------
/src/templates/js/angular-bootstrap-prettify.js:
--------------------------------------------------------------------------------
  1 | 'use strict';
  2 | 
  3 | var directive = {};
  4 | var service = { value: {} };
  5 | 
  6 | var DEPENDENCIES = {
  7 |   'angular.js': 'http://code.angularjs.org/' + angular.version.full + '/angular.min.js',
  8 |   'angular-resource.js': 'http://code.angularjs.org/' + angular.version.full + '/angular-resource.min.js',
  9 |   'angular-route.js': 'http://code.angularjs.org/' + angular.version.full + '/angular-route.min.js',
 10 |   'angular-animate.js': 'http://code.angularjs.org/' + angular.version.full + '/angular-animate.min.js',
 11 |   'angular-sanitize.js': 'http://code.angularjs.org/' + angular.version.full + '/angular-sanitize.min.js',
 12 |   'angular-cookies.js': 'http://code.angularjs.org/' + angular.version.full + '/angular-cookies.min.js'
 13 | };
 14 | 
 15 | 
 16 | function escape(text) {
 17 |   return text.
 18 |     replace(/\&/g, '&amp;').
 19 |     replace(/\</g, '&lt;').
 20 |     replace(/\>/g, '&gt;').
 21 |     replace(/"/g, '&quot;');
 22 | }
 23 | 
 24 | /**
 25 |  * http://stackoverflow.com/questions/451486/pre-tag-loses-line-breaks-when-setting-innerhtml-in-ie
 26 |  * http://stackoverflow.com/questions/195363/inserting-a-newline-into-a-pre-tag-ie-javascript
 27 |  */
 28 | function setHtmlIe8SafeWay(element, html) {
 29 |   var newElement = angular.element('<pre>' + html + '</pre>');
 30 | 
 31 |   element.empty();
 32 |   element.append(newElement.contents());
 33 |   return element;
 34 | }
 35 | 
 36 | 
 37 | directive.jsFiddle = function(getEmbeddedTemplate, escape, script) {
 38 |   return {
 39 |     terminal: true,
 40 |     link: function(scope, element, attr) {
 41 |       var name = '',
 42 |         stylesheet = '<link rel="stylesheet" href="http://twitter.github.com/bootstrap/assets/css/bootstrap.css">\n',
 43 |         fields = {
 44 |           html: '',
 45 |           css: '',
 46 |           js: ''
 47 |         };
 48 | 
 49 |       angular.forEach(attr.jsFiddle.split(' '), function(file, index) {
 50 |         var fileType = file.split('.')[1];
 51 | 
 52 |         if (fileType == 'html') {
 53 |           if (index == 0) {
 54 |             fields[fileType] +=
 55 |               '<div ng-app' + (attr.module ? '="' + attr.module + '"' : '') + '>\n' +
 56 |                 getEmbeddedTemplate(file, 2);
 57 |           } else {
 58 |             fields[fileType] += '\n\n\n  <!-- CACHE FILE: ' + file + ' -->\n' +
 59 |               '  <script type="text/ng-template" id="' + file + '">\n' +
 60 |               getEmbeddedTemplate(file, 4) +
 61 |               '  </script>\n';
 62 |           }
 63 |         } else {
 64 |           fields[fileType] += getEmbeddedTemplate(file) + '\n';
 65 |         }
 66 |       });
 67 | 
 68 |       fields.html += '</div>\n';
 69 | 
 70 |       setHtmlIe8SafeWay(element,
 71 |         '<form class="jsfiddle" method="post" action="http://jsfiddle.net/api/post/library/pure/" target="_blank">' +
 72 |           hiddenField('title', 'AngularJS Example: ' + name) +
 73 |           hiddenField('css', '</style> <!-- Ugly Hack due to jsFiddle issue: http://goo.gl/BUfGZ --> \n' +
 74 |             stylesheet +
 75 |             script.angular +
 76 |             (attr.resource ? script.resource : '') +
 77 |             '<style>\n' +
 78 |             fields.css) +
 79 |           hiddenField('html', fields.html) +
 80 |           hiddenField('js', fields.js) +
 81 |           '<button class="btn btn-primary"><i class="icon-white icon-pencil"></i> Edit Me</button>' +
 82 |           '</form>');
 83 | 
 84 |       function hiddenField(name, value) {
 85 |         return '<input type="hidden" name="' +  name + '" value="' + escape(value) + '">';
 86 |       }
 87 |     }
 88 |   }
 89 | };
 90 | 
 91 | 
 92 | directive.code = function() {
 93 |   return {restrict: 'E', terminal: true};
 94 | };
 95 | 
 96 | 
 97 | directive.prettyprint = ['reindentCode', function(reindentCode) {
 98 |   return {
 99 |     restrict: 'C',
100 |     compile: function(element) {
101 |       var html = element.html();
102 |       //ensure that angular won't compile {{ curly }} values
103 |       html = html.replace(/\{\{/g, '<span>{{</span>')
104 |                  .replace(/\}\}/g, '<span>}}</span>');
105 |       if (window.RUNNING_IN_NG_TEST_RUNNER) {
106 |         element.html(html);
107 |       }
108 |       else {
109 |         element.html(window.prettyPrintOne(reindentCode(html), undefined, true));
110 |       }
111 |     }
112 |   };
113 | }];
114 | 
115 | 
116 | directive.ngSetText = ['getEmbeddedTemplate', function(getEmbeddedTemplate) {
117 |   return {
118 |     restrict: 'CA',
119 |     priority: 10,
120 |     compile: function(element, attr) {
121 |       setHtmlIe8SafeWay(element, escape(getEmbeddedTemplate(attr.ngSetText)));
122 |     }
123 |   }
124 | }]
125 | 
126 | 
127 | directive.ngHtmlWrap = ['reindentCode', 'templateMerge', function(reindentCode, templateMerge) {
128 |   return {
129 |     compile: function(element, attr) {
130 |       var properties = {
131 |             head: '',
132 |             module: '',
133 |             body: element.text()
134 |           },
135 |         html = "<!doctype html>\n<html ng-app{{module}}>\n  <head>\n{{head:4}}  </head>\n  <body>\n{{body:4}}  </body>\n</html>";
136 | 
137 |       angular.forEach((attr.ngHtmlWrap || '').split(' '), function(dep) {
138 |         if (!dep) return;
139 |         dep = DEPENDENCIES[dep] || dep;
140 | 
141 |         var ext = dep.split(/\./).pop();
142 | 
143 |         if (ext == 'css') {
144 |           properties.head += '<link rel="stylesheet" href="' + dep + '" type="text/css">\n';
145 |         } else if(ext == 'js') {
146 |           properties.head += '<script src="' + dep + '"></script>\n';
147 |         } else {
148 |           properties.module = '="' + dep + '"';
149 |         }
150 |       });
151 | 
152 |       setHtmlIe8SafeWay(element, escape(templateMerge(html, properties)));
153 |     }
154 |   }
155 | }];
156 | 
157 | 
158 | directive.ngSetHtml = ['getEmbeddedTemplate', function(getEmbeddedTemplate) {
159 |   return {
160 |     restrict: 'CA',
161 |     priority: 10,
162 |     compile: function(element, attr) {
163 |       setHtmlIe8SafeWay(element, getEmbeddedTemplate(attr.ngSetHtml));
164 |     }
165 |   }
166 | }];
167 | 
168 | 
169 | directive.ngEvalJavascript = ['getEmbeddedTemplate', function(getEmbeddedTemplate) {
170 |   return {
171 |     compile: function (element, attr) {
172 |       var fileNames = attr.ngEvalJavascript.split(' ');
173 |       angular.forEach(fileNames, function(fileName) {
174 |         var script = getEmbeddedTemplate(fileName);
175 |         try {
176 |           if (window.execScript) { // IE
177 |             window.execScript(script || '""'); // IE complains when evaling empty string
178 |           } else {
179 |             window.eval(script + '//@ sourceURL=' + fileName);
180 |           }
181 |         } catch (e) {
182 |           if (window.console) {
183 |             window.console.log(script, '\n', e);
184 |           } else {
185 |             window.alert(e);
186 |           }
187 |         }
188 |       });
189 |     }
190 |   };
191 | }];
192 | 
193 | 
194 | directive.ngEmbedApp = ['$templateCache', '$browser', '$rootScope', '$location', '$sniffer', '$animate', '$exceptionHandler',
195 |                 function($templateCache,   $browser,  docsRootScope, $location,   $sniffer,   $animate,   $exceptionHandler) {
196 |   return {
197 |     terminal: true,
198 |     link: function(scope, element, attrs) {
199 |       var modules = ['ngAnimate'],
200 |           embedRootScope,
201 |           deregisterEmbedRootScope;
202 | 
203 |       modules.push(['$provide', function($provide) {
204 |         $provide.value('$templateCache', $templateCache);
205 |         $provide.value('$anchorScroll', angular.noop);
206 |         $provide.value('$browser', $browser);
207 |         $provide.value('$sniffer', $sniffer);
208 |         $provide.value('$animate', $animate);
209 |         $provide.provider('$location', function() {
210 |           this.$get = ['$rootScope', function($rootScope) {
211 |             docsRootScope.$on('$locationChangeSuccess', function(event, oldUrl, newUrl) {
212 |               $rootScope.$broadcast('$locationChangeSuccess', oldUrl, newUrl);
213 |             });
214 |             return $location;
215 |           }];
216 |           this.html5Mode = angular.noop;
217 |           this.hashPrefix = function () {
218 |               return '';
219 |           };
220 |         });
221 | 
222 |         $provide.decorator('$rootScope', ['$delegate', function($delegate) {
223 |           embedRootScope = $delegate;
224 | 
225 |           // Since we are teleporting the $animate service, which relies on the $$postDigestQueue
226 |           // we need the embedded scope to use the same $$postDigestQueue as the outer scope
227 |           function docsRootDigest() {
228 |             var postDigestQueue = docsRootScope.$$postDigestQueue;
229 |             while (postDigestQueue.length) {
230 |               try {
231 |                 postDigestQueue.shift()();
232 |               } catch (e) {
233 |                 $exceptionHandler(e);
234 |               }
235 |             }
236 |           }
237 |           embedRootScope.$watch(function () {
238 |             embedRootScope.$$postDigest(docsRootDigest);
239 |           })
240 | 
241 |           deregisterEmbedRootScope = docsRootScope.$watch(function embedRootScopeDigestWatch() {
242 |             embedRootScope.$digest();
243 |           });
244 | 
245 |           return embedRootScope;
246 |         }]);
247 |       }]);
248 |       if (attrs.ngEmbedApp)  modules.push(attrs.ngEmbedApp);
249 | 
250 |       element.on('click', function(event) {
251 |         if (event.target.attributes.getNamedItem('ng-click')) {
252 |           event.preventDefault();
253 |         }
254 |       });
255 | 
256 |       element.bind('$destroy', function() {
257 |         if(deregisterEmbedRootScope){
258 |           deregisterEmbedRootScope()
259 |         }
260 | 
261 |         if(embedRootScope){
262 |           embedRootScope.$destroy();
263 |         }
264 |       });
265 | 
266 |       element.data('$injector', null);
267 |       angular.bootstrap(element, modules);
268 |     }
269 |   };
270 | }];
271 | 
272 | service.reindentCode = function() {
273 |   return function (text, spaces) {
274 |     if (!text) return text;
275 |     var lines = text.split(/\r?\n/);
276 |     var prefix = '      '.substr(0, spaces || 0);
277 |     var i;
278 | 
279 |     // remove any leading blank lines
280 |     while (lines.length && lines[0].match(/^\s*$/)) lines.shift();
281 |     // remove any trailing blank lines
282 |     while (lines.length && lines[lines.length - 1].match(/^\s*$/)) lines.pop();
283 |     var minIndent = 999;
284 |     for (i = 0; i < lines.length; i++) {
285 |       var line = lines[0];
286 |       var reindentCode = line.match(/^\s*/)[0];
287 |       if (reindentCode !== line && reindentCode.length < minIndent) {
288 |         minIndent = reindentCode.length;
289 |       }
290 |     }
291 | 
292 |     for (i = 0; i < lines.length; i++) {
293 |       lines[i] = prefix + lines[i].substring(minIndent);
294 |     }
295 |     lines.push('');
296 |     return lines.join('\n');
297 |   }
298 | };
299 | 
300 | service.templateMerge = ['reindentCode', function(indentCode) {
301 |   return function(template, properties) {
302 |     return template.replace(/\{\{(\w+)(?:\:(\d+))?\}\}/g, function(_, key, indent) {
303 |       var value = properties[key];
304 | 
305 |       if (indent) {
306 |         value = indentCode(value, indent);
307 |       }
308 | 
309 |       return value == undefined ? '' : value;
310 |     });
311 |   };
312 | }];
313 | 
314 | service.getEmbeddedTemplate = ['reindentCode', function(reindentCode) {
315 |   return function (id) {
316 |     var element = document.getElementById(id);
317 | 
318 |     if (!element) {
319 |       return null;
320 |     }
321 | 
322 |     return reindentCode(angular.element(element).html(), 0);
323 |   }
324 | }];
325 | 
326 | 
327 | angular.module('bootstrapPrettify', []).directive(directive).factory(service);
328 | 


--------------------------------------------------------------------------------
/src/templates/js/angular-bootstrap.js:
--------------------------------------------------------------------------------
  1 | 'use strict';
  2 | 
  3 | var directive = {};
  4 | 
  5 | directive.dropdownToggle =
  6 |           ['$document', '$location', '$window',
  7 |   function ($document,   $location,   $window) {
  8 |     var openElement = null, close;
  9 |     return {
 10 |       restrict: 'C',
 11 |       link: function(scope, element, attrs) {
 12 |         scope.$watch(function dropdownTogglePathWatch(){return $location.path();}, function dropdownTogglePathWatchAction() {
 13 |           close && close();
 14 |         });
 15 | 
 16 |         element.parent().on('click', function(event) {
 17 |           close && close();
 18 |         });
 19 | 
 20 |         element.on('click', function(event) {
 21 |           event.preventDefault();
 22 |           event.stopPropagation();
 23 | 
 24 |           var iWasOpen = false;
 25 | 
 26 |           if (openElement) {
 27 |             iWasOpen = openElement === element;
 28 |             close();
 29 |           }
 30 | 
 31 |           if (!iWasOpen){
 32 |             element.parent().addClass('open');
 33 |             openElement = element;
 34 | 
 35 |             close = function (event) {
 36 |               event && event.preventDefault();
 37 |               event && event.stopPropagation();
 38 |               $document.off('click', close);
 39 |               element.parent().removeClass('open');
 40 |               close = null;
 41 |               openElement = null;
 42 |             }
 43 | 
 44 |             $document.on('click', close);
 45 |           }
 46 |         });
 47 |       }
 48 |     };
 49 |   }];
 50 | 
 51 | directive.syntax = function() {
 52 |   return {
 53 |     restrict: 'A',
 54 |     link: function(scope, element, attrs) {
 55 |       function makeLink(type, text, link, icon) {
 56 |         return '<a href="' + link + '" class="btn syntax-' + type + '" target="_blank" rel="nofollow">' + 
 57 |                 '<span class="' + icon + '"></span> ' + text +
 58 |                '</a>';
 59 |       };
 60 | 
 61 |       var html = '';
 62 |       var types = {
 63 |         'github' : {
 64 |           text : 'View on Github',
 65 |           key : 'syntaxGithub',
 66 |           icon : 'icon-github'
 67 |         },
 68 |         'plunkr' : {
 69 |           text : 'View on Plunkr',
 70 |           key : 'syntaxPlunkr',
 71 |           icon : 'icon-arrow-down'
 72 |         },
 73 |         'jsfiddle' : {
 74 |           text : 'View on JSFiddle',
 75 |           key : 'syntaxFiddle',
 76 |           icon : 'icon-cloud'
 77 |         }
 78 |       };
 79 |       for(var type in types) {
 80 |         var data = types[type];
 81 |         var link = attrs[data.key];
 82 |         if(link) {
 83 |           html += makeLink(type, data.text, link, data.icon);
 84 |         }
 85 |       };
 86 | 
 87 |       var nav = document.createElement('nav');
 88 |       nav.className = 'syntax-links';
 89 |       nav.innerHTML = html;
 90 | 
 91 |       var node = element[0];
 92 |       var par = node.parentNode;
 93 |       par.insertBefore(nav, node);
 94 |     }
 95 |   }
 96 | }
 97 | 
 98 | directive.tabbable = function() {
 99 |   return {
100 |     restrict: 'C',
101 |     compile: function(element) {
102 |       var navTabs = angular.element('<ul class="nav nav-tabs"></ul>'),
103 |           tabContent = angular.element('<div class="tab-content"></div>');
104 | 
105 |       tabContent.append(element.contents());
106 |       element.append(navTabs).append(tabContent);
107 |     },
108 |     controller: ['$scope', '$element', function($scope, $element) {
109 |       var navTabs = $element.contents().eq(0),
110 |           ngModel = $element.controller('ngModel') || {},
111 |           tabs = [],
112 |           selectedTab;
113 | 
114 |       ngModel.$render = function() {
115 |         var $viewValue = this.$viewValue;
116 | 
117 |         if (selectedTab ? (selectedTab.value != $viewValue) : $viewValue) {
118 |           if(selectedTab) {
119 |             selectedTab.paneElement.removeClass('active');
120 |             selectedTab.tabElement.removeClass('active');
121 |             selectedTab = null;
122 |           }
123 |           if($viewValue) {
124 |             for(var i = 0, ii = tabs.length; i < ii; i++) {
125 |               if ($viewValue == tabs[i].value) {
126 |                 selectedTab = tabs[i];
127 |                 break;
128 |               }
129 |             }
130 |             if (selectedTab) {
131 |               selectedTab.paneElement.addClass('active');
132 |               selectedTab.tabElement.addClass('active');
133 |             }
134 |           }
135 | 
136 |         }
137 |       };
138 | 
139 |       this.addPane = function(element, attr) {
140 |         var li = angular.element('<li><a href></a></li>'),
141 |             a = li.find('a'),
142 |             tab = {
143 |               paneElement: element,
144 |               paneAttrs: attr,
145 |               tabElement: li
146 |             };
147 | 
148 |         tabs.push(tab);
149 | 
150 |         attr.$observe('value', update)();
151 |         attr.$observe('title', function(){ update(); a.text(tab.title); })();
152 | 
153 |         function update() {
154 |           tab.title = attr.title;
155 |           tab.value = attr.value || attr.title;
156 |           if (!ngModel.$setViewValue && (!ngModel.$viewValue || tab == selectedTab)) {
157 |             // we are not part of angular
158 |             ngModel.$viewValue = tab.value;
159 |           }
160 |           ngModel.$render();
161 |         }
162 | 
163 |         navTabs.append(li);
164 |         li.on('click', function(event) {
165 |           event.preventDefault();
166 |           event.stopPropagation();
167 |           if (ngModel.$setViewValue) {
168 |             $scope.$apply(function() {
169 |               ngModel.$setViewValue(tab.value);
170 |               ngModel.$render();
171 |             });
172 |           } else {
173 |             // we are not part of angular
174 |             ngModel.$viewValue = tab.value;
175 |             ngModel.$render();
176 |           }
177 |         });
178 | 
179 |         return function() {
180 |           tab.tabElement.remove();
181 |           for(var i = 0, ii = tabs.length; i < ii; i++ ) {
182 |             if (tab == tabs[i]) {
183 |               tabs.splice(i, 1);
184 |             }
185 |           }
186 |         };
187 |       }
188 |     }]
189 |   };
190 | };
191 | 
192 | directive.table = function() {
193 |   return {
194 |     restrict: 'E',
195 |     link: function(scope, element, attrs) {
196 |       if (!attrs['class']) {
197 |         element.addClass('table table-bordered table-striped code-table');
198 |       }
199 |     }
200 |   };
201 | };
202 | 
203 | var popoverElement = function() {
204 |   var object = {
205 |     init : function() {
206 |       this.element = angular.element(
207 |         '<div class="popover popover-incode top">' +
208 |           '<div class="arrow"></div>' +
209 |           '<div class="popover-inner">' +
210 |             '<div class="popover-title"><code></code></div>' +
211 |             '<div class="popover-content"></div>' +
212 |           '</div>' +
213 |         '</div>'
214 |       );
215 |       this.node = this.element[0];
216 |       this.element.css({
217 |         'display':'block',
218 |         'position':'absolute'
219 |       });
220 |       angular.element(document.body).append(this.element);
221 | 
222 |       var inner = this.element.children()[1];
223 |       this.titleElement   = angular.element(inner.childNodes[0].firstChild);
224 |       this.contentElement = angular.element(inner.childNodes[1]);
225 | 
226 |       //stop the click on the tooltip
227 |       this.element.bind('click', function(event) {
228 |         event.preventDefault();
229 |         event.stopPropagation();
230 |       });
231 | 
232 |       var self = this;
233 |       angular.element(document.body).bind('click',function(event) {
234 |         if(self.visible()) self.hide();
235 |       });
236 |     },
237 | 
238 |     show : function(x,y) {
239 |       this.element.addClass('visible');
240 |       this.position(x || 0, y || 0);
241 |     },
242 | 
243 |     hide : function() {
244 |       this.element.removeClass('visible');
245 |       this.position(-9999,-9999);
246 |     },
247 | 
248 |     visible : function() {
249 |       return this.position().y >= 0;
250 |     },
251 | 
252 |     isSituatedAt : function(element) {
253 |       return this.besideElement ? element[0] == this.besideElement[0] : false;
254 |     },
255 | 
256 |     title : function(value) {
257 |       return this.titleElement.html(value);
258 |     },
259 | 
260 |     content : function(value) { 
261 |       if(value && value.length > 0) {
262 |         value = marked(value);
263 |       }
264 |       return this.contentElement.html(value);
265 |     },
266 | 
267 |     positionArrow : function(position) {
268 |       this.node.className = 'popover ' + position;
269 |     },
270 | 
271 |     positionAway : function() {
272 |       this.besideElement = null;
273 |       this.hide();
274 |     },
275 | 
276 |     positionBeside : function(element) {
277 |       this.besideElement = element;
278 | 
279 |       var elm = element[0];
280 |       var x = elm.offsetLeft;
281 |       var y = elm.offsetTop;
282 |       x -= 30;
283 |       y -= this.node.offsetHeight + 10;
284 |       this.show(x,y);
285 |     },
286 | 
287 |     position : function(x,y) {
288 |       if(x != null && y != null) {
289 |         this.element.css('left',x + 'px');
290 |         this.element.css('top', y + 'px');
291 |       }
292 |       else {
293 |         return {
294 |           x : this.node.offsetLeft,
295 |           y : this.node.offsetTop
296 |         };
297 |       }
298 |     }
299 |   };
300 | 
301 |   object.init();
302 |   object.hide();
303 | 
304 |   return object;
305 | };
306 | 
307 | directive.popover = ['popoverElement', function(popover) {
308 |   return {
309 |     restrict: 'A',
310 |     priority : 500,
311 |     link: function(scope, element, attrs) {
312 |       element.bind('click',function(event) {
313 |         event.preventDefault();
314 |         event.stopPropagation();
315 |         if(popover.isSituatedAt(element) && popover.visible()) {
316 |           popover.title('');
317 |           popover.content('');
318 |           popover.positionAway();
319 |         }
320 |         else {
321 |           popover.title(attrs.title);
322 |           popover.content(attrs.content);
323 |           popover.positionBeside(element);
324 |         }
325 |       });
326 |     }
327 |   }
328 | }];
329 | 
330 | directive.tabPane = function() {
331 |   return {
332 |     require: '^tabbable',
333 |     restrict: 'C',
334 |     link: function(scope, element, attrs, tabsCtrl) {
335 |       element.on('$remove', tabsCtrl.addPane(element, attrs));
336 |     }
337 |   };
338 | };
339 | 
340 | directive.foldout = ['$http', '$animate','$window', function($http, $animate, $window) {
341 |   return {
342 |     restrict: 'A',
343 |     priority : 500,
344 |     link: function(scope, element, attrs) {
345 |       var container, loading, url = attrs.url;
346 |       if(/\/build\//.test($window.location.href)) {
347 |         url = '/build/docs' + url;
348 |       }
349 |       element.bind('click',function() {
350 |         scope.$apply(function() {
351 |           if(!container) {
352 |             if(loading) return;
353 | 
354 |             loading = true;
355 |             var par = element.parent();
356 |             container = angular.element('<div class="foldout">loading...</div>');
357 |             $animate.enter(container, null, par);
358 | 
359 |             $http.get(url, { cache : true }).success(function(html) {
360 |               loading = false;
361 | 
362 |               html = '<div class="foldout-inner">' +
363 |                       '<div calss="foldout-arrow"></div>' +
364 |                       html +
365 |                      '</div>';
366 |               container.html(html);
367 | 
368 |               //avoid showing the element if the user has already closed it
369 |               if(container.css('display') == 'block') {
370 |                 container.css('display','none');
371 |                 $animate.addClass(container, 'ng-hide');
372 |               }
373 |             });
374 |           }
375 |           else {
376 |             container.hasClass('ng-hide') ? $animate.removeClass(container, 'ng-hide') : $animate.addClass(container, 'ng-hide');
377 |           }
378 |         });
379 |       });
380 |     }
381 |   }
382 | }];
383 | 
384 | angular.module('bootstrap', [])
385 |   .directive(directive)
386 |   .factory('popoverElement', popoverElement)
387 |   .run(function() {
388 |     marked.setOptions({
389 |       gfm: true,
390 |       tables: true
391 |     });
392 |   });
393 | 


--------------------------------------------------------------------------------
/src/templates/js/docs.js:
--------------------------------------------------------------------------------
  1 | var docsApp = {
  2 |   controller: {},
  3 |   directive: {},
  4 |   serviceFactory: {}
  5 | };
  6 | 
  7 | 
  8 | docsApp.directive.ngHtmlWrapLoaded = function(reindentCode, templateMerge, loadedUrls) {
  9 |   function escape(text) {
 10 |     return text.
 11 |       replace(/\&/g, '&amp;').
 12 |       replace(/\</g, '&lt;').
 13 |       replace(/\>/g, '&gt;').
 14 |       replace(/"/g, '&quot;');
 15 |   }
 16 | 
 17 |   function setHtmlIe8SafeWay(element, html) {
 18 |     var newElement = angular.element('<pre>' + html + '</pre>');
 19 | 
 20 |     element.html('');
 21 |     element.append(newElement.contents());
 22 |     return element;
 23 |   }
 24 | 
 25 |   return {
 26 |     compile: function(element, attr) {
 27 |       var properties = {
 28 |             head: '',
 29 |             module: '',
 30 |             body: element.text()
 31 |           },
 32 |         html = "<!doctype html>\n<html ng-app{{module}}>\n  <head>\n{{head:4}}  </head>\n  <body>\n{{body:4}}  </body>\n</html>";
 33 | 
 34 |       angular.forEach(loadedUrls.base, function(dep) {
 35 |         properties.head += '<script src="' + dep + '"></script>\n';
 36 |       });
 37 | 
 38 |       angular.forEach((attr.ngHtmlWrapLoaded || '').split(' '), function(dep) {
 39 |         if (!dep) return;
 40 |         var ext = dep.split(/\./).pop();
 41 | 
 42 |         if (ext == 'css') {
 43 |           properties.head += '<link rel="stylesheet" href="' + dep + '" type="text/css">\n';
 44 |         } else if(ext == 'js' && dep !== 'angular.js') {
 45 |           properties.head += '<script src="' + (loadedUrls[dep] || dep) + '"></script>\n';
 46 |         } else if (dep !== 'angular.js') {
 47 |           properties.module = '="' + dep + '"';
 48 |         }
 49 |       });
 50 | 
 51 |       setHtmlIe8SafeWay(element, escape(templateMerge(html, properties)));
 52 |     }
 53 |   };
 54 | };
 55 | 
 56 | 
 57 | docsApp.directive.focused = function($timeout) {
 58 |   return function(scope, element, attrs) {
 59 |     element[0].focus();
 60 |     element.on('focus', function() {
 61 |       scope.$apply(attrs.focused + '=true');
 62 |     });
 63 |     element.on('blur', function() {
 64 |       // have to use $timeout, so that we close the drop-down after the user clicks,
 65 |       // otherwise when the user clicks we process the closing before we process the click.
 66 |       $timeout(function() {
 67 |         scope.$eval(attrs.focused + '=false');
 68 |       });
 69 |     });
 70 |     scope.$eval(attrs.focused + '=true');
 71 |   };
 72 | };
 73 | 
 74 | 
 75 | docsApp.directive.code = function() {
 76 |   return { restrict:'E', terminal: true };
 77 | };
 78 | 
 79 | 
 80 | docsApp.directive.sourceEdit = function(getEmbeddedTemplate) {
 81 |   return NG_DOCS.editExample ? {
 82 |     template: '<a class="btn pull-right" ng-click="plunkr($event)" href>' +
 83 |       '<i class="icon-pencil"></i> Edit in Plunkr</a>',
 84 |     scope: true,
 85 |     controller: function($scope, $attrs, openPlunkr) {
 86 |       var sources = {
 87 |         module: $attrs.sourceEdit,
 88 |         deps: read($attrs.sourceEditDeps),
 89 |         html: read($attrs.sourceEditHtml),
 90 |         css: read($attrs.sourceEditCss),
 91 |         js: read($attrs.sourceEditJs),
 92 |         unit: read($attrs.sourceEditUnit),
 93 |         scenario: read($attrs.sourceEditScenario)
 94 |       };
 95 |       $scope.plunkr = function(e) {
 96 |         e.stopPropagation();
 97 |         openPlunkr(sources);
 98 |       };
 99 |     }
100 |   } : {};
101 | 
102 |   function read(text) {
103 |     var files = [];
104 |     angular.forEach(text ? text.split(' ') : [], function(refId) {
105 |       // refId is index.html-343, so we need to strip the unique ID when exporting the name
106 |       files.push({name: refId.replace(/-\d+$/, ''), content: getEmbeddedTemplate(refId)});
107 |     });
108 |     return files;
109 |   }
110 | };
111 | 
112 | 
113 | docsApp.serviceFactory.loadedUrls = function($document) {
114 |   var urls = {};
115 |     var tmp = document.createElement ('a');
116 | 
117 |   angular.forEach($document.find('script'), function(script) {
118 |     tmp.href = script.src;
119 |     var match = script.src.match(/^.*\/([^\/]*\.js)$/);
120 |     if (match) {
121 |       urls[tmp.pathname] = match[0];
122 |     }
123 |   });
124 | 
125 |   urls.base = [];
126 |   angular.forEach(NG_DOCS.scripts, function(script) {
127 |     tmp.href = script;
128 |     var match = urls[tmp.pathname];
129 |     if (match) {
130 |       urls.base.push(match);
131 |     }
132 |   });
133 | 
134 |   return urls;
135 | };
136 | 
137 | 
138 | docsApp.serviceFactory.formPostData = function($document) {
139 |   return function(url, fields) {
140 |     var form = angular.element('<form style="display: none;" method="post" action="' + url + '" target="_blank"></form>');
141 |     angular.forEach(fields, function(value, name) {
142 |       var input = angular.element('<input type="hidden" name="' +  name + '">');
143 |       input.attr('value', value);
144 |       form.append(input);
145 |     });
146 |     $document.find('body').append(form);
147 |     form[0].submit();
148 |     form.remove();
149 |   };
150 | };
151 | 
152 | docsApp.serviceFactory.openPlunkr = function(templateMerge, formPostData, loadedUrls) {
153 |   return function(content) {
154 |     var allFiles = [].concat(content.js, content.css, content.html);
155 |     var indexHtmlContent = '<!doctype html>\n' +
156 |         '<html ng-app="{{module}}">\n' +
157 |         '  <head>\n' +
158 |         '{{scriptDeps}}' +
159 |         '  </head>\n' +
160 |         '  <body>\n\n' +
161 |         '{{indexContents}}\n\n' +
162 |         '  </body>\n' +
163 |         '</html>\n';
164 |     var scriptDeps = '';
165 |     angular.forEach(loadedUrls.base, function(url) {
166 |         scriptDeps += '    <script src="' + url + '"></script>\n';
167 |     });
168 |     angular.forEach(allFiles, function(file) {
169 |       var ext = file.name.split(/\./).pop();
170 |         if (ext == 'css') {
171 |           scriptDeps += '    <link rel="stylesheet" href="' + file.name + '" type="text/css">\n';
172 |         } else if (ext == 'js' && file.name !== 'angular.js') {
173 |         scriptDeps += '    <script src="' + file.name + '"></script>\n';
174 |       }
175 |     });
176 |     indexProp = {
177 |       module: content.module,
178 |       scriptDeps: scriptDeps,
179 |       indexContents: content.html[0].content
180 |     };
181 | 
182 |     var postData = {};
183 |     angular.forEach(allFiles, function(file, index) {
184 |       if (file.content && file.name != 'index.html') {
185 |         postData['files[' + file.name + ']'] = file.content;
186 |       }
187 |     });
188 | 
189 |     postData['files[index.html]'] = templateMerge(indexHtmlContent, indexProp);
190 |     postData['tags[]'] = "angularjs";
191 | 
192 |     postData.private = true;
193 |     postData.description = 'AngularJS Example Plunkr';
194 | 
195 |     formPostData('http://plnkr.co/edit/?p=preview', postData);
196 |   };
197 | };
198 | 
199 | 
200 | docsApp.serviceFactory.sections = function serviceFactory() {
201 |   var sections = {
202 |     getPage: function(sectionId, partialId) {
203 |       var pages = sections[sectionId];
204 | 
205 |       if (pages) {
206 |         partialId = partialId || 'index';
207 | 
208 |         for (var i = 0, ii = pages.length; i < ii; i++) {
209 |           if (pages[i].id == partialId) {
210 |             return pages[i];
211 |           }
212 |         }
213 |       }
214 |       return null;
215 |     }
216 |   };
217 | 
218 |   angular.forEach(NG_DOCS.pages, function(page) {
219 |     var url = page.section + '/' +  page.id;
220 |     if (page.id == 'angular.Module') {
221 |       page.partialUrl = 'partials/api/angular.IModule.html';
222 |     } else {
223 |       page.partialUrl = 'partials/' + url.replace(':', '.') + '.html';
224 |     }
225 |     page.url = (NG_DOCS.html5Mode ? '' : '#/') + url;
226 |     if (!sections[page.section]) { sections[page.section] = []; }
227 |     sections[page.section].push(page);
228 |   });
229 | 
230 |   return sections;
231 | };
232 | 
233 | 
234 | docsApp.controller.DocsController = function($scope, $location, $window, sections) {
235 |   var INDEX_PATH = /^(\/|\/index[^\.]*.html)$/,
236 |       GLOBALS = /^angular\.([^\.]+)$/,
237 |       MODULE = /^([^\.]+)$/,
238 |       MODULE_MOCK = /^angular\.mock\.([^\.]+)$/,
239 |       MODULE_CONTROLLER = /^(.+)\.controllers?:([^\.]+)$/,
240 |       MODULE_DIRECTIVE = /^(.+)\.directives?:([^\.]+)$/,
241 |       MODULE_DIRECTIVE_INPUT = /^(.+)\.directives?:input\.([^\.]+)$/,
242 |       MODULE_FILTER = /^(.+)\.filters?:([^\.]+)$/,
243 |       MODULE_CUSTOM = /^(.+)\.([^\.]+):([^\.]+)$/,
244 |       MODULE_SERVICE = /^(.+)\.([^\.]+?)(Provider)?$/,
245 |       MODULE_TYPE = /^([^\.]+)\..+\.([A-Z][^\.]+)$/;
246 | 
247 | 
248 |   /**********************************
249 |    Publish methods
250 |    ***********************************/
251 | 
252 |   $scope.navClass = function(page1, page2) {
253 |     return {
254 |       first: this.$first,
255 |       last: this.$last,
256 |       active: page1 && this.currentPage == page1 || page2 && this.currentPage == page2,
257 |       match: this.focused && this.currentPage != page1 &&
258 |              this.bestMatch.rank > 0 && this.bestMatch.page == page1
259 | 
260 |     };
261 |   };
262 | 
263 |   $scope.isActivePath = function(url) {
264 |     if (url.charAt(0) == '#') {
265 |       url = url.substring(1, url.length);
266 |     }
267 |     return $location.path().indexOf(url) > -1;
268 |   };
269 | 
270 |   $scope.submitForm = function() {
271 |     if ($scope.bestMatch) {
272 |       var url =  $scope.bestMatch.page.url;
273 |       $location.path(NG_DOCS.html5Mode ? url : url.substring(1));
274 |     }
275 |   };
276 | 
277 |   $scope.afterPartialLoaded = function() {
278 |     var currentPageId = $location.path();
279 |     $scope.partialTitle = $scope.currentPage.shortName;
280 |     $window._gaq && $window._gaq.push(['_trackPageview', currentPageId]);
281 |     loadDisqus(currentPageId);
282 |   };
283 | 
284 | 
285 |   /**********************************
286 |    Watches
287 |    ***********************************/
288 | 
289 |   $scope.sections = {};
290 |   angular.forEach(NG_DOCS.sections, function(section, url) {
291 |     $scope.sections[(NG_DOCS.html5Mode ? '' : '#/') + url] = section;
292 |   });
293 |   $scope.$watch(function docsPathWatch() {return $location.path(); }, function docsPathWatchAction(path) {
294 |     var parts = path.split('/'),
295 |       sectionId = parts[1],
296 |       partialId = parts[2],
297 |       page, sectionName = $scope.sections[(NG_DOCS.html5Mode ? '' : '#/') + sectionId];
298 | 
299 |     if (!sectionName) { return; }
300 | 
301 |     $scope.currentPage = page = sections.getPage(sectionId, partialId);
302 | 
303 |     if (!$scope.currentPage) {
304 |       $scope.partialTitle = 'Error: Page Not Found!';
305 |       page = {};
306 |     }
307 | 
308 |     updateSearch();
309 | 
310 | 
311 |     // Update breadcrumbs
312 |     var breadcrumb = $scope.breadcrumb = [],
313 |       match, sectionPath = (NG_DOCS.html5Mode ? '' : '#/') +  sectionId;
314 | 
315 |     if (partialId) {
316 |       breadcrumb.push({ name: sectionName, url: sectionPath });
317 |       if (partialId == 'angular.Module') {
318 |         breadcrumb.push({ name: 'angular.Module' });
319 |       } else if (match = partialId.match(GLOBALS)) {
320 |         breadcrumb.push({ name: partialId });
321 |       } else if (match = partialId.match(MODULE)) {
322 |         match[1] = page.moduleName || match[1];
323 |         breadcrumb.push({ name: match[1] });
324 |       } else if (match = partialId.match(MODULE_FILTER)) {
325 |         match[1] = page.moduleName || match[1];
326 |         breadcrumb.push({ name: match[1], url: sectionPath + '/' + match[1] });
327 |         breadcrumb.push({ name: match[2] });
328 |       } else if (match = partialId.match(MODULE_CONTROLLER)) {
329 |         breadcrumb.push({ name: match[1], url: sectionPath + '/' + match[1] });
330 |         breadcrumb.push({ name: match[2] });
331 |       } else if (match = partialId.match(MODULE_DIRECTIVE)) {
332 |         breadcrumb.push({ name: match[1], url: sectionPath + '/' + match[1] });
333 |         breadcrumb.push({ name: match[2] });
334 |       } else if (match = partialId.match(MODULE_DIRECTIVE_INPUT)) {
335 |         breadcrumb.push({ name: match[1], url: sectionPath + '/' + match[1] });
336 |         breadcrumb.push({ name: 'input' });
337 |         breadcrumb.push({ name: match[2] });
338 |       } else if (match = partialId.match(MODULE_CUSTOM)) {
339 |         match[1] = page.moduleName || match[1];
340 |         breadcrumb.push({ name: match[1], url: sectionPath + '/' + match[1] });
341 |         breadcrumb.push({ name: match[3] });
342 |       } else if (match = partialId.match(MODULE_TYPE)) {
343 |         match[1] = page.moduleName || match[1];
344 |         breadcrumb.push({ name: match[1], url: sectionPath + '/' + match[1] });
345 |         breadcrumb.push({ name: match[2] });
346 |       }  else if (match = partialId.match(MODULE_SERVICE)) {
347 |         if ( page.type === 'overview') {
348 |           // module name with dots looks like a service
349 |           breadcrumb.push({ name: partialId });
350 |         } else {
351 |           match[1] = page.moduleName || match[1];
352 |           breadcrumb.push({ name: match[1], url: sectionPath + '/' + match[1] });
353 |           breadcrumb.push({ name: match[2] + (match[3] || '') });
354 |         }
355 |       } else if (match = partialId.match(MODULE_MOCK)) {
356 |         breadcrumb.push({ name: 'angular.mock.' + match[1] });
357 |       } else {
358 |         breadcrumb.push({ name: page.shortName });
359 |       }
360 |     } else {
361 |       breadcrumb.push({ name: sectionName });
362 |     }
363 |   });
364 | 
365 |   $scope.$watch('search', updateSearch);
366 | 
367 | 
368 | 
369 |   /**********************************
370 |    Initialize
371 |    ***********************************/
372 | 
373 |   $scope.versionNumber = angular.version.full;
374 |   $scope.version = angular.version.full + "  " + angular.version.codeName;
375 |   $scope.futurePartialTitle = null;
376 |   $scope.loading = 0;
377 | 
378 |   if (!$location.path() || INDEX_PATH.test($location.path())) {
379 |     $location.path(NG_DOCS.startPage).replace();
380 |   }
381 | 
382 |   /**********************************
383 |    Private methods
384 |    ***********************************/
385 | 
386 |   function updateSearch() {
387 |     var cache = {},
388 |         pages = sections[$location.path().split('/')[1]],
389 |         modules = $scope.modules = [],
390 |         otherPages = $scope.pages = [],
391 |         search = $scope.search,
392 |         bestMatch = {page: null, rank:0};
393 | 
394 |     angular.forEach(pages, function(page) {
395 |       var match,
396 |         id = page.id,
397 |         section = page.section;
398 | 
399 |       if (!(match = rank(page, search))) return;
400 | 
401 |       if (match.rank > bestMatch.rank) {
402 |         bestMatch = match;
403 |       }
404 | 
405 |       if (page.id == 'index') {
406 |         //skip
407 |       } else if (!NG_DOCS.apis[section]) {
408 |         otherPages.push(page);
409 |       } else if (id == 'angular.Module') {
410 |         module('ng', section).types.push(page);
411 |       } else if (match = id.match(GLOBALS)) {
412 |         module('ng', section).globals.push(page);
413 |       } else if (match = id.match(MODULE)) {
414 |         module(page.moduleName || match[1], section);
415 |       } else if (match = id.match(MODULE_FILTER)) {
416 |         module(page.moduleName || match[1], section).filters.push(page);
417 |       } else if (match = id.match(MODULE_CONTROLLER) && page.type === 'controller') {
418 |         module(page.moduleName || match[1], section).controllers.push(page);
419 |       } else if (match = id.match(MODULE_DIRECTIVE)) {
420 |         module(page.moduleName || match[1], section).directives.push(page);
421 |       } else if (match = id.match(MODULE_DIRECTIVE_INPUT)) {
422 |         module(page.moduleName || match[1], section).directives.push(page);
423 |       } else if (match = id.match(MODULE_CUSTOM)) {
424 |         if (page.type === 'service') {
425 |           module(page.moduleName || match[1], section).service(match[3])[page.id.match(/^.+Provider$/) ? 'provider' : 'instance'] = page;
426 |         } else {
427 |           var m = module(page.moduleName || match[1], section),
428 |             listName = page.type + 's';
429 | 
430 |           if (m[listName]) {
431 |             m[listName].push(page);
432 |           } else {
433 |             m.others.push(page);
434 |           }
435 |         }
436 |       } else if (match = id.match(MODULE_TYPE) && page.type === 'type') {
437 |         module(page.moduleName || match[1], section).types.push(page);
438 |       } else if (match = id.match(MODULE_SERVICE)) {
439 |         if (page.type === 'overview') {
440 |           module(id, section);
441 |         } else {
442 |           module(page.moduleName || match[1], section).service(match[2])[match[3] ? 'provider' : 'instance'] = page;
443 |         }
444 |       } else if (match = id.match(MODULE_MOCK)) {
445 |         module('ngMock', section).globals.push(page);
446 |       }
447 | 
448 |     });
449 | 
450 |     $scope.bestMatch = bestMatch;
451 | 
452 |     /*************/
453 | 
454 |     function module(name, section) {
455 |       var module = cache[name];
456 |       if (!module) {
457 |         module = cache[name] = {
458 |           name: name,
459 |           url: (NG_DOCS.html5Mode ? '' : '#/') + section + '/' + name,
460 |           globals: [],
461 |           controllers: [],
462 |           directives: [],
463 |           services: [],
464 |           others: [],
465 |           service: function(name) {
466 |             var service =  cache[this.name + ':' + name];
467 |             if (!service) {
468 |               service = {name: name};
469 |               cache[this.name + ':' + name] = service;
470 |               this.services.push(service);
471 |             }
472 |             return service;
473 |           },
474 |           types: [],
475 |           filters: []
476 |         };
477 |         modules.push(module);
478 |       }
479 |       return module;
480 |     }
481 | 
482 |     function rank(page, terms) {
483 |       var ranking = {page: page, rank:0},
484 |         keywords = page.keywords,
485 |         title = page.shortName.toLowerCase();
486 | 
487 |       terms && angular.forEach(terms.toLowerCase().split(' '), function(term) {
488 |         var index;
489 | 
490 |         if (ranking) {
491 |           if (keywords.indexOf(term) == -1) {
492 |             ranking = null;
493 |           } else {
494 |             ranking.rank ++; // one point for each term found
495 |             if ((index = title.indexOf(term)) != -1) {
496 |               ranking.rank += 20 - index; // ten points if you match title
497 |             }
498 |           }
499 |         }
500 |       });
501 |       return ranking;
502 |     }
503 |   }
504 | 
505 | 
506 |   function loadDisqus(currentPageId) {
507 |     if (!NG_DOCS.discussions) { return; }
508 |     // http://docs.disqus.com/help/2/
509 |     window.disqus_shortname = NG_DOCS.discussions.shortName;
510 |     window.disqus_identifier = currentPageId;
511 |     window.disqus_url = NG_DOCS.discussions.url + currentPageId;
512 |     window.disqus_developer = NG_DOCS.discussions.dev;
513 | 
514 |     // http://docs.disqus.com/developers/universal/
515 |     (function() {
516 |       var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
517 |       dsq.src = '//angularjs.disqus.com/embed.js';
518 |       (document.getElementsByTagName('head')[0] ||
519 |         document.getElementsByTagName('body')[0]).appendChild(dsq);
520 |     })();
521 | 
522 |     angular.element(document.getElementById('disqus_thread')).html('');
523 |   }
524 | };
525 | 
526 | angular.module('docsApp', ['ngAnimate', 'bootstrap', 'bootstrapPrettify']).
527 |   config(function($locationProvider) {
528 |     if (NG_DOCS.html5Mode) {
529 |       $locationProvider.html5Mode(true).hashPrefix('!');
530 |     }
531 |   }).
532 |   factory(docsApp.serviceFactory).
533 |   directive(docsApp.directive).
534 |   controller(docsApp.controller);
535 | 


--------------------------------------------------------------------------------