|
| 1 | +# Monaco Editor Setup für Code Editor AddOn |
| 2 | + |
| 3 | +## Überblick |
| 4 | + |
| 5 | +Das Code Editor AddOn verwendet eine **lokale Monaco Editor Installation** statt CDN, um maximale Verfügbarkeit in Notfallsituationen zu gewährleisten. |
| 6 | + |
| 7 | +## Installation & Setup |
| 8 | + |
| 9 | +### 1. Dependencies installieren |
| 10 | +```bash |
| 11 | +cd src/addons/code |
| 12 | +npm install |
| 13 | +``` |
| 14 | + |
| 15 | +### 2. Monaco Editor lokal bauen |
| 16 | +```bash |
| 17 | +npm run build |
| 18 | +``` |
| 19 | + |
| 20 | +### 3. Monaco Editor aktualisieren |
| 21 | +```bash |
| 22 | +npm run update-monaco |
| 23 | +``` |
| 24 | + |
| 25 | +## Ordnerstruktur nach Build |
| 26 | + |
| 27 | +``` |
| 28 | +src/addons/code/ |
| 29 | +├── assets/ |
| 30 | +│ ├── monaco-editor/ # Lokale Monaco Editor Dateien |
| 31 | +│ │ └── vs/ # Monaco Core Files |
| 32 | +│ ├── monaco-loader.js # Lokaler Monaco Loader |
| 33 | +│ ├── monaco-version.json # Version Info |
| 34 | +│ ├── code-editor.js # Hauptlogik (mit lokalem Monaco) |
| 35 | +│ └── code-editor.css # Styles |
| 36 | +├── package.json # NPM Dependencies |
| 37 | +├── build.js # Build Script |
| 38 | +└── node_modules/ # NPM Dependencies (nicht im Git) |
| 39 | +``` |
| 40 | + |
| 41 | +## Funktionsweise |
| 42 | + |
| 43 | +1. **Lokaler Load**: AddOn lädt Monaco Editor aus `assets/monaco-editor/` |
| 44 | +2. **CDN Fallback**: Falls lokal nicht verfügbar, automatischer CDN-Fallback |
| 45 | +3. **Versionskontrolle**: `monaco-version.json` trackt aktuelle Version |
| 46 | +4. **Cache-Busting**: Automatische Cache-Invalidierung bei Updates |
| 47 | +5. **Vollbild-Modus**: F11 oder Vollbild-Button für bessere Übersicht |
| 48 | + |
| 49 | +## Updates |
| 50 | + |
| 51 | +### Monaco Editor auf neue Version aktualisieren |
| 52 | +```bash |
| 53 | +npm run update-monaco |
| 54 | +``` |
| 55 | + |
| 56 | +### Nur Build ohne Update |
| 57 | +```bash |
| 58 | +npm run build |
| 59 | +``` |
| 60 | + |
| 61 | +### Nach Updates |
| 62 | +- Dateien nach `public/assets/addons/code/` kopieren |
| 63 | +- Browser-Cache leeren |
| 64 | +- AddOn neu laden |
| 65 | + |
| 66 | +## Vorteile der lokalen Installation |
| 67 | + |
| 68 | +✅ **Offline-Verfügbarkeit** - Funktioniert ohne Internet |
| 69 | +✅ **Notfall-sicher** - Kein CDN-Ausfall-Risiko |
| 70 | +✅ **Kontrollierte Updates** - Manuelle Version-Upgrades |
| 71 | +✅ **Performance** - Lokale Dateien, kein externes Loading |
| 72 | +✅ **Sicherheit** - Keine externen Dependencies zur Laufzeit |
| 73 | +✅ **Vollbild-Editor** - F11 oder Button für ablenkungsfreies Arbeiten |
| 74 | + |
| 75 | +## Entwicklung |
| 76 | + |
| 77 | +### Monaco Editor Version prüfen |
| 78 | +```bash |
| 79 | +cat assets/monaco-version.json |
| 80 | +``` |
| 81 | + |
| 82 | +### Build-Output prüfen |
| 83 | +```bash |
| 84 | +ls -la assets/monaco-editor/vs/ |
| 85 | +``` |
| 86 | + |
| 87 | +### Fallback testen |
| 88 | +```javascript |
| 89 | +// In Browser Console |
| 90 | +delete window.monaco; |
| 91 | +// Seite neu laden - sollte CDN-Fallback verwenden |
| 92 | +``` |
| 93 | + |
| 94 | +## Troubleshooting |
| 95 | + |
| 96 | +### Problem: Monaco Editor lädt nicht |
| 97 | +1. Build ausführen: `npm run build` |
| 98 | +2. Dateien nach public kopieren |
| 99 | +3. Browser-Cache leeren |
| 100 | + |
| 101 | +### Problem: Veraltete Version |
| 102 | +1. `npm run update-monaco` |
| 103 | +2. Dateien synchronisieren |
| 104 | +3. AddOn neu starten |
| 105 | + |
| 106 | +### Problem: CDN-Fallback aktiviert |
| 107 | +- Prüfe ob lokale Dateien existieren: `assets/monaco-editor/vs/loader.js` |
| 108 | +- Build neu ausführen |
| 109 | +- Dateiberechtigungen prüfen |
| 110 | + |
| 111 | +## Deployment |
| 112 | + |
| 113 | +Für Produktionsumgebung: |
| 114 | +1. `npm install --production` |
| 115 | +2. `npm run build` |
| 116 | +3. Nur `assets/` Ordner deployen |
| 117 | +4. `node_modules/` **nicht** deployen |
0 commit comments