umberto 8.3.2 → 8.3.4

package/CHANGELOG.md

@@ -1,6 +1,22 @@
 Changelog
 =========
 
+## [8.3.4](https://github.com/cksource/umberto/compare/v8.3.3...v8.3.4) (October 20, 2025)
+
+### Other changes
+
+* Bump dependencies (including `hexo` to version `8.0.0`).
+
+
+## [8.3.3](https://github.com/cksource/umberto/compare/v8.3.2...v8.3.3) (October 15, 2025)
+
+### Bug fixes
+
+* Link validator should not fail on links containing the word "latest", if they are not part of a version number.
+* Fixed links being unstyled in Kapa.ai answers.
+* Fix broken page sidebar layout on `959px` resolution.
+
+
 ## [8.3.2](https://github.com/cksource/umberto/compare/v8.3.1...v8.3.2) (September 16, 2025)
 
 ### Other changes
@@ -26,26 +42,6 @@ Changelog
 * Added custom styling for the [Kapa.ai](https://www.kapa.ai/) service.
 * The source script of the [Kapa.ai](https://www.kapa.ai/) service must be defined in the `kapa.widgetOptions.src` key in the Umberto configuration.
 
-
-## [8.2.0](https://github.com/cksource/umberto/compare/v8.1.0...v8.2.0) (August 29, 2025)
-
-### Features
-
-* Added integration with the [Kapa.ai](https://www.kapa.ai/) service.
-
-  Umberto configuration can now specify the `kapa` key that allows loading the Kapa button and widget.
-
-
-## [8.1.0](https://github.com/cksource/umberto/compare/v8.0.3...v8.1.0) (August 12, 2025)
-
-### Features
-
-* Added support for relative paths in `packagesDir` option.
-
-### Bug fixes
-
-* Updated how `<iframe>` elements are created to fix issues with automated tests using Chrome v139.
-
 ---
 
 To see all releases, visit the [release page](https://github.com/cksource/umberto/releases).

package/LICENSE.md

@@ -23,7 +23,7 @@ The following libraries are included in Umberto under the [MIT license](https://
 * hexo-generator-category - Copyright (c) 2014 Tommy Chen
 * hexo-generator-index - Copyright (c) 2014 Tommy Chen
 * hexo-generator-tag - Copyright (c) 2014 Tommy Chen
-* hexo-render-pug - Copyright (c) Max Knee
+* hexo-renderer-pug - Copyright (c) 2012 Tommy Chen
 * hexo-renderer-markdown-it-plus - Copyright (c) 2017 CHENXCHEN
 * htmlparser2 - Copyright 2010, 2011, Chris Winberry <chris@winberry.net>
 * javascript-stringify - Copyright (c) 2013 Blake Embrey (hello@blakeembrey.com)

package/README.md

@@ -1,9 +1,14 @@
 # Umberto
 
 ## Installation
-`npm install umberto`
+
+> [!NOTE]
+> This project requires **pnpm v10** or higher. You can check your version with `pnpm --version` and update if needed with `npm install -g pnpm@latest`.
+
+`pnpm install -D umberto`
 
 ## Building documentation of a single project
+
 Note: The only documentation type supported at the moment is JSDoc.
 
 **Step 1:** Create the `umberto.json` configuration file in the project's root directory or in the `docs` directory. This file will tell Umberto how to build documentation for this project.
@@ -230,10 +235,10 @@ For the example above, project-logo.svg should be located in common files direct
 
 ```
 cd umberto
-npm link            # Creates a global link.
+pnpm link --global          # Creates a global link.
 
 cd ../bigbang-docs.ckeditor.com
-npm link umberto    # link-install the package
+pnpm link umberto           # link-install the package
 ```
 
 ## Shortcuts
@@ -870,7 +875,7 @@ Before you start, you need to prepare the changelog entries.
 
 1. Make sure the `#master` branch is up-to-date: `git fetch && git checkout master && git pull`.
 1. Prepare a release branch: `git checkout -b release-[YYYYMMDD]` where `YYYYMMDD` is the current day.
-1. Generate the changelog entries: `yarn run release:prepare-changelog`.
+1. Generate the changelog entries: `pnpm run release:prepare-changelog`.
    * You can specify the release date by passing the `--date` option, e.g., `--date=2025-06-11`.
    * By passing the `--dry-run` option, you can check what the script will do without actually modifying the files.
    * Read all the entries, correct poor wording and other issues, wrap code names in backticks to format them, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umberto",
-  "version": "8.3.2",
+  "version": "8.3.4",
   "description": "CKSource Documentation builder",
   "main": "src/index.js",
   "files": [
@@ -23,12 +23,12 @@
     "fs-extra": "^11.0.0",
     "fuse.js": "^7.1.0",
     "glob": "^11.0.2",
-    "hexo": "^7.3.0",
+    "hexo": "^8.0.0",
     "hexo-generator-archive": "^2.0.0",
     "hexo-generator-category": "^2.0.0",
     "hexo-generator-index": "^4.0.0",
     "hexo-generator-tag": "^2.0.0",
-    "hexo-render-pug": "^2.1.4",
+    "hexo-renderer-pug": "^3.0.0",
     "hexo-renderer-markdown-it-plus": "^1.0.5",
     "htmlparser2": "^10.0.0",
     "javascript-stringify": "^2.1.0",
@@ -53,7 +53,9 @@
     "webpack": "^5.94.0"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.0.0",
+    "pnpm": ">=10.14.0",
+    "yarn": "\n\n┌─────────────────────────┐\n│  Hey, we use pnpm now!  │\n└─────────────────────────┘\n\n"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "MIT",

package/src/tasks/validate-links.js

@@ -102,12 +102,12 @@ function validateChunk( { chunk, links, options } ) {
 				continue;
 			}
 
-			if ( resolvedPath.includes( 'latest' ) ) {
+			if ( resolvedPath.includes( '/latest/' ) ) {
 				const projectInfo = options.projectsInfo ?
 					options.projectsInfo.find( i => resolvedPath.includes( `/${ i.slug }/` ) ) :
 					null;
 				const projectVersion = projectInfo ? projectInfo.version : 'latest';
-				resolvedPath = resolvedPath.replace( 'latest', projectVersion );
+				resolvedPath = resolvedPath.replace( '/latest/', `/${ projectVersion }/` );
 			}
 
 			if ( options.projectsInfo ) {

package/themes/umberto/layout/gloria/_modules/kapa/custom_kapa_styles.css

@@ -11,11 +11,8 @@
 
 /* Style for hyperlinks inside the AI's answer. */
 #kapa-modal-content
-	> div:nth-of-type(1)
-	> div:nth-of-type(1)
-	> div:nth-of-type(1)
-	> div:nth-of-type(2)
-	> h5 + div
+	.scrollable-container
+	.mantine-Title-root + div
 	a
 {
 	font-weight: normal !important;

package/themes/umberto/src/gloria/css/layout/_mixins.scss

@@ -10,7 +10,7 @@ $breakpoint-xl: 1920px;
 }
 
 @mixin min-width($breakpoint) {
-    @media (min-width: calc(#{$breakpoint} - 1px)) {
+    @media (min-width: calc(#{$breakpoint})) {
         @content;
     }
 }