Skip to content

Conversation

@sgort
Copy link
Collaborator

@sgort sgort commented Nov 28, 2025

Closes #56

Render interactive BPMN diagrams in the Docusaurus documentation while keeping BPMN files alongside their markdown content in docs/.

@sgort
Copy link
Collaborator Author

sgort commented Nov 28, 2025

Reference issue

There is an issue with original references in the markdown files.

For example in file docs\documentation\reference\bpmn20\events\error-events.md the reference is <div data-bpmn-diagram="../bpmn/catchandthrowpattern"></div>, where the file is in docs\documentation\reference\bpmn20\events\bpmn\catchandthrowpattern.bpmn

That is wrong.

image

Fix

With fix-bpmn-references.js all of these references are changed from ../ into ./.

The diagrams are rendering now. Still need to check all individual files. But PR is ready for review.

image

@sgort sgort marked this pull request as ready for review November 28, 2025 10:35
@sgort sgort requested a review from a-m-zill November 28, 2025 10:35
@sgort
Copy link
Collaborator Author

sgort commented Nov 28, 2025

I checked all the files.

Only [fix-bpmn] 1 reference(s) fixed in: C:\Users\mail\Development\documentation\docs\documentation\user-guide\process-engine\transactions-in-processes.md is not working.

There is no event-based-gateway.bpmn file in docs\documentation\user-guide\process-engine\bpmn. So this rendering error is correct.

image

Copy link
Contributor

@a-m-zill a-m-zill left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thx @sgort

@a-m-zill a-m-zill merged commit e7a99cc into operaton:main Dec 3, 2025
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.

Implement a BPMN viewer component for Docusaurus

2 participants