/******************************* Serve Docs *******************************/ var gulp = require('gulp'), // node dependencies console = require('better-console'), fs = require('fs'), // gulp dependencies autoprefixer = require('gulp-autoprefixer'), chmod = require('gulp-chmod'), clone = require('gulp-clone'), gulpif = require('gulp-if'), header = require('gulp-header'), less = require('gulp-less'), minifyCSS = require('gulp-clean-css'), plumber = require('gulp-plumber'), print = require('gulp-print').default, rename = require('gulp-rename'), replace = require('gulp-replace'), uglify = require('gulp-uglify'), replaceExt = require('replace-ext'), // user config config = require('../config/docs'), // task config tasks = require('../config/tasks'), configSetup = require('../config/project/config'), install = require('../config/project/install'), {series, parallel} = gulp, // shorthand banner = tasks.banner, comments = tasks.regExp.comments, log = tasks.log, settings = tasks.settings, globs, assets, output, source, watchSRC, watchSRCCallback, watchExamples, watchExamplesCallback, watchCSS, watchCSSCallback, watchJS, watchJSCallback, watchAssets, watchAssetsCallback, serveDocs ; require('../collections/internal')(gulp); serveDocs = function () { // use a different config config = configSetup.addDerivedValues(config); // shorthand globs = config.globs; assets = config.paths.assets; output = config.paths.output; source = config.paths.source; /*-------------- Copy Source ---------------*/ watchSRC = gulp .watch([ 'src/**/*.*' ]) ; watchSRCCallback = function(filePath) { console.clear(); return gulp.src(filePath, { base: 'src/' }) .pipe(gulp.dest(output.less)) .pipe(print(log.created)) ; }; watchSRC .on('change', watchSRCCallback) .on('add', watchSRCCallback) ; /*-------------- Copy Examples ---------------*/ watchExamples = gulp .watch([ 'examples/**/*.*' ]) ; watchExamplesCallback = function(filePath) { console.clear(); return gulp.src(filePath, { base: 'examples/' }) .pipe(gulp.dest(output.examples)) .pipe(print(log.created)) ; }; watchSRC .on('change', watchExamplesCallback) .on('add', watchExamplesCallback) ; /*-------------- Watch CSS ---------------*/ watchCSS = gulp .watch([ source.config, source.definitions + '/**/*.less', source.site + '/**/*.{overrides,variables}', source.themes + '/**/*.{overrides,variables}' ]) ; watchCSSCallback = function(filePath) { let lessPath, stream, compressedStream, uncompressedStream, isDefinition, isPackagedTheme, isSiteTheme, isConfig ; // log modified file gulp.src(filePath) .pipe(print(log.modified)) ; /*-------------- Find Source ---------------*/ // recompile on *.override , *.variable change isConfig = (filePath.indexOf('theme.config') !== -1 || filePath.indexOf('site.variables') !== -1); isPackagedTheme = (filePath.indexOf(source.themes) !== -1); isSiteTheme = (filePath.indexOf(source.site) !== -1); isDefinition = (filePath.indexOf(source.definitions) !== -1); if(isConfig) { // console.info('Rebuilding all files'); // cant rebuild paths are wrong // gulp.start('build-docs'); return; } else if(isPackagedTheme) { console.log('Change detected in packaged theme'); lessPath = replaceExt(filePath, '.less'); lessPath = lessPath.replace(tasks.regExp.theme, source.definitions); } else if(isSiteTheme) { console.log('Change detected in site theme'); lessPath = replaceExt(filePath, '.less'); lessPath = lessPath.replace(source.site, source.definitions); } else { console.log('Change detected in definition'); lessPath = filePath; } /*-------------- Create CSS ---------------*/ if( fs.existsSync(lessPath) ) { // unified css stream stream = gulp.src(lessPath) .pipe(plumber()) .pipe(less(settings.less)) .pipe(replace(comments.variables.in, comments.variables.out)) .pipe(replace(comments.large.in, comments.large.out)) .pipe(replace(comments.small.in, comments.small.out)) .pipe(replace(comments.tiny.in, comments.tiny.out)) .pipe(autoprefixer(settings.prefix)) .pipe(gulpif(config.hasPermission, chmod(config.permission))) ; // use 2 concurrent streams from same pipe uncompressedStream = stream.pipe(clone()); compressedStream = stream.pipe(clone()); uncompressedStream .pipe(plumber()) .pipe(replace(assets.source, assets.uncompressed)) .pipe(header(banner, settings.header)) .pipe(gulp.dest(output.uncompressed)) .pipe(print(log.created)) .on('end', function() { gulp.start('package uncompressed docs css'); }) ; compressedStream .pipe(plumber()) .pipe(replace(assets.source, assets.compressed)) .pipe(minifyCSS(settings.minify)) .pipe(rename(settings.rename.minCSS)) .pipe(header(banner, settings.header)) .pipe(gulp.dest(output.compressed)) .pipe(print(log.created)) .on('end', function() { gulp.start('package compressed docs css'); }) ; } else { console.log('Cannot find UI definition at path', lessPath); } }; watchCSS .on('add', watchCSSCallback) .on('change', watchCSSCallback) ; /*-------------- Watch JS ---------------*/ watchJS = gulp .watch([ source.definitions + '/**/*.js' ]) ; watchJSCallback = function(filePath) { gulp.src(filePath) .pipe(plumber()) .pipe(gulpif(config.hasPermission, chmod(config.permission))) .pipe(gulp.dest(output.uncompressed)) .pipe(print(log.created)) .pipe(uglify(settings.uglify)) .pipe(rename(settings.rename.minJS)) .pipe(gulp.dest(output.compressed)) .pipe(print(log.created)) .on('end', function() { gulp.start('package compressed docs js'); gulp.start('package uncompressed docs js'); }) ; }; watchJS .on('add', watchJSCallback) .on('change', watchJSCallback) ; /*-------------- Watch Assets ---------------*/ // only copy assets that match component names (or their plural) watchAssets = gulp .watch([ source.themes + '/**/assets/**/' + globs.components + '?(s).*' ]) ; // copy assets watchAssetsCallback = function(filePath) { gulp.src(filePath, { base: source.themes }) .pipe(gulpif(config.hasPermission, chmod(config.permission))) .pipe(gulp.dest(output.themes)) .pipe(print(log.created)) ; }; watchAssets .on('add', watchAssetsCallback) .on('change', watchAssetsCallback) ; }; /* Export with Metadata */ serveDocs.displayName = 'serve-docs'; serveDocs.description = 'Serve file changes to SUI Docs'; module.exports = serveDocs;