[\s\S]*?<\/pre>)/),
+ match;
+
+ parts.forEach(function(text, i){
+ if (text.match(/^/)) {
+ text = text.
+ replace(/^/, '').
+ replace(/<\/pre>/, '
');
+ } else {
+ text = text.replace(/' +
+ (match[4] || match[1]) +
+ '');
+ }
+ }
+ parts[i] = text;
+ });
+ return parts.join('');
+};
+var R_LINK = /{@link ([^\s}]+)((\s|\n)+(.+?))?\s*}/m;
+ // 1 123 3 4 42
+function markdownNoP(text) {
+ var lines = markdown(text).split(NEW_LINE);
+ var last = lines.length - 1;
+ lines[0] = lines[0].replace(/^/, '');
+ lines[last] = lines[last].replace(/<\/p>$/, '');
+ return lines.join('\n');
+}
+
+
+//////////////////////////////////////////////////////////
+function scenarios(docs){
+ var specs = [];
+ docs.forEach(function(doc){
+ if (doc.scenario) {
+ specs.push('describe("');
+ specs.push(doc.name);
+ specs.push('", function(){\n');
+ specs.push(' beforeEach(function(){\n');
+ specs.push(' browser().navigateTo("index.html#!' + doc.name + '");');
+ specs.push(' });\n\n');
+ specs.push(doc.scenario);
+ specs.push('\n});\n\n');
+ }
+ });
+ return specs;
+}
+
+
+//////////////////////////////////////////////////////////
+function metadata(docs){
+ var words = [];
+ docs.forEach(function(doc){
+ words.push({
+ name:doc.name,
+ type: doc.ngdoc,
+ keywords:doc.keywords()
+ });
+ });
+ words.sort(keywordSort);
+ return words;
+}
+
+function keywordSort(a,b){
+ // supper ugly comparator that orders all utility methods and objects before all the other stuff
+ // like widgets, directives, services, etc.
+ // Mother of all beautiful code please forgive me for the sin that this code certainly is.
+
+ if (a.name === b.name) return 0;
+ if (a.name === 'angular') return -1;
+ if (b.name === 'angular') return 1;
+
+ function namespacedName(page) {
+ return (page.name.match(/\./g).length === 1 && page.type !== 'overview' ? '0' : '1') + page.name;
+ }
+
+ var namespacedA = namespacedName(a),
+ namespacedB = namespacedName(b);
+
+ return namespacedA < namespacedB ? -1 : 1;
+}
+
+
+//////////////////////////////////////////////////////////
+function trim(text) {
+ var MAX = 9999;
+ var empty = RegExp.prototype.test.bind(/^\s*$/);
+ var lines = text.split('\n');
+ var minIndent = MAX;
+ lines.forEach(function(line){
+ minIndent = Math.min(minIndent, indent(line));
+ });
+ for ( var i = 0; i < lines.length; i++) {
+ lines[i] = lines[i].substring(minIndent);
+ }
+ // remove leading lines
+ while (empty(lines[0])) {
+ lines.shift();
+ }
+ // remove trailing
+ while (empty(lines[lines.length - 1])) {
+ lines.pop();
+ }
+ return lines.join('\n');
+
+ function indent(line) {
+ for(var i = 0; i < line.length; i++) {
+ if (line.charAt(i) != ' ') {
+ return i;
+ }
+ }
+ return MAX;
+ }
+}
+
+//////////////////////////////////////////////////////////
+function merge(docs){
+ var byName = {};
+ docs.forEach(function(doc){
+ byName[doc.name] = doc;
+ });
+ for(var i=0; i b.name ? 1 : 0);
+ }
+}
+//////////////////////////////////////////////////////////
+
+function property(name) {
+ return function(value){
+ return value[name];
+ };
+}
\ No newline at end of file
diff --git a/docs/src/reader.js b/docs/src/reader.js
new file mode 100644
index 00000000..8f9f22c3
--- /dev/null
+++ b/docs/src/reader.js
@@ -0,0 +1,91 @@
+/**
+ * All reading related code here. This is so that we can separate the async code from sync code
+ * for testability
+ */
+require.paths.push(__dirname);
+var fs = require('fs'),
+ callback = require('callback');
+
+var NEW_LINE = /\n\r?/;
+
+function collect(callback){
+ findJsFiles('src', callback.waitMany(function(file) {
+ //console.log('reading', file, '...');
+ findNgDocInJsFile(file, callback.waitMany(function(doc, line) {
+ callback(doc, file, line);
+ }));
+ }));
+ findNgDocInDir('docs/', callback.waitMany(callback));
+ callback.done();
+}
+
+function findJsFiles(dir, callback){
+ fs.readdir(dir, callback.waitFor(function(err, files){
+ if (err) return this.error(err);
+ files.forEach(function(file){
+ var path = dir + '/' + file;
+ fs.lstat(path, callback.waitFor(function(err, stat){
+ if (err) return this.error(err);
+ if (stat.isDirectory())
+ findJsFiles(path, callback.waitMany(callback));
+ else if (/\.js$/.test(path))
+ callback(path);
+ }));
+ });
+ callback.done();
+ }));
+}
+
+function findNgDocInDir(directory, docNotify) {
+ fs.readdir(directory, docNotify.waitFor(function(err, files){
+ if (err) return this.error(err);
+ files.forEach(function(file){
+ //console.log('reading', directory + file, '...');
+ if (!file.match(/\.ngdoc$/)) return;
+ fs.readFile(directory + file, docNotify.waitFor(function(err, content){
+ if (err) return this.error(err);
+ docNotify(content.toString(), directory + file, 1);
+ }));
+ });
+ docNotify.done();
+ }));
+}
+
+function findNgDocInJsFile(file, callback) {
+ fs.readFile(file, callback.waitFor(function(err, content){
+ var lines = content.toString().split(NEW_LINE);
+ var text;
+ var startingLine ;
+ var match;
+ var inDoc = false;
+ lines.forEach(function(line, lineNumber){
+ lineNumber++;
+ // is the comment starting?
+ if (!inDoc && (match = line.match(/^\s*\/\*\*\s*(.*)$/))) {
+ line = match[1];
+ inDoc = true;
+ text = [];
+ startingLine = lineNumber;
+ }
+ // are we done?
+ if (inDoc && line.match(/\*\//)) {
+ text = text.join('\n');
+ text = text.replace(/^\n/, '');
+ if (text.match(/@ngdoc/)){
+ callback(text, startingLine);
+ }
+ doc = null;
+ inDoc = false;
+ }
+ // is the comment add text
+ if (inDoc){
+ text.push(line.replace(/^\s*\*\s?/, ''));
+ }
+ });
+ callback.done();
+ }));
+}
+
+
+
+exports.collect = collect;
\ No newline at end of file
diff --git a/docs/src/templates/doc_widgets.css b/docs/src/templates/doc_widgets.css
new file mode 100644
index 00000000..8361f105
--- /dev/null
+++ b/docs/src/templates/doc_widgets.css
@@ -0,0 +1,35 @@
+@namespace doc url("http://docs.angularjs.org/");
+
+doc\:example {
+ display: none;
+}
+
+ul.doc-example {
+ list-style-type: none;
+ position: relative;
+ font-size: 14px;
+}
+
+ul.doc-example > li {
+ border: 2px solid gray;
+ border-radius: 5px;
+ -moz-border-radius: 5px;
+ -webkit-border-radius: 5px;
+ background-color: white;
+ margin-bottom: 20px;
+}
+
+ul.doc-example > li.doc-example-heading {
+ border: none;
+ border-radius: none;
+ margin-bottom: -10px;
+}
+
+li.doc-example-live {
+ padding: 10px;
+ font-size: 1.2em;
+}
+
+div.syntaxhighlighter {
+ padding-bottom: 1px !important; /* fix to remove unnecessary scrollbars http://is.gd/gSMgC */
+}
\ No newline at end of file
diff --git a/docs/src/templates/doc_widgets.js b/docs/src/templates/doc_widgets.js
new file mode 100644
index 00000000..b119e326
--- /dev/null
+++ b/docs/src/templates/doc_widgets.js
@@ -0,0 +1,71 @@
+(function(){
+
+ var angularJsUrl;
+ var scripts = document.getElementsByTagName("script");
+ var filename = /(.*\/)angular([^\/]*)/;
+ for(var j = 0; j < scripts.length; j++) {
+ var src = scripts[j].src;
+ if (src && src.match(filename)) {
+ angularJsUrl = src;
+ }
+ }
+
+
+ var HTML_TEMPLATE =
+ '\n' +
+ '\n' +
+ ' \n' +
+ ' \n' +
+ '_HTML_SOURCE_\n' +
+ ' \n' +
+ '';
+
+ angular.widget('doc:example', function(element){
+ this.descend(true); //compile the example code
+ element.hide();
+
+ var example = element.find('doc\\:source').eq(0),
+ exampleSrc = example.text(),
+ scenario = element.find('doc\\:scenario').eq(0);
+
+ var code = indent(exampleSrc);
+ var tabs = angular.element(
+ '' +
+ 'Source
- ' +
+ '
' +
+ 'Live Preview
- ' + exampleSrc +'
' +
+ 'Scenario Test
' + scenario.text() + '
');
+
+ tabs.find('li.doc-example-source > pre').text(HTML_TEMPLATE.replace('_HTML_SOURCE_', code.html));
+
+ element.html('');
+ element.append(tabs);
+ element.show();
+
+ var script = (exampleSrc.match(/]*>([\s\S]*)<\/script>/) || [])[1] || '';
+ try {
+ eval(script);
+ } catch (e) {
+ alert(e);
+ }
+ });
+
+ function indent(text) {
+ var lines = text.split(/\n/);
+ var lineNo = [];
+ while (lines[0].match(/^\s*$/)) lines.shift();
+ while (lines[lines.length - 1].match(/^\s*$/)) lines.pop();
+ for ( var i = 0; i < lines.length; i++) {
+ lines[i] = ' ' + lines[i];
+ lineNo.push(6 + i);
+ }
+ return {html: lines.join('\n'), hilite: lineNo.join(',') };
+ };
+
+})();
\ No newline at end of file
diff --git a/docs/src/templates/docs-scenario.html b/docs/src/templates/docs-scenario.html
new file mode 100644
index 00000000..c75155c5
--- /dev/null
+++ b/docs/src/templates/docs-scenario.html
@@ -0,0 +1,10 @@
+
+
+
+ <angular/> Docs Scenario Runner
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/src/templates/docs-scenario.js b/docs/src/templates/docs-scenario.js
new file mode 100644
index 00000000..2ee8387b
--- /dev/null
+++ b/docs/src/templates/docs-scenario.js
@@ -0,0 +1,9 @@
+{{#pages}}
+describe('{{name}}', function(){
+ beforeEach(function(){
+ browser().navigateTo('index.html#!{{name}}');
+ });
+ // {{raw.file}}:{{raw.line}}
+{{{scenario}}}
+});
+{{/pages}}
diff --git a/docs/src/templates/docs.css b/docs/src/templates/docs.css
new file mode 100644
index 00000000..aaef7e58
--- /dev/null
+++ b/docs/src/templates/docs.css
@@ -0,0 +1,262 @@
+/* Common Style */
+
+body {
+ font-family: Arial, sans-serif;
+ font-size: 14px;
+ margin: 0;
+ padding: 0;
+}
+
+a {
+ color: blue;
+}
+
+
+/* Main Layout */
+
+#header {
+ height: 3.5em;
+}
+
+#sidebar,
+#main {
+ position: absolute;
+ top: 3.5em;
+ bottom: 0;
+ margin-top: 1px;
+ overflow-x: hidden;
+}
+
+#sidebar {
+ width: 13.8em;
+ padding: 0.8em 0em 1.5em 0.8em;
+}
+
+#main {
+ left: 14.6em;
+ right: 0;
+ padding: 1em;
+ overflow-y: scroll;
+}
+
+#api-list {
+ position: absolute;
+ top: 3em;
+ bottom: 1em;
+ overflow-y: scroll;
+ padding-right: 0.8em;
+}
+
+
+/* App Header */
+
+#header {
+ background-color: #F2C200;
+ border-bottom: 1px solid #957800;
+}
+
+#header h1 {
+ font-weight: normal;
+ font-size: 30px;
+ line-height: 30px;
+ margin: 0;
+ padding: 10px 10px;
+ height: 30px;
+}
+
+#header .angular {
+ font-family: "Courier New", monospace;
+ font-weight: bold;
+}
+
+#header h1 a {
+ color: black;
+ text-decoration: none;
+}
+
+#header h1 a:hover {
+ text-decoration: underline;
+}
+
+
+/* Main main Style */
+
+#main h1 {
+ font-family: monospace;
+ margin-top: 0;
+ padding-bottom: 5px;
+ border-bottom: 1px solid #CCC;
+}
+
+#main h2 {
+ margin-top: 1.8em;
+}
+
+#main h1 + h2 {
+ margin-top: 1.3em;
+}
+
+#main h3 {
+ margin-top: 1.5em;
+}
+
+#main ul.methods h3,
+#main ul.properties h3 {
+ margin-top: 1.5em;
+ font-family: "Courier New", monospace;
+}
+
+.main-title {
+ float: right;
+}
+
+
+/* Searchbox & Sidebar Style */
+
+#search-box, #sidebar {
+ border-right: 1px solid #DDD;
+}
+
+#sidebar {
+ background-color: #EEE;
+}
+
+#search-box {
+ width: 16em;
+ margin-bottom: 1em;
+}
+
+#sidebar a {
+ text-decoration: none;
+}
+
+#sidebar a:hover {
+ text-decoration: underline;
+}
+
+#sidebar ul {
+ list-style-type: none;
+ /*TODO(esprehn): Can we just reset globally and not break examples?*/
+ margin: 0;
+ padding: 0 0.8em 0 0;
+ width: 13em;
+}
+
+#sidebar ul li {
+}
+
+#sidebar ul li a {
+ display: block;
+ padding: 2px 2px 2px 4px;
+}
+
+#sidebar ul li.selected a {
+ background-color: #DDD;
+ border-radius: 5px;
+ -moz-border-radius: 5px;
+ border: 1px solid #CCC;
+ padding: 1px 1px 1px 3px;
+}
+
+#sidebar ul li.level-0 {
+ margin-left: 0em;
+ font-weight: bold;
+ font-size: 1.2em;
+}
+
+#sidebar ul li.level-1.level-angular {
+ font-family: monospace;
+ font-weight: normal;
+ font-size: 1em;
+ margin-top: 0;
+ margin-bottom: 0;
+}
+
+#sidebar ul li.level-1 {
+ margin-left: 1em;
+ margin-top: 5px;
+ font-size: 1.1em;
+ font-weight: bold;
+}
+
+#sidebar ul li.level-2 {
+ margin-left: 2em;
+ font-family: monospace;
+}
+
+#sidebar ul li.level-3 {
+ margin-left: 3em;
+ font-family: monospace;
+}
+
+
+/* Warning and Info Banners */
+
+.deprecated {
+ border: 2px solid red;
+}
+
+.deprecated legend {
+ font-weight: bold;
+ color: red;
+}
+
+.workInProgress {
+ border: 2px solid orange;
+}
+
+.workInProgress legend {
+ font-weight: bold;
+ color: orange;
+}
+
+
+/* Feedback Link */
+
+#feedback {
+ float: right;
+ width: 10em;
+ text-align: right;
+}
+
+
+/* Live Example Style */
+
+.doc-example-live table td {
+ padding: 0 1.5em;
+}
+
+
+/* Scrollbars */
+
+::-webkit-scrollbar{
+ width:0.8em;
+ margin: 0.2em 0em;
+}
+
+::-webkit-scrollbar:hover{
+ background-color:#eee;
+}
+
+::-webkit-scrollbar-thumb{
+ min-height:0.8em;
+ min-width:0.8em;
+ -webkit-border-radius:0.5em;
+ background-color: #ddd;
+}
+
+::-webkit-scrollbar-thumb:hover{
+ background-color: #bbb;
+}
+
+::-webkit-scrollbar-thumb:active{
+ background-color:#888;
+}
+
+#sidebar::-webkit-scrollbar {
+ background-color:#eee;
+}
+
+#main::-webkit-scrollbar {
+ background-color:#fff;
+}
diff --git a/docs/src/templates/docs.js b/docs/src/templates/docs.js
new file mode 100644
index 00000000..6bf86ed3
--- /dev/null
+++ b/docs/src/templates/docs.js
@@ -0,0 +1,47 @@
+DocsController.$inject = ['$location', '$browser', '$window'];
+function DocsController($location, $browser, $window) {
+ this.pages = NG_PAGES;
+ window.$root = this.$root;
+
+ this.getUrl = function(page){
+ return '#!' + page.name;
+ };
+
+ this.getCurrentPartial = function(){
+ return './' + this.getTitle() + '.html';
+ };
+
+ this.getTitle = function(){
+ var hashPath = $location.hashPath || '!angular';
+ if (hashPath.match(/^!angular/)) {
+ this.partialTitle = hashPath.substring(1);
+ }
+ return this.partialTitle;
+ };
+
+ this.getClass = function(page) {
+ var depth = page.name.split(/\./).length - 1,
+ cssClass = 'level-' + depth + (page.name == this.getTitle() ? ' selected' : '');
+
+ if (depth == 1 && page.type !== 'overview') cssClass += ' level-angular';
+
+ return cssClass;
+ };
+
+ this.afterPartialLoaded = function() {
+ SyntaxHighlighter.highlight();
+ };
+
+ this.getFeedbackUrl = function() {
+ return "mailto:angular@googlegroups.com?" +
+ "subject=" + escape("Feedback on " + $location.href) + "&" +
+ "body=" + escape("Hi there,\n\nI read " + $location.href + " and wanted to ask ....");
+ };
+
+}
+
+angular.filter('short', function(name){
+ return (name||'').split(/\./).pop();
+});
+
+SyntaxHighlighter['defaults'].toolbar = false;
diff --git a/docs/src/templates/index.html b/docs/src/templates/index.html
new file mode 100644
index 00000000..64b73bfc
--- /dev/null
+++ b/docs/src/templates/index.html
@@ -0,0 +1,45 @@
+
+
+
+ <angular/>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {{getTitle()}}
+ <angular/> Docs
+
+
+
+
+
+
diff --git a/docs/src/writer.js b/docs/src/writer.js
new file mode 100644
index 00000000..eb1b190f
--- /dev/null
+++ b/docs/src/writer.js
@@ -0,0 +1,61 @@
+/**
+ * All writing related code here. This is so that we can separate the async code from sync code
+ * for testability
+ */
+require.paths.push(__dirname);
+var fs = require('fs');
+var OUTPUT_DIR = "build/docs/";
+
+function output(docs, content, callback){
+ callback();
+}
+
+exports.output = function(file, content, callback){
+ //console.log('writing', OUTPUT_DIR + file, '...');
+ fs.writeFile(
+ OUTPUT_DIR + file,
+ exports.toString(content),
+ callback);
+};
+
+
+exports.toString = function toString(obj){
+ switch (typeof obj) {
+ case 'string':
+ return obj;
+ case 'object':
+ if (obj instanceof Array) {
+ obj.forEach(function (value, key){
+ obj[key] = toString(value);
+ });
+ return obj.join('');
+ } else {
+ return JSON.stringify(obj);
+ }
+ }
+ return obj;
+};
+
+exports.makeDir = function (path, callback) {
+ var parts = path.split(/\//);
+ path = '.';
+ (function next(){
+ if (parts.length) {
+ path += '/' + parts.shift();
+ fs.mkdir(path, 0777, next);
+ } else {
+ callback();
+ }
+ })();
+};
+
+exports.copy = function(filename, callback){
+ //console.log('writing', OUTPUT_DIR + filename, '...');
+ fs.readFile('docs/src/templates/' + filename, function(err, content){
+ if (err) return callback.error(err);
+ fs.writeFile(
+ OUTPUT_DIR + filename,
+ content,
+ callback);
+ });
+};
--
cgit v1.2.3