FilesExpand file tree

 master

/

gen-docs.js

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

executable file

·

95 lines (69 loc) · 3.63 KB

 master

/

gen-docs.js

Copy path

Top

File metadata and controls

• Code
• Blame

executable file

·

95 lines (69 loc) · 3.63 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

var reader = require('./reader.js'),

ngdoc = require('./ngdoc.js'),

writer = require('./writer.js'),

SiteMap = require('./SiteMap.js').SiteMap,

appCache = require('./appCache.js').appCache,

Q = require('qq');

process.on('uncaughtException', function(err) {

console.error(err.stack || err);

});

var start = now();

var docs;

writer.makeDir('build/docs/', true).then(function() {

return writer.makeDir('build/docs/partials/');

}).then(function() {

console.log('Generating AngularJS Reference Documentation...');

return reader.collect();

}).then(function generateHtmlDocPartials(docs_) {

docs = docs_;

ngdoc.merge(docs);

var fileFutures = [];

docs.forEach(function(doc){

// this hack is here because on OSX angular.module and angular.Module map to the same file.

var id = doc.id.replace('angular.Module', 'angular.IModule');

fileFutures.push(writer.output('partials/' + doc.section + '/' + id + '.html', doc.html()));

});

writeTheRest(fileFutures);

return Q.deep(fileFutures);

}).then(function generateManifestFile() {

return appCache('build/docs/').then(function(list) {

writer.output('appcache-offline.manifest', list);

});

}).then(function printStats() {

console.log('DONE. Generated ' + docs.length + ' pages in ' + (now()-start) + 'ms.' );

}).end();

function writeTheRest(writesFuture) {

var metadata = ngdoc.metadata(docs);

writesFuture.push(writer.symlinkTemplate('css'));

writesFuture.push(writer.symlinkTemplate('font'));

writesFuture.push(writer.symlink('../../docs/img', 'build/docs/img'));

writesFuture.push(writer.symlinkTemplate('js'));

var manifest = 'manifest="/build/docs/appcache.manifest"';

writesFuture.push(writer.copy('docs/src/templates/index.html', 'index.html',

writer.replace, {'doc:manifest': ''})); //manifest //TODO(i): enable

writesFuture.push(writer.copy('docs/src/templates/index.html', 'index-nocache.html',

writer.replace, {'doc:manifest': ''}));

writesFuture.push(writer.copy('docs/src/templates/index.html', 'index-jq.html',

writer.replace, {'doc:manifest': ''}));

writesFuture.push(writer.copy('docs/src/templates/index.html', 'index-jq-nocache.html',

writer.replace, {'doc:manifest': ''}));

writesFuture.push(writer.copy('docs/src/templates/index.html', 'index-debug.html',

writer.replace, {'doc:manifest': ''}));

writesFuture.push(writer.copy('docs/src/templates/index.html', 'index-jq-debug.html',

writer.replace, {'doc:manifest': ''}));

writesFuture.push(writer.symlinkTemplate('offline.html'));

writesFuture.push(writer.copyTemplate('docs-scenario.html')); // will be rewritten, don't symlink

writesFuture.push(writer.output('docs-scenario.js', ngdoc.scenarios(docs)));

writesFuture.push(writer.output('docs-keywords.js',

['NG_PAGES=', JSON.stringify(metadata).replace(/{/g, '\n{'), ';']));

writesFuture.push(writer.output('sitemap.xml', new SiteMap(docs).render()));

writesFuture.push(writer.output('robots.txt', 'Sitemap: http://docs.angularjs.org/sitemap.xml\n'));

writesFuture.push(writer.output('appcache.manifest',appCache()));

writesFuture.push(writer.copyTemplate('.htaccess')); // will be rewritten, don't symlink

writesFuture.push(writer.symlinkTemplate('app.yaml'));

writesFuture.push(writer.symlinkTemplate('index.yaml'));

writesFuture.push(writer.symlinkTemplate('favicon.ico'));

writesFuture.push(writer.symlinkTemplate('main.py'));

}

function now() { return new Date().getTime(); }

function noop() {};