Thanks to visit codestin.com
Credit goes to github.com

Skip to content

[WIP] Fix build failure due to missing mermaid installation #581

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
manzke merged 2 commits into from
Dec 4, 2025
Merged

[WIP] Fix build failure due to missing mermaid installation #581

manzke merged 2 commits into from
Dec 4, 2025

Conversation

Copy link
Contributor

Copilot AI commented Dec 4, 2025 •
edited
Loading

Fix Build Failure: Missing mdbook-mermaid Installation

Problem: The build-binaries.yml workflow fails during documentation build because mdbook-mermaid preprocessor is not installed.

Root Cause: The build-binaries.yml workflow installs mdBook but not the required mdbook-mermaid preprocessor, which is needed by book.toml configuration.

Solution: Added installation steps for Rust toolchain, Cargo binary caching, and mdbook-mermaid in both the build-check and full build jobs.

Changes Made:

  • Analyze the issue and identify root cause
  • Update build-binaries.yml to install mdbook-mermaid using cargo
  • Add caching for Cargo binaries to improve CI performance
  • Add Rust toolchain installation to both build jobs
  • Verify the fix works in CI (will be verified when PR is pushed)
Original prompt

This section details on the original issue you should resolve

<issue_title>Build failed because of mermaid not installed</issue_title>
<issue_description>Run # Use Node.js SEA (Single Executable Application) feature with platform-specific argument
Building for platform: linux
Building iHub Apps using Node.js SEA...
Node.js version: v20.19.6
OS platform: Linux
Building documentation...

[email protected] docs:build
npm run docs:update-version && cd docs && mdbook build

[email protected] docs:update-version
node scripts/update-docs-version.js

Updating documentation version to: 4.3.11
Theme head.hbs version updated!
Documentation version updated successfully!
INFO Book building has started
ERROR The command mdbook-mermaid wasn't found, is the mermaid preprocessor installed? If you want to ignore this error when the mermaid preprocessor is not installed, set optional = true in the [preprocessor.mermaid] section of the book.toml configuration file.
ERROR Unable to run the preprocessor mermaid
Caused by: No such file or directory (os error 2)
Error: Process completed with exit code 101.</issue_description>

Comments on the Issue (you are @copilot in this section)

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@manzke manzke marked this pull request as ready for review December 4, 2025 16:26
@manzke manzke merged commit 91f0db3 into main Dec 4, 2025
4 checks passed
@manzke manzke deleted the copilot/fix-mermaid-installation-issue branch December 4, 2025 16:27
Copilot AI requested a review from manzke December 4, 2025 16:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@manzke manzke Awaiting requested review from manzke

Assignees

@manzke manzke

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Build failed because of mermaid not installed

2 participants

@manzke