wishthis/semantic/tasks/docs/build.js

112 lines
2.6 KiB
JavaScript
Raw Normal View History

2022-01-13 13:00:31 +00:00
/*******************************
Build Docs
*******************************/
var
gulp = require('gulp'),
// node dependencies
console = require('better-console'),
fs = require('fs'),
map = require('map-stream'),
// gulp dependencies
print = require('gulp-print').default,
// user config
config = require('../config/docs'),
// install config
tasks = require('../config/tasks'),
configSetup = require('../config/project/config'),
install = require('../config/project/install'),
// metadata parsing
metadata = require('./metadata'),
// build methods
buildJS = require('../build/javascript').buildJS,
buildCSS = require('../build/css').buildCSS,
buildAssets = require('../build/assets').buildAssets,
// shorthand
log = tasks.log
;
module.exports = function (callback) {
// use a different config
config = configSetup.addDerivedValues(config);
// shorthand
const globs = config.globs;
const output = config.paths.output;
/*--------------
Parse metadata
---------------*/
function buildMetaData() {
// parse all *.html.eco in docs repo, data will end up in
// metadata.result object. Note this assumes that the docs
// repository is present and in proper directory location as
// specified by docs.json.
console.info('Building Metadata');
return gulp.src(config.paths.template.eco + globs.eco)
.pipe(map(metadata.parser))
.on('end', function () {
fs.mkdirSync(output.metadata, {recursive: true});
fs.writeFileSync(output.metadata + '/metadata.json', JSON.stringify(metadata.result, null, 2));
});
}
/*--------------
Copy Examples
---------------*/
function copyExample() {
// copy src/ to server
console.info('Copying examples');
return gulp.src('examples/**/*.*')
.pipe(gulp.dest(output.examples))
.pipe(print(log.created));
}
/*--------------
Copy Source
---------------*/
function copyLess() {
// copy src/ to server
console.info('Copying LESS source');
return gulp.src('src/**/*.*')
.pipe(gulp.dest(output.less))
.pipe(print(log.created));
}
/*--------------
Build
---------------*/
console.info('Building Semantic for docs');
if (!install.isSetup()) {
console.error('Cannot build files. Run "gulp install" to set-up Semantic');
callback();
return;
}
gulp.series(
buildMetaData,
copyExample,
copyLess,
(callback) => buildJS('docs', config, callback),
(callback) => buildCSS('docs', config, {}, callback),
(callback) => buildAssets(config, callback)
)(callback);
};