Merge pull request 'refactor: reference diagrams-drawio' (#1) from refactor/diagrams-drawio-reference into test
This commit was merged in pull request #1.
This commit is contained in:
@@ -15,7 +15,7 @@ metadata:
|
|||||||
framework: Diátaxis
|
framework: Diátaxis
|
||||||
hermes:
|
hermes:
|
||||||
tags: [docusaurus, documentation, diataxis, drawio, mdx, react-flow]
|
tags: [docusaurus, documentation, diataxis, drawio, mdx, react-flow]
|
||||||
related_skills: [drawio-main]
|
related_skills: [diagrams-drawio]
|
||||||
compatibility: Designed for Docusaurus v3. Works with Cline, Claude Code, GitHub Copilot, OpenAI Codex, and other compatible agent environments
|
compatibility: Designed for Docusaurus v3. Works with Cline, Claude Code, GitHub Copilot, OpenAI Codex, and other compatible agent environments
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -32,7 +32,7 @@ This is the primary project-adopted skill for **3D Architecture Wizzard** (`3dar
|
|||||||
- Application: https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch
|
- Application: https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch
|
||||||
- Documentation: https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch-documentation
|
- Documentation: https://gitea.lego-cloud.eu/corp-v1-3darch/corp-v1-3darch-documentation
|
||||||
- Environment namespace: `CORP_V1_3DARCH_*`
|
- Environment namespace: `CORP_V1_3DARCH_*`
|
||||||
- Global diagram skill: https://gitea.lego-cloud.eu/home-v1-skills-code-agent/drawio-main
|
- Global diagram skill: https://gitea.lego-cloud.eu/home-v1-skills-code-agent/diagrams-drawio
|
||||||
- Global glossary skill: https://gitea.lego-cloud.eu/home-v1-skills-code-agent/corp-v1--glossary
|
- Global glossary skill: https://gitea.lego-cloud.eu/home-v1-skills-code-agent/corp-v1--glossary
|
||||||
- Project automation: none; no scheduler job is authorized.
|
- Project automation: none; no scheduler job is authorized.
|
||||||
|
|
||||||
@@ -160,7 +160,7 @@ Use `@xyflow/react` when validated documentation data needs an interactive roadm
|
|||||||
|
|
||||||
### Draw.io source diagrams
|
### Draw.io source diagrams
|
||||||
|
|
||||||
When a page needs a Draw.io diagram, keep the editable `.drawio` XML in the documentation repository and render that source directly with `docusaurus-plugin-drawio`. Load `drawio-main` to author or change the diagram, then follow [references/drawio-source-diagrams.md](references/drawio-source-diagrams.md) to install the plugin with pnpm, register it, consume the source from MDX with `@theme/Drawio` and `!!raw-loader!`, select multi-page diagrams, and verify the production build and browser rendering. An exported PNG/SVG alone is not an onboarded source diagram.
|
When a page needs a Draw.io diagram, keep the editable `.drawio` XML in the documentation repository and render that source directly with `docusaurus-plugin-drawio`. Load `diagrams-drawio` to author or change the diagram, then follow [references/drawio-source-diagrams.md](references/drawio-source-diagrams.md) to install the plugin with pnpm, register it, consume the source from MDX with `@theme/Drawio` and `!!raw-loader!`, select multi-page diagrams, and verify the production build and browser rendering. An exported PNG/SVG alone is not an onboarded source diagram.
|
||||||
|
|
||||||
### Interactive Elements (Use Sparingly)
|
### Interactive Elements (Use Sparingly)
|
||||||
|
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ Use this workflow when a Docusaurus v3 site must render an editable Draw.io sour
|
|||||||
- Commit the editable `.drawio` XML in the documentation repository.
|
- Commit the editable `.drawio` XML in the documentation repository.
|
||||||
- Render that source directly in MDX; do not make a PNG/SVG export the only authoritative artifact.
|
- Render that source directly in MDX; do not make a PNG/SVG export the only authoritative artifact.
|
||||||
- Keep the source adjacent to, or in a clearly named diagram directory near, the page that consumes it.
|
- Keep the source adjacent to, or in a clearly named diagram directory near, the page that consumes it.
|
||||||
- Use the global `drawio-main` skill to author and validate diagram content.
|
- Use the global `diagrams-drawio` skill to author and validate diagram content.
|
||||||
- Use this `documentation-docusaurus` skill to onboard and render the source in Docusaurus.
|
- Use this `documentation-docusaurus` skill to onboard and render the source in Docusaurus.
|
||||||
|
|
||||||
Recommended layout:
|
Recommended layout:
|
||||||
|
|||||||
Reference in New Issue
Block a user