npm - umberto - Versions diffs - 2.2.0 → 2.3.0 - Mend

umberto 2.2.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (198) hide show

package/.eslintrc.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
@@ -10,7 +10,7 @@ module.exports = {
 	rules: {
 		'ckeditor5-rules/license-header': [ 'error', { headerLines: [
 			'/**',
-			' * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.',
+			' * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.',
 			' * For licensing, see LICENSE.md.',
 			' */'
 		] } ]

package/LICENSE.md CHANGED Viewed

@@ -1,7 +1,7 @@
 Software License Agreement
 ==========================
-Copyright (c) 2017-2022, [CKSource](http://cksource.com) Holding sp. z o.o. All rights reserved.
+Copyright (c) 2017-2023, [CKSource](http://cksource.com) Holding sp. z o.o. All rights reserved.
 Licensed under the terms of [MIT License](https://opensource.org/licenses/MIT).

package/hexo-shim.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "files": [
@@ -38,6 +38,7 @@
     "jquery": "~3.6.0",
     "js-beautify": "^1.14.4",
     "lodash": "^4.17.21",
+    "markdown-it": "^13.0.1",
     "markdown-it-expand-tabs": "^1.0.13",
     "markdown-it-toc-and-anchor": "^4.2.0",
     "medium-zoom": "^1.0.6",

package/scripts/filter/after-post-render/basepath-replacer.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/fix-code-samples.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/gather-guides.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/img-linker.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/import-guide.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/insert-error-codes.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/linker.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/parseicontag.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/process-variables.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/snippets.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/time-end.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/time-start.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/after-post-render/validate-after-render.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/add-project-info-to-page.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/add-repo-url.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/change-output-path.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/escape-special-characters.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/execute-and-insert-function-results.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/infobox.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/insertchangelog.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/replace-macros.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/set-layout.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/filter/before-post-render/validate-page-data.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/helper/find-main-category-page.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/helper/get-pages-for-nav-tree.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/helper/mark-empty-categories.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/helper/normalize-badges.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/helper/u-split-to-title-and-content.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/helper/u-toc.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/utils/execute-and-insert-function-results.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/utils/findmaincategorypage.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/utils/getreportissuewidgeturl.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/utils/insertchangelog.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/utils/normalizebadges.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/utils/parseicontag.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/utils/parselinks.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
@@ -11,6 +11,9 @@ const chalk = require( 'chalk' );
 const LINK_REGEXP = /\\?{(?:@linkapi|@link|@linksdk|@linkexample)\s+[^{]+?({[^}]+})?[^{}]*\\?}/g;
+const findTargetDoclet = require( '../../src/api-builder/utils/findtargetdoclet' );
+const { hasDedicatedApiPages, LONG_NAME_LABEL_REGEXP } = require( '../../src/api-builder/utils/utils' );
 /**
  * Converts @link or @linkapi tags into working links to guides or API docs.
  *
@@ -68,8 +71,9 @@ function linkToApi( str, data, hexo, { relativeUrlHelper, isSilentError } ) {
 	}
 	const projectName = linkContentMatchResult[ 1 ] || data.projectName;
-	const itemName = linkContentMatchResult[ 2 ];
-	let linkText = linkContentMatchResult[ 3 ] || splitLongname( itemName ).name;
+	const { name, label } = splitLongname( linkContentMatchResult[ 2 ] );
+	const itemName = linkContentMatchResult[ 2 ].replace( LONG_NAME_LABEL_REGEXP, '' );
+	let linkText = linkContentMatchResult[ 3 ] || name;
 	// Support link texts with backticks, wrapping them in <code>.
 	// TODO - a naive implementation.
@@ -86,10 +90,25 @@ function linkToApi( str, data, hexo, { relativeUrlHelper, isSilentError } ) {
 	}
 	const baseItemName = getBaseItemName( itemName );
-	const hashWithoutPrefix = itemName.replace( baseItemName, '' ).slice( 1 );
+	let hashWithoutPrefix = itemName.replace( baseItemName, '' ).slice( 1 );
 	const hash = hashWithoutPrefix ? `#${ hashWithoutPrefix }` : '';
 	const project = hexo.projectGlobals[ projectName ];
+	if ( hashWithoutPrefix.includes( '-' ) ) {
+		let [ type, description ] = hashWithoutPrefix.split( '-' );
+		// JSDuck replaces `$` with `s-`.
+		if ( type === 's' ) {
+			description = `s-${ description }`;
+		}
+		if ( type === 'event' ) {
+			hashWithoutPrefix = type;
+		} else {
+			hashWithoutPrefix = description;
+		}
+	}
 	let apiSlug;
 	if ( project && project.config ) {
@@ -105,49 +124,42 @@ function linkToApi( str, data, hexo, { relativeUrlHelper, isSilentError } ) {
 		} );
 	}
-	const basePath = projectName === data.projectName ?
-		data.BASE_PATH :
-		`${ projectName }/latest`;
+	const basePath = projectName === data.projectName ? data.BASE_PATH : `${ projectName }/latest`;
 	const fileName = getFileName( baseItemName );
 	let href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, fileName + hash ) );
-	if ( project && project.doclets ) {
-		const doclet = project.doclets.get( `ln:${ itemName }` ).getFirst();
-		const docletByExtraId = project.doclets.get( `id:${ itemName }` ).getFirst() ||
-			project.doclets.get( `id:${ baseItemName }#constant-${ hashWithoutPrefix }` ).getFirst();
-		// TODO The following code is buggy. E.g. for static method and instance method sharing the same name.
-		// Actually the `docletByBaseAndHash` should be just `doclet` - IDK why it was designed this way.
-		// This should be fixed in the future with tests on CKE5 and CKE4 codebases.
-		const docletByBaseAndHash = project.doclets.get( `ln:${ baseItemName }#${ hashWithoutPrefix }` ).getFirst() ||
-			project.doclets.get( `ln:${ baseItemName }.${ hashWithoutPrefix }` ).getFirst() ||
-			project.doclets.get( `ln:${ baseItemName }~${ hashWithoutPrefix }` ).getFirst() ||
-			project.doclets.get( `ln:${ baseItemName }#event:${ hashWithoutPrefix }` ).getFirst();
-		if ( doclet && [ 'module', 'class', 'typedef', 'mixin', 'interface', 'namespace' ].includes( doclet.kind ) ) {
-			// If there is a doclet, having own HTML page (e.g. a class doclet),
-			// exactly matching the longname from @link tag, link directly without hash.
-			href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, getFileName( itemName ) ) );
-		} else if ( docletByExtraId ) {
-			// When link tag follows notation: ...SomeClass#method-methodName.
-			href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, fileName + `#${ docletByExtraId.extraId }` ) );
-		} else if ( docletByBaseAndHash ) {
-			// When link tag follows notation: ...SomeClass#methodName, then must use 'extraId' as the hash.
-			href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, fileName + `#${ docletByBaseAndHash.extraId }` ) );
-		} else {
-			return onError( {
-				value: str,
-				source: data.source,
-				isSilent: isSilentError,
-				description: 'No doclet found. Link remain not transformed.'
-			} );
-		}
+	if ( !project || !project.doclets ) {
+		return getOutputLink( href, linkText, !!linkContentMatchResult[ 3 ] );
 	}
-	return linkContentMatchResult[ 3 ] ? `<a href=${ href }>${ linkText }</a>` : `<a href=${ href }><code>${ linkText }</code></a>`;
+	const targetDoclet = findTargetDoclet( project.doclets, {
+		module: itemName,
+		structure: baseItemName,
+		member: hashWithoutPrefix,
+		label
+	} );
+	if ( !targetDoclet ) {
+		return onError( {
+			value: str, source: data.source, isSilent: isSilentError, description: 'No doclet found. Link remain not transformed.'
+		} );
+	}
+	if ( hasDedicatedApiPages( targetDoclet ) ) {
+		href = relativeUrlHelper( data.path, upath.join( basePath, apiSlug, getFileName( itemName ) ) );
+	} else {
+		href = [
+			relativeUrlHelper( data.path, upath.join( basePath, apiSlug, fileName ) ),
+			encodeURI( targetDoclet.extraId )
+		].join( '#' );
+	}
+	if ( !linkContentMatchResult[ 3 ] && targetDoclet.kind === 'event' ) {
+		linkText = `event-${ targetDoclet.name }`;
+	}
+	return getOutputLink( href, linkText, !!linkContentMatchResult[ 3 ] );
 }
 /**
@@ -180,6 +192,14 @@ function getFileName( itemName ) {
 	return itemName.replace( /[/:.]/g, '_' ).replace( '~', '-' ) + '.html';
 }
+function getOutputLink( href, description, isCustomDescription ) {
+	if ( isCustomDescription ) {
+		return `<a href=${ href }>${ description }</a>`;
+	}
+	return `<a href=${ href }><code>${ description }</code></a>`;
+}
 /**
  * @param {String} str
  * @param {Object} data

package/scripts/utils/shoulddisplaynewindicator.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts/utils/transforminfobox.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

package/scripts-dev/postinstall.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */

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

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2017-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2017-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
  */
@@ -20,6 +20,8 @@ const splitLongname = require( '../helpers/split-longname' );
 const githubUrlUtils = require( '../helpers/github-url' );
 const getReportIssueWidgetUrl = require( '../../scripts/utils/getreportissuewidgeturl' );
+const findTargetDoclet = require( './utils/findtargetdoclet' );
 /**
  * Renders HTML for every module, class, mixin etc.
  *
@@ -523,15 +525,33 @@ module.exports = class ApiBuilder {
 		}
 	}
-	_getUrlAddressFromLongname( longname ) {
-		const doclet = this._dataCollection.get( `ln:${ longname }` ).getFirst();
+	/**
+	 * @protected
+	 * @param {LongNameParts} parts
+	 * @returns {String|null}
+	 */
+	_getUrlAddressFromLongname( parts ) {
+		if ( !parts.longnameBase ) {
+			return null;
+		}
-		if ( !doclet ) {
+		// Get a doclet to which we link.
+		const targetDoclet = findTargetDoclet( this._dataCollection, {
+			structure: parts.longnameBase,
+			member: parts.name,
+			label: parts.label,
+			query: {
+				memberOnly: true
+			}
+		} );
+		if ( !targetDoclet ) {
 			return null;
-		} else if ( [ 'cfg', 'member', 'function', 'event' ].includes( doclet.kind ) ) {
-			return `${ doclet.memberof }#${ doclet.extraId }`;
-		} else {
-			return doclet.longname;
 		}
+		return [
+			targetDoclet.memberof,
+			encodeURI( targetDoclet.extraId )
+		].join( parts.isStatic ? '.' : '#' );
 	}
 };