Neuer ioBroker-Blog online: Monatsrückblick März/April 2026

[UlliJ]

super gemacht👍
Hatte auch gerade mit Doku angefangen, mit etwas anderem Ansatz und manuell generiert. Mehr darauf ausgerichtet die Zusammenhänge verständlich zu machen. Die Kombi aus beidem wäre perfekt🤔

[sigi234]

@crunchip sagte:

@sigi234 sollte jetzt alles behoben sein

Ja, Danke

[crunchip]

@UlliJ sagte:

Mehr darauf ausgerichtet die Zusammenhänge verständlich zu machen

Ja das fehlt bei mir noch ein wenig

[UlliJ]

@crunchip sagte:

Ja das fehlt bei mir noch ein wenig

mal quick & dirty auf Teile der Autodoku verlinkt

[crunchip]

@UlliJ sagte:

Die Kombi aus beidem wäre perfekt

Ich hab mal mit auf die todo Liste gesetzt

[sigi234]

@crunchip

Hallo,

wie sehe ich Live Werte?

[crunchip]

@sigi234 sagte:

Live Werte

Sind es eigentlich nicht, eher Momentaufnahmen, seh ich mir an, vllt nehme ich das auch raus

[sigi234]

@crunchip

Hallo,

cool wäre es noch wenn es eine Kurzübersicht geben würde wo die wichtigsten Daten des Systems ersichtlich sind.
Vor allem für einen helfenden User um nicht immer nachfragen zu müssen wie das System ist.

[arteck]

@crunchip sagte:

Nach dem Speichern der Konfiguration: „Generate now“ oder Automatik abwarten. Die HTML-Dateien liegen unter …/files/autodoc.

wiso da ??

alles Adapter spezfifische landet im iobroker-data verzeichniss

anosnten solltest du die Felder ausblenden wenn nicht benötigt

[Homoran]

@arteck sagte:

alles Adapter spezfifische landet im iobroker-data verzeichniss

Und??
Da ist doch dann files die nächste Ebene

[arteck]

@Homoran sagte:

Da ist doch dann files die nächste Ebene

und

rate was da nicht steht

[crunchip]

@arteck ok, wenn das so falsch ist mit der Ablage, ändert ich das ab.
Bei den Feldern dachte ich mir, füge ich Beschreibungen hinzu, damit es verständlicher ist.

[crunchip]

@sigi234 geb mir mal ein Beispiel was du genau meinst?

[sigi234]

@crunchip sagte:

@sigi234 geb mir mal ein Beispiel was du genau meinst?

RAM und CPU zum 1. Bild dazu

Aber hier:

Phase 5 — Erweiterungen (Nice-to-Have)
PDF-Export
Backup-Adapter Integration
Custom Templates
QR-Code für Onboarding (qrcodejs CDN + Fallback)

hast du ja Custom Templates geplant, damit könnte man ja dann eine eigene zusammen stellen?

[crunchip]

@sigi234 sagte:

RAM und CPU zum 1. Bild dazu

Achso, du meinst eine komplette gesamt Übersicht

@sigi234 sagte:

hast du ja Custom Templates geplant

Ja, das war zu Anfangszeiten mal als Gedankengang festgehalten

EDIT:

als Beispiel

Ebene 1 — Inhalts-Auswahl (leicht)
Der Nutzer wählt welche Kapitel in der generierten Doku erscheinen:

Checkboxen in der Admin-UI: "Räume", "Skripte", "Hosts", "Diagnose", ...
Reihenfolge der Kapitel anpassbar
Eigentlich schon teilweise durch die drei Profile abgedeckt — aber flexibler

Ebene 2 — Layout/Styling anpassen (mittel)
Eigene CSS-Klassen oder Farb-Themes
Logo / Header-Bild einbinden
Schriftart, Farbschema (Hell/Dunkel-Präferenz manuell setzen)
Für Nutzer die die Doku z. B. an Hausverwaltung oder Familie weitergeben und etwas "Eigenes" haben wollen

Ebene 3 — Eigene Sektionen mit Freitext (mittel)
Nutzer kann eigene Kapitel definieren: Titel + Markdown-Freitext
Z. B. „Notfallkontakte", „WLAN-Passwörter", „Routermodell", „Handwerker-Kontakte"
Dinge die ioBroker nicht kennt aber in die Haus-Doku gehören
Das überschneidet sich mit manualContext — aber strukturierter und freier

Ebene 4 — Eigene Daten-Abfragen (schwer)
Nutzer definiert welche States/Objekte zusätzlich abgefragt werden
Eigene Tabellen aus beliebigen State-Pfaden
Ähnlich wie Vis-Widgets aber für Doku — sehr viel Komplexität

Ebene 5 — Komplettes Template-Replacement (sehr schwer)
Nutzer liefert eigene Handlebars/Mustache/Jinja-Vorlage
Volle Kontrolle über HTML-Ausgabe
Extrem mächtig, aber kaum jemand würde das nutzen — und Wartungsaufwand enorm

[crunchip]

@arteck sagte:

alles Adapter spezfifische landet im iobroker-data verzeichniss

muss ich dann nochmal nachfragen
wie greife ich die HTML/Markdown/JSON-Dateien und die direkten Links dann per Admin-Browser ab, wenn nicht über den /files/-Namespace?

[arteck]

zur Zeit exisitieren die nur in der DB. wo diese nicht reingehören. das was du generiest ist eine Statische HTML Seite..
und bläht unnötig die DB auf, würde ich behaupten ..

bis dato hatten wir sowas noch nicht..

du willst ja aus dem Admin heraus die Seiten aufrufen.. verstehe ich .. ist ja auch nicht falsch.. es muss dir aber im Klaren sein (oder auch nicht) dass das nicht im Filesystem landet sondern in der jsonl oder redis direkt.

läuft iobroker nicht nutzen mir die Seiten nix weil ich kein zugriff drauf habe..

ich nehm das Thema mal mit für heutiges Meeting

[crunchip]

@arteck ich verstehe das schon, zumindest halbwegs. Jedoch hatte ich, wie in der Plan.md ersichtlich, es in weiterer Planung, noch im Backup mit aufzunehmen.
Ich habe Hilfe der AI zu Rate gezogen, die mir da auch sagt, das es nicht anders geht.
Aber schön das du das mal besprichst, bin gespannt.
Edit:
@arteck hab mir gerade die Aufzeichnung von gestern abend angesehen, also unterm Strich... Keine einfache Sache😅
Aber ich überlege mir was

[arteck]

@crunchip sagte:

Keine einfache Sache

einfach kann jeder :-)

[crunchip]

v0.9.8 im ersten Beitrag