From 411d58b997e71ddb10c882b58f5069f0ac9fc50e Mon Sep 17 00:00:00 2001 From: kuro Date: Sat, 10 Oct 2026 00:14:09 +0000 Subject: [PATCH] Add Konfiguration --- Konfiguration.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 Konfiguration.md diff --git a/Konfiguration.md b/Konfiguration.md new file mode 100644 index 0000000..7887c73 --- /dev/null +++ b/Konfiguration.md @@ -0,0 +1,39 @@ +# ⚙️ Konfiguration + +Die **BMC TPL Code All around** Extension lässt sich tief in deinen Workflow integrieren. Über die VS Code Einstellungen kannst du Standardwerte definieren, die das Plugin automatisch beim Erstellen neuer Module (z.B. über das `tpl_skeleton` Snippet) verwendet. + +Das spart bei jedem neuen Pattern das manuelle Eintippen von immer gleichen Metadaten! + +--- + +## 🛠️ Einstellungen öffnen + +1. Öffne die Einstellungen in VS Code über das Menü: **File > Preferences > Settings** (Windows/Linux) oder **Code > Settings > Settings** (Mac). + *(Alternativ: Drücke einfach `Ctrl + ,` bzw. `Cmd + ,`)* +2. Tippe in die Suchleiste oben **`TPL`** ein. +3. Wähle auf der linken Seite unter *Extensions* den Punkt **BMC TPL Einstellungen** aus. + +--- + +## 📋 Verfügbare Einstellungen + +Hier ist eine Übersicht aller Konfigurationsmöglichkeiten, die dir das Plugin aktuell bietet: + +| Einstellungshäbchen | Interner Name | Standardwert | Beschreibung | +| :--- | :--- | :--- | :--- | +| **Author** | `tpl.metadata.author` | `Kuro` | Der Standard-Autor, der beim Generieren eines neuen TPL-Moduls (z.B. im `tpl_skeleton`) in den `metadata`-Block eingetragen wird. | +| **Origin** | `tpl.metadata.origin` | `Custom` | Definiert die Herkunft des Moduls (z.B. `Custom` oder der Firmenname). | +| **Publisher** | `tpl.metadata.publisher` | `IT-Operations` | Der Standard-Publisher für neu generierte Module. | +| **Tree Path Base** | `tpl.metadata.treePathBase` | `Grafing` | Der erste (Basis-)Teil des `tree_path` in den Metadaten. Die Kategorien und Subkategorien kannst du nach dem Einfügen des Snippets per `Tab` bequem selbst ausfüllen. | +| **Version** | `tpl.version` | `23` | Die aktuelle TPL-Nebenversion (z.B. `23` für TPL 1.23). **Wichtig:** Diese Zahl wird zum einen in neue Skeleton-Skripte eingefügt (`tpl 1.23 module...`), zum anderen nutzt der Linter diesen Wert! Ist ein geöffnetes Modul *älter* als diese Version, gibt der Linter eine Warnung aus. | + +--- + +## ⚡ Live-Reload (Kein Neustart nötig!) + +Ein großer Vorteil der Extension: **Alle Änderungen greifen sofort!** + +Wenn du beispielsweise die TPL-Version von `23` auf `24` änderst, wertet der Linter alle im Hintergrund geöffneten `.tpl` Dateien sofort neu aus und markiert nun eventuell alte Module mit einer Warnung, ohne dass du VS Code neustarten musst. Auch Snippets nutzen ab der nächsten Eingabe sofort die neuen Werte. + +--- +**Tipp für Teams:** Du kannst diese Einstellungen auch als Workspace-Einstellungen (in einem `.vscode/settings.json` Ordner) ablegen und per Git teilen. So hat dein gesamtes Entwickler-Team automatisch die exakt gleichen Publisher- und Versions-Vorgaben! \ No newline at end of file