rhdh-techdocs-mermaid-addon

Dynamic plugin wrapper para Red Hat Developer Hub que habilita el soporte de diagramas Mermaid en TechDocs.

🎯 Propósito

Este plugin resuelve el problema de que RHDH no incluye el addon de Mermaid por defecto. Permite usar diagramas Mermaid en TechDocs en entornos de OpenShift donde no se pueden instalar paquetes npm directamente.

📦 ¿Qué hace este plugin?

1. Wrappe el addon oficial: Incluye backstage-plugin-techdocs-addon-mermaid como dependencia
2. Compatible con dynamic plugins: Se instala como dynamic plugin en RHDH
3. Configuración automática: Se integra automáticamente con TechDocs existente

🚀 Instalación en RHDH

$3

``yaml
global:
dynamic:
includes:
- dynamic-plugins.default.yaml
plugins:
- package: 'rhdh-techdocs-mermaid-addon@^2.0.2'
integrity: 'sha512-R0XRmPTkfH0rrp3QSEEgwj8CvDMKlVGukluFeQrVEngCidmP6Jl/xo+VtA3kB6hQ2/71hHmBJUB6nKd0pxa3PQ=='
disabled: false
`

$3

`yaml
kind: ConfigMap
apiVersion: v1
metadata:
name: dynamic-plugins-rhdh
data:
dynamic-plugins.yaml: |
includes:
- dynamic-plugins.default.yaml
plugins:
- package: 'rhdh-techdocs-mermaid-addon@^2.0.2'
integrity: 'sha512-R0XRmPTkfH0rrp3QSEEgwj8CvDMKlVGukluFeQrVEngCidmP6Jl/xo+VtA3kB6hQ2/71hHmBJUB6nKd0pxa3PQ=='
disabled: false
`

📝 Uso

Una vez instalado, los diagramas Mermaid funcionarán automáticamente en TechDocs:

``markdown
`mermaid
graph TD
A[Start] --> B{Decision}
B -->|Yes| C[Action 1]
B -->|No| D[Action 2]
C --> E[End]
D --> E
`
``

✅ Verificación

1. Ve a Administration > Plugins en RHDH
2. Busca rhdh-techdocs-mermaid-addon
3. Verifica que aparezca como "Loaded"

🔧 Desarrollo

`bash
npm install
npm run build
npm publish --access public
``

📚 Compatibilidad

- ✅ Red Hat Developer Hub 1.x
- ✅ OpenShift 4.x
- ✅ Backstage 1.11+