From 0968de19c9ec889322bd04216f94e633a8630866 Mon Sep 17 00:00:00 2001 From: Ifeanyi Chima <48832130+MasterIfeanyi@users.noreply.github.com> Date: Fri, 12 Jun 2026 09:26:56 +0100 Subject: [PATCH 1/3] =?UTF-8?q?docs(deployment):=20update=20Node.js=20vers?= =?UTF-8?q?ion=20from=2020=20to=2024=20in=20deployment=20=E2=80=A6=20(#121?= =?UTF-8?q?18)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- website/docs/deployment.mdx | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/website/docs/deployment.mdx b/website/docs/deployment.mdx index de114761a0f6..a7ddcdd97c0d 100644 --- a/website/docs/deployment.mdx +++ b/website/docs/deployment.mdx @@ -401,7 +401,7 @@ jobs: fetch-depth: 0 - uses: actions/setup-node@v4 with: - node-version: 20 + node-version: 24 cache: npm - name: Install dependencies @@ -455,7 +455,7 @@ jobs: fetch-depth: 0 - uses: actions/setup-node@v4 with: - node-version: 20 + node-version: 24 cache: npm - name: Install dependencies @@ -487,7 +487,7 @@ jobs: fetch-depth: 0 - uses: actions/setup-node@v4 with: - node-version: 20 + node-version: 24 cache: yarn - name: Install dependencies @@ -541,7 +541,7 @@ jobs: fetch-depth: 0 - uses: actions/setup-node@v4 with: - node-version: 20 + node-version: 24 cache: yarn - name: Install dependencies @@ -608,7 +608,7 @@ jobs: fetch-depth: 0 - uses: actions/setup-node@v4 with: - node-version: 20 + node-version: 24 cache: yarn - name: Install dependencies run: yarn install --frozen-lockfile @@ -623,7 +623,7 @@ jobs: fetch-depth: 0 - uses: actions/setup-node@v4 with: - node-version: 20 + node-version: 24 cache: yarn - uses: webfactory/ssh-agent@v0.5.0 with: @@ -675,7 +675,7 @@ Continuous integration (CI) services are typically used to perform routine tasks ```yml title=".travis.yml" language: node_js node_js: - - 20 + - 24 branches: only: - main @@ -734,7 +734,7 @@ steps: - task: NodeTool@0 inputs: - versionSpec: '20' + versionSpec: '24' displayName: Install Node.js - script: | From 7da2c45be5adfad539d87425fcf84c5bbd96200c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Lorber?= Date: Fri, 12 Jun 2026 10:54:08 +0200 Subject: [PATCH 2/3] fix(create-docusaurus): init template README should use npm commands by default (#12138) --- .../create-docusaurus/templates/shared/README.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/packages/create-docusaurus/templates/shared/README.md b/packages/create-docusaurus/templates/shared/README.md index b28211a9bbd2..bce6eb2fc108 100644 --- a/packages/create-docusaurus/templates/shared/README.md +++ b/packages/create-docusaurus/templates/shared/README.md @@ -5,13 +5,15 @@ This website is built using [Docusaurus](https://docusaurus.io/), a modern stati ## Installation ```bash -yarn +npm install ``` +**Note**: feel free to use the package manager of your choice. + ## Local Development ```bash -yarn start +npm run start ``` This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. @@ -19,7 +21,7 @@ This command starts a local development server and opens up a browser window. Mo ## Build ```bash -yarn build +npm run build ``` This command generates static content into the `build` directory and can be served using any static contents hosting service. @@ -29,13 +31,13 @@ This command generates static content into the `build` directory and can be serv Using SSH: ```bash -USE_SSH=true yarn deploy +USE_SSH=true npm run deploy ``` Not using SSH: ```bash -GIT_USER= yarn deploy +GIT_USER= npm run deploy ``` -If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch. +If you are using GitHub Pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch. From b7963e359d9974cf1ce2fccd3a0c0ef1ca64e396 Mon Sep 17 00:00:00 2001 From: Ifeanyi Chima <48832130+MasterIfeanyi@users.noreply.github.com> Date: Fri, 12 Jun 2026 12:10:51 +0100 Subject: [PATCH 3/3] docs: document that plugin-ideal-image changes imported image types (#12130) --- .../docs/api/plugins/plugin-ideal-image.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/website/docs/api/plugins/plugin-ideal-image.mdx b/website/docs/api/plugins/plugin-ideal-image.mdx index aaaa9d026ccc..1ba4c41b18ad 100644 --- a/website/docs/api/plugins/plugin-ideal-image.mdx +++ b/website/docs/api/plugins/plugin-ideal-image.mdx @@ -36,6 +36,25 @@ import thumbnail from './path/to/img.png'; ``` +:::note + +When `plugin-ideal-image` is installed, importing a supported image file no longer returns a plain URL string. Instead, it returns an object with the shape: `{ preSrc: string, src: { src: string, width: number, height: number } }`. + +If you need to use the image in a standard `` tag, access it like this: + +```jsx +description +``` + +To avoid dealing with this object shape directly, it is recommended to use the `` component provided by this plugin instead. + +::: + :::warning This plugin registers a [Webpack loader](https://webpack.js.org/loaders/) that changes the type of imported/require images: