umberto 7.0.1 → 8.0.0

package/src/api-builder/api-builder.js

@@ -19,8 +19,15 @@ const getDocSearchConfig = require( '../helpers/get-docsearch-config' );
 const splitLongname = require( '../helpers/split-longname' );
 const githubUrlUtils = require( '../helpers/github-url' );
 const getReportIssueWidgetUrl = require( '../../scripts/utils/getreportissuewidgeturl' );
-
+const getPageGroupHelper = require( '../../src/hexo/helper/get-page-group' );
 const findTargetDoclet = require( './utils/findtargetdoclet' );
+const writeHtmlFiles = require( '../../src/tasks/write-html-files' );
+
+const { randomId } = require( '../../scripts/utils/random-id' );
+const spritesheetSvg = require( '../../scripts/utils/spritesheet-svg' );
+const inlineSvg = require( '../../scripts/utils/inline-svg' );
+const parseHref = require( '../../scripts/utils/parse-href' );
+const hexoManager = require( '../hexo-manager' );
 
 /**
  * Renders HTML for every module, class, mixin etc.
@@ -117,7 +124,7 @@ module.exports = class ApiBuilder {
 		this.macrosVariables = config.macrosVariables;
 
 		const descriptionParser = new DescriptionParser( this._fileNameManager, this._dataCollection, {
-			macrosVariables: Object.assign( {}, config.projectConfig.variables, config.macrosVariables )
+			macrosVariables: Object.assign( {}, config.projectConfig.variables, config.macrosVariables, config.projectConfig )
 		} );
 
 		/**
@@ -156,6 +163,19 @@ module.exports = class ApiBuilder {
 		this._tmplCol.addHelper( 'getRealImportPath', this._getRealImportPath );
 		this._tmplCol.addHelper( 'getUrlAddressFromLongname', this._getUrlAddressFromLongname.bind( this ) );
 
+		this._tmplCol.addHelper( 'uParseHref', ( str, data ) => parseHref( str, {
+			path: data.path,
+			projectName: data.projectName,
+			projectGlobals: hexoManager.hexo.projectGlobals,
+			BASE_PATH: data.BASE_PATH
+		}, hexoManager.hexo, {
+			relativeUrlHelper: hexoManager.hexo.extend.helper.store.relative_url,
+			isSilentError: true
+		} ) );
+
+		this._tmplCol.addHelper( 'uRandomId', randomId );
+		this._tmplCol.addHelper( 'uCapitalize', capitalize );
+
 		this.canonicalUrlBeginning = config.canonicalUrlBeginning;
 	}
 
@@ -163,7 +183,7 @@ module.exports = class ApiBuilder {
 	 * Main function of this class. Renders HTML for all API items.
 	 * Also creates a JSON file, with entity names, used for additional API docs search.
 	 */
-	buildApi() {
+	async buildApi() {
 		const modulesData = this._dataCollection.get( 'module' ).getAll();
 		const classesData = this._dataCollection.get( 'class' ).getAll();
 		const interfacesData = this._dataCollection.get( 'interface' ).getAll();
@@ -183,14 +203,15 @@ module.exports = class ApiBuilder {
 		this._registerFilenames( concated );
 		this._buildNavTree( concated );
 		this._filterHtml = this._tmplCol.renderTemplate( '_partial/filter' );
-		const modules = this._getPages( modulesData, 'module' );
-		const classes = this._getPages( classesData, 'class' );
-		const interfaces = this._getPages( interfacesData, 'interface' );
-		const typedefs = this._getPages( typedefsData, 'typedef' );
-		const mixins = this._getPages( mixinsData, 'mixin' );
-		const namespaces = this._getPages( namespacesData, 'namespace' );
 
-		this._renderedFiles = [].concat( modules, classes, interfaces, typedefs, mixins, namespaces );
+		await this._getPages( modulesData, 'module' );
+		await this._getPages( classesData, 'class' );
+		await this._getPages( interfacesData, 'interface' );
+		await this._getPages( typedefsData, 'typedef' );
+		await this._getPages( mixinsData, 'mixin' );
+		await this._getPages( namespacesData, 'namespace' );
+
+		this._renderedFiles = [];
 
 		// Build API json data for search engine.
 		this._createApiSearchJson( [].concat(
@@ -358,20 +379,20 @@ module.exports = class ApiBuilder {
 			}
 		}
 
-		this._navTreeHtml = this._tmplCol.renderTemplate(
+		this._navTreeHtml = spritesheetSvg( this._tmplCol.renderTemplate(
 			'_partial/navtree',
 			{
 				projectLocals: {
 					apiTree: this._navTree
 				}
 			}
-		);
+		), false );
 	}
 
 	/**
 	 * Renders HTML of each API docs page and creates an HtmlFile instance for that page.
 	 */
-	_getPages( items, type ) {
+	async _getPages( items, type ) {
 		const views = [];
 
 		for ( const i of items ) {
@@ -396,7 +417,7 @@ module.exports = class ApiBuilder {
 				if ( data.kind === 'module' ) {
 					title = `${ capitalize( data.kind ) } ${ data.longname.replace( 'module:', '' ) }`;
 				} else {
-					title = `${ capitalize( data.kind ) } ${ capitalize( split.name ) } (${ data.longname.replace( 'module:', '' ) })`;
+					title = `${ capitalize( data.kind ) } ${ capitalize( split.name ) }`;
 				}
 
 				const $ = data.description ? cheerio.load( data.description.content, null, false ) : cheerio.load( '', null, false );
@@ -404,7 +425,7 @@ module.exports = class ApiBuilder {
 				html.find( 'pre' ).remove();
 				const desc = html.text().trim().replace( /\n/g, ' ' ).replace( / +/g, ' ' );
 
-				// eslint-disable-next-line max-len
+				// eslint-disable-next-line @stylistic/max-len
 				const metaDescription = `${ this._projectName } API Documentation. The ${ capitalize( data.kind ) } ${ data.kind === 'module' ? data.longname.replace( 'module:', '' ) : capitalize( split.name ) }.${ desc.length ? ' ' + desc : '' }`;
 
 				// Page properties needed by pug templates. They match page properties of guides generated by hexo.
@@ -442,23 +463,33 @@ module.exports = class ApiBuilder {
 						slug: this._projectSlug,
 						customRanking: this._projectConfig.docsearch ? this._projectConfig.docsearch.customRanking : []
 					} ),
-					projectVersion: this._projectConfig.version
+					projectVersion: this._projectConfig.version,
+					getPageGroup: getPageGroupHelper
 				};
+
 				const view = new HtmlFile(
 					this._tmplCol.renderTemplate(
 						type,
 						{
 							data,
-							navTree: this._navTreeHtml,
+							navTree: '%%_RENDERED_NAV_TREE_%%',
 							filter: this._filterHtml,
 							page,
 							projectLocals,
+							sitemap: this._projectConfig.sitemap,
 							docSearchConfig: getDocSearchConfig( this._docSearch )
 						}
 					),
 					filePath
 				);
-				views.push( view );
+
+				let content = inlineSvg( view.content );
+
+				content = spritesheetSvg( content );
+
+				view.content = content.replaceAll( '%%_RENDERED_NAV_TREE_%%', this._navTreeHtml );
+
+				await writeHtmlFiles( [ view ] );
 			}
 		}
 

package/src/api-builder/classes/description-parser.js

@@ -12,6 +12,25 @@ const macroReplacer = require( '../../tasks/macro-replacer' );
 const findTargetDoclet = require( '../utils/findtargetdoclet' );
 const { hasDedicatedApiPages, LONG_NAME_LABEL_REGEXP, LONG_NAME_MEMBER_SEPARATOR_REGEXP } = require( '../utils/utils' );
 const logCrossProjectReference = require( '../../../scripts/utils/logcrossprojectreference' );
+const createPrerenderPugTemplate = require( '../../../scripts/utils/pug-renderer/create-prerender-pug-template' );
+
+const renderCodeBlockPug = createPrerenderPugTemplate( {
+	requires: [
+		'_components/svg/index',
+		'_components/icon/index',
+		'_components/tooltip-popover/index',
+		'_components/skeleton/index',
+		'_components/code-block/index'
+	],
+	component: 'code-block',
+	componentAttrs: {
+		static: {
+			copyable: true
+		},
+		dynamic: [ 'copyable', 'language' ],
+		mask: [ 'code' ]
+	}
+} );
 
 /**
  * Class responsible for parsing doc descriptions.
@@ -29,6 +48,12 @@ module.exports = class DescriptionParser {
 			return;
 		}
 
+		const theme = {
+			theme: this._macrosVariables.slug === 'ckeditor4' ? 'umberto' : 'gloria'
+		};
+
+		Object.assign( options, theme );
+
 		return composeFunctions(
 			this._cleanTabs,
 			this._changeHeaders,
@@ -353,25 +378,51 @@ module.exports = class DescriptionParser {
 	 * @param str
 	 * @returns {String}
 	 */
-	_cleanTabs( str ) {
+	_cleanTabs( str, options = {} ) {
 		if ( str.indexOf( '<pre' ) === -1 ) {
 			return str;
 		}
 
 		const $ = cheerio.load( str, null, false );
+		const theme = options.theme;
 
-		$( 'pre[class~="source"]' ).each( function() {
-			let code = $( this ).html();
-			const begin = /<code> {4}/.exec( code );
+		if ( theme === 'gloria' ) {
+			const $code = $( 'pre code' );
 
-			if ( begin ) {
-				code = code.replace( /(?:<code>|\n) {4}/g, match => {
-					return match.replace( '    ', '' );
-				} );
+			if ( !$code.length ) {
+				return null;
 			}
 
-			$( this ).html( code );
-		} );
+			// Get the language from the class (e.g., "language-js" -> "js")
+			const language = $code.attr( 'class' ) ?
+				$code.attr( 'class' ).replace( 'doc', '' ).replace( 'language-', '' ).replace( 'ts', 'typescript' ).trim() :
+				null;
+
+			// Get the code content
+			const code = $code.html();
+
+			// Use the render-pug-component utility
+			const html = renderCodeBlockPug( {
+				language,
+				code
+			} );
+
+			$( this ).html( html );
+			$( 'pre' ).replaceWith( html );
+		} else {
+			$( 'pre[class~="source"]' ).each( function() {
+				let code = $( this ).html();
+				const begin = /<code> {4}/.exec( code );
+
+				if ( begin ) {
+					code = code.replace( /(?:<code>|\n) {4}/g, match => {
+						return match.replace( '    ', '' );
+					} );
+				}
+
+				$( this ).html( code );
+			} );
+		}
 
 		return $.html();
 	}

package/src/api-builder/classes/doc-data-factory.js

@@ -188,11 +188,11 @@ module.exports = class DocDataFactory {
 		augmentsNested.reverse();
 		const properties = this._getMembers( doclet.properties, { parentDoclet: doclet } ) || [];
 
-		/* eslint-disable max-len */
+		/* eslint-disable @stylistic/max-len */
 		// For all "typedef" doclets - copy property name as its id. Thanks to that we will be able to make a directly link to specified property. See #796.
 		// "member-" as a static string must be the same as defined in `addTypedefProperties()` helper in the `@ckeditor/jsdoc-plugins` package.
 		// See: https://github.com/ckeditor/ckeditor5-dev/blob/aa905a702d337db001445efc1036ab2b33069d44/packages/jsdoc-plugins/lib/relation-fixer/addtypedefproperties.js#L95
-		/* eslint-enable max-len */
+		/* eslint-enable @stylistic/max-len */
 		if ( doclet.kind == 'typedef' ) {
 			for ( const property of properties ) {
 				if ( !property.id ) {

package/src/helpers/github-url.js

@@ -106,7 +106,7 @@ const utils = {
 			return null;
 		}
 
-		// eslint-disable-next-line max-len
+		// eslint-disable-next-line @stylistic/max-len
 		return `https://github.com/ckeditor/${ projectName }/blob/${ gitHash }${ pathSuffix }#L${ file.lineNr }-L${ file.lineNr + file.len }`;
 	}
 };

package/src/helpers/templates/scripts/default.js

@@ -51,4 +51,4 @@ function defaultScript( hits ) {
 	} );
 
 	return result;
-}
+}

package/src/helpers/templates/scripts/group.js

@@ -66,4 +66,4 @@ function groupScript( hits ) {
 	} );
 
 	return result;
-}
+}

package/src/hexo/filter/project-locals.js

@@ -35,6 +35,7 @@ module.exports = ( ctx, {
 	googleoptimize,
 	googletagmanager,
 	googleanalytics,
+	promobar,
 	vwo,
 	feedbackWidget,
 	extraStylePaths,
@@ -95,17 +96,25 @@ module.exports = ( ctx, {
 			locals.docSearchConfig = getDocSearchConfig( docSearch );
 		}
 
+		locals.sitemap = config.sitemap;
 		locals.umbertoVersion = umbertoVersion;
 		locals.disableSearch = disableSearch;
 		locals.googleoptimize = googleoptimize;
 		locals.googletagmanager = googletagmanager;
 		locals.googleanalytics = googleanalytics;
+		locals.promobar = promobar;
 		locals.vwo = vwo;
 		locals.feedbackWidget = feedbackWidget;
 		locals.mainName = ctx.projectGlobals.common.mainName ? ctx.projectGlobals.common.mainName : '';
 		locals.mainLogo = ctx.projectGlobals.common.mainLogo ? ctx.projectGlobals.common.mainLogo : '';
 		locals.pathJoin = upath.join;
 
+		// `sitemap` entry is not consistent across building methods of Umberto.
+		// It's often defined in the API, but it's not always available in the hexo locals.
+		// In order to make it available, it's safer to use `docSearch.indexName` which is always defined.
+		locals.isLegacy = locals.path.includes( '/legacy/' );
+		locals.isNightly = docSearch.indexName?.includes( 'nightly' ) || false;
+
 		locals.mainOg = og || {};
 	} );
 };

package/src/hexo/get-repo-urls.js

@@ -55,7 +55,7 @@ function getPackageJson( srcDir ) {
 
 	try {
 		packageJson = require( upath.join( srcDir, 'package.json' ) );
-	} catch ( err ) {
+	} catch {
 		console.warn( `Warning: Cannot read package.json from ${ srcDir }.` );
 	}
 

package/src/hexo/project-globals.js

@@ -54,6 +54,8 @@ module.exports = ( ctx, {
 			for ( const cat of data.categories ) {
 				const newPathToCategory = upath.join( pathToCategory, cat.slug || '' );
 				projectData.categoryIds.set( cat.id, {
+					category: cat,
+					parentCategoryId: data.id,
 					groupId,
 					groupSlug,
 					path: newPathToCategory
@@ -66,6 +68,8 @@ module.exports = ( ctx, {
 	for ( const g of groups ) {
 		const pathToCategory = upath.join( basePath, g.slug );
 		projectData.categoryIds.set( g.id, {
+			category: null,
+			parentCategoryId: null,
 			groupId: g.id,
 			groupSlug: g.slug,
 			path: pathToCategory

package/src/hexo-manager.js

@@ -10,6 +10,7 @@ const upath = require( 'upath' );
 const fs = require( 'fs-extra' );
 const { globSync } = require( 'glob' );
 const Hexo = require( '../hexo-shim' );
+
 const getHexoConfig = require( './tasks/get-hexo-config' );
 const extendConfig = require( './hexo/filter/extend-config' );
 
@@ -43,6 +44,10 @@ class HexoManager {
 			silent: options.silent,
 			debug: false
 		} );
+
+		// Enforce hexo to show errors.
+		this.hexo.log.level = 50;
+
 		extendConfig( this.hexo, this.config );
 		this.isInit = true;
 	}
@@ -96,12 +101,12 @@ class HexoManager {
 	 *
 	 * @returns {Promise<>}
 	 */
-	generate( { watch = false } = {} ) {
+	generate( { watch = false, concurrency } = {} ) {
 		if ( !this.isInit ) {
 			throw new Error( 'Hexo manager is not initialized' );
 		}
 
-		return this.hexo.call( 'generate', { watch } )
+		return this.hexo.call( 'generate', { watch, concurrency } )
 			.then( () => {
 				return this.hexo.exit();
 			} )

package/src/sdk-builder/sdk-builder.js

@@ -168,7 +168,7 @@ module.exports = class SdkBuilder {
 					config: this.projectConfig,
 					projectLocals,
 					content: tools.replaceMacros( sdkItem.content ),
-					getPages: ( function( pages ) { // eslint-disable-line wrap-iife
+					getPages: ( function( pages ) {
 						return function( category ) {
 							return pages
 								.filter( element => element.meta && element.meta.category && element.meta.category === category )
@@ -183,7 +183,7 @@ module.exports = class SdkBuilder {
 									}
 								} );
 						};
-					} )( this.sdkCollection ),
+					}( this.sdkCollection ) ),
 					docSearchConfig: getDocSearchConfig( this._docSearch )
 				}
 			), upath.join( this.destinationPath, slug, sdkItem.name + '.html' ) ) );
@@ -244,7 +244,7 @@ ${ bodyBlocks.join( '\n' ) }
 			{
 				data: this.sdkCollection,
 				config: this.projectConfig,
-				getPages: ( function( pages ) { // eslint-disable-line wrap-iife
+				getPages: ( function( pages ) {
 					return function( category ) {
 						return pages
 							.filter( element => element.meta && element.meta.category && element.meta.category === category )
@@ -259,7 +259,7 @@ ${ bodyBlocks.join( '\n' ) }
 								}
 							} );
 					};
-				} )( this.sdkCollection )
+				}( this.sdkCollection ) )
 			}
 		);
 	}

package/src/tasks/build-api-docs.js

@@ -18,9 +18,9 @@ const TemplateCollection = require( '../template/template-collection' );
  * Creates ApiBuilder instance to process doclets and render HTML.
  *
  * @param config
- * @returns {ApiBuilder}
+ * @returns {Promise<ApiBuilder>}
  */
-module.exports = config => {
+module.exports = async config => {
 	const {
 		src,
 		projectDst, // e.g.: ckeditor5/latest/api
@@ -65,9 +65,9 @@ module.exports = config => {
 	);
 
 	console.log( `Building API docs of ${ projectConfig.name }...` );
-	console.time( 'Built API docs in' );
-	const buildInfo = apiBuilder.buildApi();
-	console.timeEnd( 'Built API docs in' );
+	console.time( `Built API docs of ${ projectConfig.name } in` );
+	const buildInfo = await apiBuilder.buildApi();
+	console.timeEnd( `Built API docs of ${ projectConfig.name } in` );
 
 	if ( process.argv.includes( '--strict' ) && buildInfo.warningCount > 0 ) {
 		console.log( `There were ${ buildInfo.warningCount } warnings reported in strict mode. Aborting.` );

package/src/tasks/build-documentation.js

@@ -28,7 +28,7 @@ const copyProjectIcons = require( './copy-project-icons' );
 const executeHooks = require( './execute-hooks' );
 const umbertoVersion = require( '../../package.json' ).version;
 
-const parseLink = require( '../../scripts/utils/parselinks' );
+const { parseLinks } = require( '../../scripts/utils/parselinks' );
 const getFilePatternsToProcess = require( '../helpers/get-file-patterns-to-process' );
 
 /**
@@ -141,6 +141,8 @@ module.exports = options => {
 				googleoptimize: mainConfig.googleoptimize,
 				googletagmanager: mainConfig.googletagmanager,
 				googleanalytics: mainConfig.googleanalytics,
+				promobar: mainConfig.promobar,
+				sitemap: mainConfig.sitemap,
 				vwo: mainConfig.vwo,
 				feedbackWidget: mainConfig.feedbackWidget,
 				extraStyles,
@@ -153,7 +155,10 @@ module.exports = options => {
 				skipGuides
 			} );
 		} )
-		.then( () => hexoManager.generate( { watch } ) )
+		.then( () => hexoManager.generate( {
+			watch,
+			concurrency: 50
+		} ) )
 		.then( () => buildSnippets( hexoManager.hexo.projectGlobals ) )
 		.then( () => copyProjectIcons( hexoManager.hexo.projectGlobals, hexoManager.getPublicDir() ) )
 		// A workaround for API guides when API generation is skipped.
@@ -252,7 +257,7 @@ async function buildProjects( rootPath, projectPaths, options = {} ) {
 
 	// If the `guides` (non-empty array) or `skipGuides` options are specified, disable the `{@link...}` validator.
 	if ( options.guides.length || options.skipGuides ) {
-		hexoManager.hexo.projectGlobals.common._disabledFilters.add( parseLink.name );
+		hexoManager.hexo.projectGlobals.common._disabledFilters.add( parseLinks.name );
 	}
 
 	if ( !options.skipApi ) {
@@ -265,6 +270,8 @@ async function buildProjects( rootPath, projectPaths, options = {} ) {
 				googleoptimize: options.googleoptimize,
 				googletagmanager: options.googletagmanager,
 				googleanalytics: options.googleanalytics,
+				promobar: options.promobar,
+				sitemap: options.sitemap,
 				vwo: options.vwo,
 				feedbackWidget: options.feedbackWidget,
 				og: options.og,
@@ -284,6 +291,8 @@ async function buildProjects( rootPath, projectPaths, options = {} ) {
 			googleoptimize: options.googleoptimize,
 			googletagmanager: options.googletagmanager,
 			googleanalytics: options.googleanalytics,
+			promobar: options.promobar,
+			sitemap: options.sitemap,
 			vwo: options.vwo,
 			feedbackWidget: options.feedbackWidget,
 			og: options.og,
@@ -337,6 +346,7 @@ async function buildProjects( rootPath, projectPaths, options = {} ) {
 			googleoptimize: options.googleoptimize,
 			googletagmanager: options.googletagmanager,
 			googleanalytics: options.googleanalytics,
+			promobar: options.promobar,
 			vwo: options.vwo,
 			feedbackWidget: options.feedbackWidget,
 			extraStylePaths: extraStyles,
@@ -390,15 +400,16 @@ async function getProjectConfigs( rootPath, projectPaths, options = {} ) {
 }
 
 // Renders API docs HTML. API docs are rendered separate from hexo so hexo filters and helpers are not available.
-function buildApis( projectConfigs, options = {} ) {
+async function buildApis( projectConfigs, options = {} ) {
 	// Basic project info like name and BASE_PATH required by templates.
 	const basicProjectsData = getBasicProjectsData( projectConfigs );
 	const promises = [];
+	const outputDir = upath.relative( process.cwd(), hexoManager.getPublicDir() );
 
-	projectConfigs.forEach( config => {
+	for ( const config of projectConfigs ) {
 		// If umberto.json doesn't have a config for API docs, we can skip here.
 		if ( !config.groups || !config.groups.find( group => group.id === 'api-reference' ) ) {
-			return;
+			continue;
 		}
 
 		const apiConfig = config.groups.find( group => group.id === 'api-reference' );
@@ -418,10 +429,10 @@ function buildApis( projectConfigs, options = {} ) {
 			throw new Error( `Not enough api-reference data in umberto.json, project: ${ config.name }` );
 		}
 
-		const apiDocs = buildApi( {
+		const apiDocsPromise = buildApi( {
 			src: upath.join( config.projectRootPath, config.path, apiConfig.sourceDir ),
 			projectDst: upath.join( BASE_PATH, apiConfig.slug ),
-			outputDir: hexoManager.getPublicDir().replace( process.cwd(), '' ),
+			outputDir,
 			themePath: hexoManager.getThemePath(),
 			BASE_PATH,
 			docSearch: options.docSearch,
@@ -430,6 +441,7 @@ function buildApis( projectConfigs, options = {} ) {
 				projectsData: basicProjectsData,
 				extraStylePaths: options.extraStyles,
 				extraScriptsPaths: options.extraScripts,
+				sitemap: config.sitemap || options.sitemap,
 				umbertoVersion,
 				projectLocals: {
 					extraStylePaths: extraStyles,
@@ -444,25 +456,33 @@ function buildApis( projectConfigs, options = {} ) {
 				googleoptimize: options.googleoptimize,
 				googletagmanager: options.googletagmanager,
 				googleanalytics: options.googleanalytics,
+				promobar: options.promobar,
 				vwo: options.vwo,
 				feedbackWidget: options.feedbackWidget,
 				pathJoin: upath.join,
-				mainOg: options.og || {}
+				mainOg: options.og || {},
+				isLegacy: false,
+				isNightly: options.docSearch?.indexName?.includes( 'nightly' ) || false
 			},
 			projectConfig: config,
 			canonicalUrlBeginning: getCanonicalBeginning( { config, options, hexoManager } )
+		} ).then( apiDocs => {
+			// API docs navigation tree is rendered once and reused as HTML.
+			config.navTree = apiDocs.getNavTree();
+			// API errors documentation is stored here so that it's available in guides (and hexo filters).
+			config.errorsHtml = apiDocs.getErrors();
+			hexoManager.addProjectGlobalData( config.slug, 'doclets', apiDocs.getDataCollection() );
+
+			bindProjectGlobals( hexoManager.hexo, {
+				rootPath: config.projectRootPath,
+				basePath: BASE_PATH,
+				config,
+				errorsHtml: config.errorsHtml
+			} );
 		} );
 
-		promises.push(
-			writeHtmlFiles( apiDocs.getFiles() )
-		);
-
-		// API docs navigation tree is rendered once and reused as HTML.
-		config.navTree = apiDocs.getNavTree();
-		// API errors documentation is stored here so that it's available in guides (and hexo filters).
-		config.errorsHtml = apiDocs.getErrors();
-		hexoManager.addProjectGlobalData( config.slug, 'doclets', apiDocs.getDataCollection() );
-	} );
+		promises.push( apiDocsPromise );
+	}
 
 	return Promise.all( promises );
 }
@@ -470,6 +490,7 @@ function buildApis( projectConfigs, options = {} ) {
 function buildSdks( projectConfigs, options = {} ) {
 	const promises = [];
 	const basicProjectsData = getBasicProjectsData( projectConfigs );
+	const outputDir = upath.relative( process.cwd(), hexoManager.getPublicDir() );
 
 	projectConfigs.forEach( config => {
 		const sdkGroup = config.groups && config.groups.find( group => group.id === 'sdk' );
@@ -491,7 +512,7 @@ function buildSdks( projectConfigs, options = {} ) {
 		);
 
 		const sdk = buildSdk( {
-			outputDir: hexoManager.getPublicDir().replace( process.cwd(), '' ),
+			outputDir,
 			srcPath: sdkGroup.sourceDir,
 			projectRootPath: config.projectRootPath,
 			projectPath: config.path,
@@ -503,6 +524,7 @@ function buildSdks( projectConfigs, options = {} ) {
 				umbertoVersion,
 				extraStylePaths: options.extraStyles,
 				extraScriptsPaths: options.extraScripts,
+				sitemap: config.sitemap || options.sitemap,
 				projectLocals: {
 					disableSearch: config.docsearch === false,
 					extraStylePaths: extraStyles,
@@ -513,6 +535,7 @@ function buildSdks( projectConfigs, options = {} ) {
 				googleoptimize: options.googleoptimize,
 				googletagmanager: options.googletagmanager,
 				googleanalytics: options.googleanalytics,
+				promobar: options.promobar,
 				vwo: options.vwo,
 				feedbackWidget: options.feedbackWidget,
 				pathJoin: upath.join,
@@ -529,13 +552,13 @@ function buildSdks( projectConfigs, options = {} ) {
 		// Copy assets
 		copyFiles(
 			upath.join( config.projectRootPath, config.path, sdkGroup.sourceDir, 'assets' ),
-			upath.join( '.', hexoManager.getPublicDir().replace( process.cwd(), '' ), BASE_PATH, sdkGroup.slug, 'assets' )
+			upath.join( '.', outputDir, BASE_PATH, sdkGroup.slug, 'assets' )
 		);
 
 		// Copy CKEditor from presets
 		copyFiles(
 			upath.join( config.projectRootPath, config.path, sdkGroup.sourceDir, 'vendors' ),
-			upath.join( '.', hexoManager.getPublicDir().replace( process.cwd(), '' ), 'vendors', config.version )
+			upath.join( '.', outputDir, 'vendors', config.version )
 		);
 
 		config.sdkNavTree = sdk.navigationHtml;

package/src/tasks/cache-files.js

@@ -27,7 +27,7 @@ module.exports = ( src, dst ) => {
 		if ( !fs.existsSync( cachePath ) ) {
 			try {
 				fs.copySync( p, cachePath );
-			} catch ( err ) {
+			} catch {
 				console.error( `Error when caching file ${ p } to ${ cachePath }` );
 			}
 
@@ -40,7 +40,7 @@ module.exports = ( src, dst ) => {
 		if ( currentStats.size !== cachedStats.size || currentStats.mtime > cachedStats.mtime ) {
 			try {
 				fs.copySync( p, cachePath );
-			} catch ( err ) {
+			} catch {
 				console.error( `Error when caching file ${ p } to ${ cachePath }` );
 			}