umberto 10.3.0 → 10.4.1

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 Changelog
 =========
 
+## [10.4.1](https://github.com/cksource/umberto/compare/v10.4.0...v10.4.1) (April 13, 2026)
+
+### Bug fixes
+
+* Fixed URL in the dropdown for LTS item to have absolute URL to pass documentation validation.
+
+
+## [10.4.0](https://github.com/cksource/umberto/compare/v10.3.0...v10.4.0) (April 9, 2026)
+
+### Features
+
+* Added the LTS edition to the docs product picker.
+
+
 ## [10.3.0](https://github.com/cksource/umberto/compare/v10.2.0...v10.3.0) (April 3, 2026)
 
 ### Features
@@ -33,20 +47,6 @@ Changelog
 
 * Filter search results from Algolia to match the current docs version: `latest` or `lts-v47`. Filtering remains backward-compatible: hits without the docs version are still allowed.
 
-
-## [10.1.3](https://github.com/cksource/umberto/compare/v10.1.2...v10.1.3) (March 10, 2026)
-
-### Bug fixes
-
-* Fix regression introduced in `v10.1.2` affecting slugs generated for headings. Slugs generated now should be the same as in `v10.1.1` and previous versions of Umberto.
-
-
-## [10.1.2](https://github.com/cksource/umberto/compare/v10.1.1...v10.1.2) (March 9, 2026)
-
-### Bug fixes
-
-* Removed unmaintained `hexo-renderer-markdown-it-plus` and `@ckeditor/jsdoc-plugins` dependencies by replacing them with maintained and local implementations, resolving the reported `markdown-it`-related vulnerabilities in Umberto's dependency tree.
-
 ---
 
 To see all releases, visit the [release page](https://github.com/cksource/umberto/releases).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "10.3.0",
+  "version": "10.4.1",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "type": "module",

package/src/tasks/build-documentation.js

@@ -161,6 +161,11 @@ export const buildDocumentation = options => {
 				macrosVariables: mainConfig.variables,
 				quickNavigationProjects: mainConfig.quickNavigationProjects || [
 					{ name: 'CKEditor 5', slug: 'ckeditor5' },
+					{
+						name: 'CKEditor 5 LTS Edition',
+						href: 'https://ckeditor.com/docs/ckeditor5/lts-v47/index.html',
+						rel: 'nofollow'
+					},
 					{ name: 'Cloud Services', slug: 'cs' },
 					{ name: 'CKBox', slug: 'ckbox' }
 				],

package/themes/umberto/layout/gloria/_components/dropdown/index.pug

@@ -50,20 +50,22 @@ mixin dropdown({ id: dropdownId, className, preferredDirection, contentId, updat
 //- +dropdown-item({ label: 'Active item', active: true })
 //- +dropdown-item({ label: 'Item with value', value: 'custom-value' })
 //- +dropdown-item({ label: 'Item with icon', icon: 'github' })
-//- +dropdown-item({ label: 'Custom link', href: '/custom-link' })
+//- +dropdown-item({ label: 'Custom link', href: '/custom-link', rel: 'nofollow' })
 //- +dropdown-item({ label: 'With ID', itemId: 'special-item' })
-mixin dropdown-item({ itemId, href, active = false, narrow, label, icon, value } = {})
+mixin dropdown-item({ itemId, href, rel, active = false, narrow, label, icon, value, projectKey } = {})
 	- const tag = href ? 'a' : 'div';
 
 	li.c-dropdown__list-item
 		#{tag}.b-reset-link.c-dropdown__item(
 			role='menuitem',
 			href=href,
+			rel=rel,
 			class={
 				'is-active': active,
 				'c-dropdown__item--narrow': !!narrow
 			},
 			data-item-id=itemId,
+			data-project-key=projectKey,
 			data-value=value,
 			tabindex='-1'
 		)

package/themes/umberto/layout/gloria/_modules/header/nav-project-select-dropdown.pug

@@ -1,7 +1,21 @@
 mixin nav-project-select-dropdown()
 	-
+		const getProjectKey = pathname => {
+			const segments = pathname.split( '/' ).filter( Boolean );
+
+			if ( segments[ 0 ] === 'docs' ) {
+				segments.shift();
+			}
+
+			const [ slug, rawChannel ] = segments;
+			const channel = /^\d+\.\d+\.\d+$/.test( rawChannel || '' ) ? 'latest' : ( rawChannel || 'latest' );
+
+			return slug ? `/${ slug }/${ channel }` : '';
+		};
+		const getProjectHref = project => project.href || relative_url( page.path, `${ project.slug }/${ project.channel || 'latest' }/index.html` );
+		const getItemProjectKey = project => getProjectKey( project.href ? new URL( project.href ).pathname : `/${ project.slug }/${ project.channel || 'latest' }/index.html` );
 		const currentProject = projectLocals && quickNavigationProjects && quickNavigationProjects.find(
-			project => project.slug === projectLocals.projectSlug
+			project => project.slug === projectLocals.projectSlug && !project.channel
 		);
 
 	+menu-dropdown({
@@ -10,7 +24,56 @@ mixin nav-project-select-dropdown()
 		each project in quickNavigationProjects
 			+dropdown-item({
 				label: project.name,
-				active: !!currentProject && project.slug === currentProject.slug,
-				href: relative_url(page.path, `${ project.slug }/latest/index.html`)
+				active: !!currentProject &&
+					project.slug === currentProject.slug &&
+					( project.channel || 'latest' ) === 'latest',
+				href: getProjectHref( project ),
+				rel: project.rel,
+				projectKey: getItemProjectKey( project )
 			})
 
+	if currentProject
+		script.
+			(function() {
+				const script = document.currentScript;
+				const getProjectKey = pathname => {
+					const segments = pathname.split( '/' ).filter( Boolean );
+
+					if ( segments[ 0 ] === 'docs' ) {
+						segments.shift();
+					}
+
+					const [ slug, rawChannel ] = segments;
+					const channel = /^\d+\.\d+\.\d+$/.test( rawChannel || '' ) ? 'latest' : ( rawChannel || 'latest' );
+
+					return slug ? `/${ slug }/${ channel }` : '';
+				};
+
+				document.addEventListener( 'DOMContentLoaded', () => {
+					const dropdown = script?.previousElementSibling;
+					const currentProjectKey = getProjectKey( window.location.pathname );
+
+					if ( !dropdown || !currentProjectKey ) {
+						return;
+					}
+
+					const items = Array.from( dropdown.querySelectorAll( '.c-dropdown__item[data-project-key]' ) );
+					const activeItem = items.find( item => item.dataset.projectKey === currentProjectKey );
+
+					if ( !activeItem ) {
+						return;
+					}
+
+					for ( const item of items ) {
+						item.classList.toggle( 'is-active', item === activeItem );
+					}
+
+					const labelElement = dropdown.querySelector( '.c-menu-dropdown__button .c-button__label' );
+					const labelText = activeItem.querySelector( 'span' )?.textContent?.trim() || activeItem.textContent.trim();
+
+					if ( labelElement && labelText ) {
+						labelElement.textContent = labelText;
+					}
+				}, { once: true } );
+			})();
+

package/themes/umberto/layout/gloria/_modules/mobile-nav/index.pug

@@ -3,6 +3,20 @@ include ./slide-parts
 mixin mobile-nav()
 	-
 		const currentProject = projectLocals && projectsData.find( project => project.slug === projectLocals.projectSlug );
+		const getProjectKey = pathname => {
+			const segments = pathname.split( '/' ).filter( Boolean );
+
+			if ( segments[ 0 ] === 'docs' ) {
+				segments.shift();
+			}
+
+			const [ slug, rawChannel ] = segments;
+			const channel = /^\d+\.\d+\.\d+$/.test( rawChannel || '' ) ? 'latest' : ( rawChannel || 'latest' );
+
+			return slug ? `/${ slug }/${ channel }` : '';
+		};
+		const getProjectHref = project => project.href || relative_url( page.path, `${ project.slug }/${ project.channel || 'latest' }/index.html` );
+		const getItemProjectKey = project => getProjectKey( project.href ? new URL( project.href ).pathname : `/${ project.slug }/${ project.channel || 'latest' }/index.html` );
 		let initialSlideId = projectLocals ? `project-${projectLocals.projectSlug}` : 'products';
 
 		// If the page has a category, set the initial slide to that category's slide
@@ -23,20 +37,60 @@ mixin mobile-nav()
 			if quickNavigationProjects
 				ol.b-reset-list.c-mobile-nav__items
 					each project in quickNavigationProjects
-						- isCurrentProject = projectLocals && project.slug === projectLocals.projectSlug
-
+						- isCurrentProject = projectLocals && project.slug === projectLocals.projectSlug && !project.channel
 						if isCurrentProject
 							+mobile-nav-item({
 								label: project.name,
 								active: true,
-								targetSlideId: `project-${ project.slug }`
+								targetSlideId: `project-${ project.slug }`,
+								projectKey: getItemProjectKey( project )
 							})
 						else
 							+mobile-nav-item({
-								href: relative_url(page.path, `${project.slug}/latest/index.html`),
-								label: project.name
+								href: getProjectHref( project ),
+								label: project.name,
+								rel: project.rel,
+								projectKey: getItemProjectKey( project )
 							})
 
+		if currentProject
+			script.
+				(function() {
+					const script = document.currentScript;
+					const getProjectKey = pathname => {
+						const segments = pathname.split( '/' ).filter( Boolean );
+
+						if ( segments[ 0 ] === 'docs' ) {
+							segments.shift();
+						}
+
+						const [ slug, rawChannel ] = segments;
+						const channel = /^\d+\.\d+\.\d+$/.test( rawChannel || '' ) ? 'latest' : ( rawChannel || 'latest' );
+
+						return slug ? `/${ slug }/${ channel }` : '';
+					};
+
+					document.addEventListener( 'DOMContentLoaded', () => {
+						const mobileNav = script?.previousElementSibling;
+						const currentProjectKey = getProjectKey( window.location.pathname );
+
+						if ( !mobileNav || !currentProjectKey ) {
+							return;
+						}
+
+						const items = Array.from( mobileNav.querySelectorAll( '.c-mobile-nav__item[data-project-key]' ) );
+						const activeItem = items.find( item => item.dataset.projectKey === currentProjectKey );
+
+						if ( !activeItem ) {
+							return;
+						}
+
+						for ( const item of items ) {
+							item.classList.toggle( 'is-active', item === activeItem );
+						}
+					}, { once: true } );
+				})();
+
 		//- Current project slide
 		if projectLocals
 			+mobile-nav-slide({ slideId: `project-${ projectLocals.projectSlug }` })

package/themes/umberto/layout/gloria/_modules/mobile-nav/slide-parts.pug

@@ -32,7 +32,7 @@ mixin mobile-nav-heading({ href, label })
 		iconPosition: 'right',
 	})
 
-mixin mobile-nav-item({ href, label, targetSlideId, target, active = false })
+mixin mobile-nav-item({ href, label, rel, targetSlideId, target, active = false, projectKey })
 	li
 		if targetSlideId
 			+button({
@@ -48,11 +48,14 @@ mixin mobile-nav-item({ href, label, targetSlideId, target, active = false })
 				'data-navigate-direction'='forward',
 				'aria-controls'=`slide-${targetSlideId}`,
 				'aria-expanded'='false',
-				'aria-haspopup'='true'
+				'aria-haspopup'='true',
+				'data-project-key'=projectKey
 			)
 		else
 			a.b-link.c-mobile-nav__item(
 				href=href,
+				rel=rel,
+				data-project-key=projectKey,
 				class=active ? 'is-active' : '',
 				target=target
 			)= label