Ver código fonte

Merge pull request #443 from ckeditor/t/442

Internal: Added gulp task for generating JSDoc output only. Closes #442.
Piotrek Koszuliński 8 anos atrás
pai
commit
6b03a34f75
1 arquivos alterados com 22 adições e 15 exclusões
  1. 22 15
      gulpfile.js

+ 22 - 15
gulpfile.js

@@ -38,16 +38,21 @@ function getTestOptions() {
 // Documentation. -------------------------------------------------------------
 
 gulp.task( 'docs', () => {
-	assertIsInstalled( '@ckeditor/ckeditor5-dev-docs' );
-	assertIsInstalled( 'umberto' );
-
-	const umberto = require( 'umberto' );
-	const ckeditor5Docs = require( '@ckeditor/ckeditor5-dev-docs' );
-
 	if ( process.argv[ 3 ] == '--no-api' ) {
 		return runUmberto();
 	}
 
+	return buildApiDocs()
+		.then( runUmberto );
+} );
+
+gulp.task( 'docs:api-json', buildApiDocs );
+
+function buildApiDocs() {
+	assertIsInstalled( '@ckeditor/ckeditor5-dev-docs' );
+
+	const ckeditor5Docs = require( '@ckeditor/ckeditor5-dev-docs' );
+
 	return ckeditor5Docs
 		.build( {
 			readmePath: path.join( process.cwd(), 'README.md' ),
@@ -55,16 +60,18 @@ gulp.task( 'docs', () => {
 				process.cwd() + '/packages/ckeditor5-*/src/**/*.@(js|jsdoc)',
 				'!' + process.cwd() + '/packages/ckeditor5-*/src/lib/**/*.js'
 			]
-		} )
-		.then( runUmberto );
-
-	function runUmberto() {
-		return umberto.buildSingleProject( {
-			configDir: 'docs',
-			clean: true
 		} );
-	}
-} );
+}
+
+function runUmberto() {
+	assertIsInstalled( 'umberto' );
+	const umberto = require( 'umberto' );
+
+	return umberto.buildSingleProject( {
+		configDir: 'docs',
+		clean: true
+	} );
+}
 
 // Translations. --------------------------------------------------------------