umberto 10.7.5 → 10.8.0

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 Changelog
 =========
 
+## [10.8.0](https://github.com/cksource/umberto/compare/v10.7.5...v10.8.0) (September 7, 2026)
+
+### Features
+
+* Added support for the `llmsTxtProjects` configuration option, which lists the projects that publish an `llms.txt` index. Documentation pages in the Gloria theme now emit `<link rel="alternate" type="text/markdown">` for their own `.md` counterpart, and pages of a listed project also emit `<link rel="describedby">` for that project's index. The documentation landing page points at the `llms.txt` file of the website instead.
+
+
 ## [10.7.5](https://github.com/cksource/umberto/compare/v10.7.4...v10.7.5) (August 13, 2026)
 
 ### Bug fixes
@@ -32,17 +39,6 @@ Changelog
 
 * Replaced webpack with Rolldown for building theme scripts. The theme bundles are now built as ES modules with code splitting and loaded via `<script type="module">`, keeping dynamically imported dependencies (such as the shiki grammars in the Gloria theme) in separate, lazily loaded chunks. The output targets ES2022 instead of the Babel-transpiled ES5, and `webpack`, `babel-loader`, `@babel/core`, and `@babel/preset-env` are no longer dependencies of the package.
 
-
-## [10.7.1](https://github.com/cksource/umberto/compare/v10.7.0...v10.7.1) (July 15, 2026)
-
-### Bug fixes
-
-* Fixed source links for CKEditor 5 packages in API documentation so they now point to the public repository. Links for the latest documentation point to the `master` branch, and links for LTS documentation point to the matching `release-v*` branch.
-
-### Other changes
-
-* Improved the performance of the documentation build. Pug templates of XML components used in Markdown are now compiled once and reused across pages, instead of being recompiled for every component occurrence. This shortens the page generation phase by about 20%.
-
 ---
 
 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.7.5",
+  "version": "10.8.0",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "type": "module",

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

@@ -107,6 +107,7 @@ export const projectLocals = ( ctx, {
 	disableSearch,
 	shouldInjectNoIndexMeta,
 	og,
+	llmsTxtProjects,
 	quickNavigationProjects,
 	navigationShowEmptyCategories
 } = {} ) => {
@@ -197,5 +198,6 @@ export const projectLocals = ( ctx, {
 		locals.isLts = /\/ckeditor5\/(lts-v\d+)(?:\/|$)/.test( `/${ locals.path }` );
 
 		locals.mainOg = og || {};
+		locals.llmsTxtProjects = llmsTxtProjects || [];
 	} );
 };

package/src/tasks/build-documentation.js

@@ -156,6 +156,7 @@ export const buildDocumentation = options => {
 				extraStyles,
 				extraScripts,
 				og: mainConfig.og,
+				llmsTxtProjects: mainConfig.llmsTxtProjects || [],
 				additionalDocumentation: mainConfig.additionalDocumentation,
 				canonicalUrlBeginning: mainConfig.canonicalUrlBeginning,
 				macrosVariables: mainConfig.variables,
@@ -321,6 +322,7 @@ async function buildProjects( rootPath, projectPaths, options = {} ) {
 				vwo: options.vwo,
 				feedbackWidget: options.feedbackWidget,
 				og: options.og,
+				llmsTxtProjects: options.llmsTxtProjects,
 				canonicalUrlBeginning: options.canonicalUrlBeginning,
 				macrosVariables: options.macrosVariables,
 				quickNavigationProjects: options.quickNavigationProjects
@@ -343,6 +345,7 @@ async function buildProjects( rootPath, projectPaths, options = {} ) {
 			vwo: options.vwo,
 			feedbackWidget: options.feedbackWidget,
 			og: options.og,
+			llmsTxtProjects: options.llmsTxtProjects,
 			canonicalUrlBeginning: options.canonicalUrlBeginning,
 			macrosVariables: options.macrosVariables,
 			quickNavigationProjects: options.quickNavigationProjects
@@ -405,6 +408,7 @@ async function buildProjects( rootPath, projectPaths, options = {} ) {
 			extraScriptsPaths: extraScripts,
 			disableSearch: options.disableSearch,
 			og: options.og,
+			llmsTxtProjects: options.llmsTxtProjects,
 			// Force displaying empty categories in the navigation tree when the documentation is being built partially.
 			navigationShowEmptyCategories: Array.isArray( guidesToProcess )
 		} );
@@ -515,6 +519,7 @@ async function buildApis( projectConfigs, options = {} ) {
 				feedbackWidget: options.feedbackWidget,
 				pathJoin: upath.join,
 				mainOg: options.og || {},
+				llmsTxtProjects: options.llmsTxtProjects || [],
 				isNightly: options.docSearch?.indexName?.includes( 'nightly' ) || false,
 				isLts: /\/ckeditor5\/(lts-v\d+)(?:\/|$)/.test( `/${ BASE_PATH }` )
 			},
@@ -596,7 +601,9 @@ function buildSdks( projectConfigs, options = {} ) {
 				vwo: options.vwo,
 				feedbackWidget: options.feedbackWidget,
 				pathJoin: upath.join,
-				mainOg: options.og || {}
+				mainOg: options.og || {},
+				llmsTxtProjects: options.llmsTxtProjects || [],
+				isLts: /\/ckeditor5\/(lts-v\d+)(?:\/|$)/.test( `/${ BASE_PATH }` )
 			},
 			projectConfig: config,
 			canonicalUrlBeginning: getCanonicalBeginning( { config, options, hexoManager } )

package/themes/umberto/layout/gloria/_head/head.pug

@@ -49,6 +49,26 @@ if ( page[ 'dc-description' ] || ogConfig.description )
 if page.BASE_PATH && page.BASE_PATH !== '.' && !page.BASE_PATH.includes( 'latest' )
 	link( rel = 'canonical' href = page.canonicalUrlBeginning + page.path.replace( page.BASE_PATH, projectLocals.latestBasePath ) )
 
+//- The `docs` build writes a Markdown counterpart for `*/latest/**` pages only. That rules out the LTS output,
+//- and it is why these relations cannot sit inside the `canonical` guard above, which skips `latest` projects.
+- const projects = llmsTxtProjects || [];
+- const buildGeneratesMarkdown = projects.length > 0 && !isLts;
+- const markdownProjectKey = page.BASE_PATH && page.BASE_PATH !== '.' ? page.BASE_PATH.split( '/' )[ 0 ] : null;
+- const hasMarkdownVersion = markdownProjectKey && buildGeneratesMarkdown && !page.path.includes( '/getting-started/legacy/' );
+
+if hasMarkdownVersion
+	link( rel = 'alternate' type = 'text/markdown' href = relative_url( page.path, page.path.replace( /\.html$/, '.md' ) ) )
+
+	if projects.includes( markdownProjectKey )
+		if page.groupId === 'api-reference'
+			link( rel = 'describedby' href = 'llms.txt' )
+		else
+			link( rel = 'describedby' href = relative_url( page.path, markdownProjectKey + '/llms.txt' ) )
+
+//- The way in for an agent that arrives from the website rather than from an article.
+else if !markdownProjectKey && mainOg && mainOg.hostname
+	link( rel = 'describedby' href = mainOg.hostname + '/llms.txt' )
+
 if page.isSnippetPage
 	//UMBERTO: SNIPPET: HEAD