Skip to content

Add mermaid diagram support#47

Merged
anthonymonori merged 4 commits intotrunkfrom
feature/add-mermaid-support
Feb 22, 2026
Merged

Add mermaid diagram support#47
anthonymonori merged 4 commits intotrunkfrom
feature/add-mermaid-support

Conversation

@anthonymonori
Copy link
Owner

@anthonymonori anthonymonori commented Feb 22, 2026

Summary

  • Add jekyll-mermaid-prebuild gem for build-time SVG rendering
  • Configure output directory (assets/svg) for generated diagrams
  • Update CI workflow to install mermaid-cli and Puppeteer dependencies

Why jekyll-mermaid-prebuild?

  • No client-side JavaScript - diagrams render to static SVG at build time
  • Better SEO - search engines can index diagram content
  • Faster page loads - no ~2MB mermaid.js download
  • Caching - only regenerates changed diagrams

Usage

Use fenced code blocks with mermaid language:

graph TD
    A[Start] --> B[End]
Loading

Requirements

  • mmdc (mermaid-cli) installed globally
  • Puppeteer dependencies (for headless Chrome)

Testing

Will be tested with upcoming blog posts featuring architecture diagrams.

- Add jekyll-mermaid-prebuild gem for build-time SVG rendering
- Configure output directory for generated diagrams
- Update CI workflow to install mermaid-cli and Puppeteer deps

This approach renders diagrams to static SVG at build time,
eliminating client-side JavaScript requirements.
@anthonymonori anthonymonori force-pushed the feature/add-mermaid-support branch from 8a94dee to 48f191e Compare February 22, 2026 14:17
- Bump Node.js version from 20 to 24 in CI workflow
- Add SETUP.md with local development prerequisites
- Update README.md to reference SETUP.md for mermaid deps
Ubuntu 24.04 renamed libasound2 to libasound2t64.
Update CI workflow and SETUP.md accordingly.
jekyll-mermaid-prebuild >= 0.3.0 requires Ruby >= 3.3.0.
Use Ruby 3.4 (current LTS) for CI and local development.

- Update CI workflow to use Ruby 3.4
- Update SETUP.md to reflect Ruby 3.4 requirement
@anthonymonori anthonymonori merged commit b2a0273 into trunk Feb 22, 2026
1 check passed
@anthonymonori anthonymonori deleted the feature/add-mermaid-support branch February 22, 2026 23:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant