-
Notifications
You must be signed in to change notification settings - Fork 2
/
site.js
124 lines (103 loc) · 3.4 KB
/
site.js
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
let generatePageTree = require("./tree");
let resolvePath = require("faucet-pipeline-core/lib/util/resolve");
let { abort, repr } = require("faucet-pipeline-core/lib/util");
let mkdirp = require("mkdirp");
let fs = require("fs");
let path = require("path");
let { promisify } = require("util");
let PageRenderer = require("./page_renderer");
let generateLayout = require("./generate_layout");
let Navigation = require("./navigation");
let writeFile = promisify(fs.writeFile);
let DEFAULTS = {
renderers: {
html: require("./html")
},
generateLayout: generateLayout,
assetPath: "assets",
baseURI: "/"
};
module.exports = class Site {
constructor(config, assetManager) {
// validate essential settings
let { source, target } = config;
if(!target) {
abort(`ERROR: missing ${repr("target", false)} configuration for styleguide`);
}
let { referenceDir } = assetManager;
Object.assign(this, {
source,
target: resolvePath(target, referenceDir, { enforceRelative: true }),
assetPath: config.assetPath || DEFAULTS.assetPath,
baseURI: config.baseURI || DEFAULTS.baseURI,
renderers: config.renderers || DEFAULTS.renderers,
generateLayout: DEFAULTS.generateLayout,
assetManager
});
}
async generate(filepaths) {
if(filepaths) {
// TODO: no longer necessary when we can use nite-owl 4.0.0
filepaths = new Set(filepaths);
if(!this.tree.has(...filepaths)) {
return false;
}
} else {
await mkdirp(this.target);
}
let { tree, renderers, generateLayout } = this;
if(!tree || filepaths === null) {
tree = await this.load();
}
let dirs = new Set();
let preperations = tree.map(async page => {
let filepath = path.resolve(this.target, page.slug);
if(filepaths && !filepaths.has(filepath)) {
return;
}
if(!dirs.has(filepath)) {
await mkdirp(filepath);
dirs.add(filepath);
}
page.filepath = filepath;
return page.load();
});
await Promise.all(preperations);
let navigation = new Navigation({ baseURI: this.baseURI });
let layout = generateLayout(navigation.generate(tree), this.assetManager.manifest);
let pageRenderer = new PageRenderer({ renderers, layout });
let writes = tree.map(async page => {
let html = await pageRenderer.render(page);
// TODO: Report errors if something goes wrong
return this.writeFile(`${page.filepath}/index.html`, `${html}\n`);
});
await Promise.all(writes);
let renderedSnippets = await pageRenderer.renderedSnippets();
return Promise.all(renderedSnippets.map(({ html, page, slug }) => {
// TODO: Report errors if something goes wrong
return this.writeFile(`${page.filepath}/${slug}`, html);
}));
}
// NB: intentionally avoiding assetManager's writeFile because
// we do not want fingerprinting or manifest handling
async writeFile(path, content, { error } = {}) {
await writeFile(path, content, "utf8");
// TODO: this is currently a private method
await this.assetManager._report(path, error);
if(error && this.assetManager.exitOnError) {
abort(error);
}
}
// generates a URI for a given slug or `/`-delimited sequence thereof
pageURI(slugs) {
return path.join(this.baseURI, `${slugs}.html`); // TODO: validate slugs?
}
assetURI(filepath) {
return path.join(this.baseURI, this.assetPath, filepath); // TODO: validate?
}
// loads page hierarchy
async load() {
this.tree = generatePageTree(this.source, this.assetManager.referenceDir);
return this.tree;
}
};