wip - in Bearbeitung

This commit is contained in:
Adam Skotarczak 2025-05-08 14:57:55 +02:00
parent b8f464fc4a
commit 1320328b58
9 changed files with 1105 additions and 24 deletions

View File

@ -1,9 +1,9 @@
{
// Diese Erweiterungen werden empfohlen, wenn das Projekt geöffnet wird
"recommendations": [
"davidanson.vscode-markdownlint",
"mhutchie.git-graph",
"ms-ceintl.vscode-language-pack-de",
"tomoki1207.pdf",
"yzhang.markdown-all-in-one"
]
],
// Optional: Erweiterungen, die eher nicht genutzt werden sollten
"unwantedRecommendations": []
}

BIN
.vscode/extensions.txt vendored

Binary file not shown.

13
.vscode/launch.json vendored
View File

@ -0,0 +1,13 @@
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Start index.js",
"skipFiles": ["<node_internals>/**"],
"program": "${workspaceFolder}/src/index.js"
}
]
}

14
.vscode/settings.json vendored Normal file
View File

@ -0,0 +1,14 @@
{
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.fixAll.eslint": "explicit"
},
"eslint.validate": ["javascript", "typescript"],
"files.eol": "\n",
"files.exclude": {
"**/node_modules": true
},
"javascript.updateImportsOnFileMove.enabled": "always",
"typescript.updateImportsOnFileMove.enabled": "always"
}

1000
build/mermaid.html Normal file

File diff suppressed because it is too large Load Diff

BIN
build/mermaid.pdf Normal file

Binary file not shown.

View File

@ -69,7 +69,7 @@
- Nutzt eine **einfach lesbare Syntax** ähnlich wie Markdown oder Code
- Eignet sich ideal zur Dokumentation von **Software**, **Prozessen**, **Systemarchitekturen** und **Ablauflogiken**
- Kann direkt in viele Tools eingebettet werden (z.B. GitHub, VS Code, MkDocs, Obsidian)
- Unterstützt **Versionierung**, **Code-first-Dokumentation** und ist vollständig **plattformunabhängig**
- Unterstützt **Versionierung**, **Code-first-Dokumentation** und ist vollständig **plattformunabhängig**
---
@ -110,7 +110,7 @@ flowchart TD
Entscheidung -- Nein --> Aktion2 --> Ende
```
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -163,7 +163,7 @@ flowchart TD
Schleife -- Ja --> Ende
```
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -225,7 +225,7 @@ flowchart TD
- `A -.-> B` → gestrichelte Linie
- `A ===> B` → dicker Pfeil
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -266,7 +266,7 @@ classDiagram
- `o--` → Aggregation
- `--` → Assoziation
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -292,7 +292,7 @@ stateDiagram-v2
Aktiv --> [*]
```
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -316,7 +316,7 @@ flowchart TD
A -- Nein --> C[Ausgabe: Klein]
```
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -348,7 +348,7 @@ flowchart TD
A2 --> B1
```
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -358,7 +358,7 @@ flowchart TD
- `pie` für Verhältnisdarstellungen
- `erDiagram` für Entitäten & Datenbanken
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -369,7 +369,7 @@ flowchart TD
- Wenn **Nein**, wird das nächste Element geholt und aufaddiert
- Wenn **Ja**, wird die Schleife beendet und `summe` zurückgegeben
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -388,7 +388,7 @@ flowchart TD
Öffne .md-Datei
> `Ctrl+Shift+V` oder rechtsklick → Markdown-Vorschau öffnen
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -420,7 +420,7 @@ flowchart LR
Start --> Prozess1 --> Fehler
```
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -460,6 +460,10 @@ flowchart TD
| `text-align` | Textausrichtung innerhalb des Knotens | `text-align:center` |
| `rx`, `ry` | Rundung der Ecken | `rx:10`, `ry:10` |
[](#-inhalt)
---
### Beispiel mit mehreren Eigenschaften
**Code:**
@ -484,7 +488,7 @@ flowchart TD
- Du kannst mehrere style-Zeilen einfügen
- Unterstützt nur Grundwerte, kein CSS-Selektor, kein hover, keine Klassen
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -492,6 +496,8 @@ flowchart TD
Mermaid erlaubt einfache Interaktionen direkt im Diagramm. Besonders hilfreich für Dokumentationen, Präsentationen oder klickbare Projektübersichten.
[](#-inhalt)
---
### Klickbare Knoten
@ -516,6 +522,8 @@ flowchart TD
> **Hinweis:** Das funktioniert nur in Umgebungen, die `click` unterstützen (z.B. HTML-Embedding oder Mermaid Live Editor, nicht in GitHub-Rendern).
[](#-inhalt)
---
### Tooltip mit `click` kombinieren
@ -536,6 +544,8 @@ flowchart TD
click Hilfe "https://example.com/hilfe" "Öffnet die Hilfeseite"
```
[](#-inhalt)
---
### Ankerpunkte / Subgraph-Steuerung
@ -578,6 +588,8 @@ flowchart TB
click DB "https://db-docs.example.com" "DB-Doku"
```
[](#-inhalt)
---
### Weitere Optionen
@ -598,7 +610,7 @@ flowchart TB
- Für interaktive Versionen → HTML exportieren oder Mermaid Live Editor nutzen.
- Tooltips erscheinen nur bei aktiver `click`-Anweisung.
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -606,6 +618,8 @@ flowchart TB
Mermaid-Diagramme lassen sich auch automatisiert rendern und testen z.B. in **Build-Skripten**, **Makefiles** oder **CI/CD-Pipelines**. Das ist nützlich, wenn du aus `.mmd`-Quelldateien automatisch **SVGs** oder **PNGs** generieren willst.
[](#-inhalt)
---
### Mermaid CLI (`@mermaid-js/mermaid-cli`)
@ -622,6 +636,8 @@ Danach kannst du eine `.mmd`-Quelldatei rendern:
mmdc -i diagram.mmd -o diagram.svg
```
[](#-inhalt)
---
### Beispiel: Einfache .mmd-Datei
@ -651,6 +667,8 @@ mmdc -i diagram.mmd -o diagram.svg
| `--width` | Breite des Diagramms |
| `--scale` | Skalierung (z.B. für PDF-Ausgabe) |
[](#-inhalt)
---
### Automatisierung mit Makefile
@ -660,6 +678,8 @@ diagram.svg: diagram.mmd
mmdc -i diagram.mmd -o diagram.svg -t dark
```
[](#-inhalt)
---
### CI-Beispiel (GitHub Actions)
@ -678,6 +698,8 @@ jobs:
- run: mmdc -i diagram.mmd -o diagram.svg
```
[](#-inhalt)
---
### 📌 Hinweis
@ -696,7 +718,7 @@ Makefile
README.md
```
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -714,6 +736,8 @@ Die **offizielle Mermaid CLI** (`@mermaid-js/mermaid-cli`) erlaubt den Export vo
mmdc -i diagram.mmd -o diagram.svg
```
[](#-inhalt)
---
### Installation
@ -724,6 +748,8 @@ Installieren über npm:
npm install -g @mermaid-js/mermaid-cli
```
[](#-inhalt)
---
### 🛠 Typische Optionen
@ -736,6 +762,8 @@ npm install -g @mermaid-js/mermaid-cli
| `--scale` | Skalierung der Ausgabe (z.B. `--scale 2`) |
| `--width`, `--height` | Feste Größenangabe |
[](#-inhalt)
---
### Beispiel: SVG aus `.mmd` erzeugen
@ -768,6 +796,8 @@ Makefile
README.md
```
[](#-inhalt)
---
### Makefile-Beispiel
@ -795,6 +825,8 @@ jobs:
- run: mmdc -i diagram.mmd -o diagram.svg -t forest
```
[](#-inhalt)
---
### Hinweise
@ -803,6 +835,8 @@ jobs:
- Nur `.mmd`-Dateien werden unterstützt kein Inline-Markdown
- Ideal für automatisierten SVG-Export für Dokumentation oder statische Webseiten
[](#-inhalt)
---
## Template & Projektintegration
@ -833,7 +867,7 @@ flowchart TD
Init --> Task1 --> Task2 --> Done
```
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -850,7 +884,7 @@ flowchart TD
- Mermaid auf GitHub <https://github.com/mermaid-js/>
[ Inhalt](#-inhalt)
[](#-inhalt)
---
@ -860,6 +894,6 @@ flowchart TD
Hier ist ein **deutschsprachiges Mermaid Cheat Sheet** mit den wichtigsten Diagrammtypen, Syntaxelementen und Beispielen vollständig in Markdown, damit du es direkt in deine Projekte einbinden kannst.
[ Inhalt](#-inhalt)
[](#-inhalt)
---

View File

@ -0,0 +1 @@
pandoc index.md -o ./build/mermaid.html --standalone --toc --metadata pagetitle="Mermaid Pocket Guide" --template=mermaid.html

View File

@ -0,0 +1,19 @@
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="utf-8" />
<title>$title$</title>
<script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
<script>
mermaid.initialize({ startOnLoad: true });
</script>
</head>
<body>
$body$
</body>
</html>