Weiter zum Inhalt
  • Home
  • Aktuell
  • Tags
  • 0 Ungelesen 0
  • Kategorien
  • Unreplied
  • Beliebt
  • GitHub
  • Docu
  • Hilfe
Skins
  • Hell
  • Brite
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dunkel
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Standard: (Kein Skin)
  • Kein Skin
Einklappen
ioBroker Logo

Community Forum

donate donate
  1. ioBroker Community Home
  2. Deutsch
  3. Tester
  4. ...nicht in offiziellem Repo
  5. Test Adapter autodoc

NEWS

  • Neuer ioBroker-Blog online: Monatsrückblick März/April 2026
    BluefoxB
    Bluefox
    5
    1
    125

  • Verwendung von KI bitte immer deutlich kennzeichnen
    HomoranH
    Homoran
    8
    1
    164

  • Monatsrückblick Januar/Februar 2026 ist online!
    BluefoxB
    Bluefox
    18
    1
    868

Test Adapter autodoc

Geplant Angeheftet Gesperrt Verschoben ...nicht in offiziellem Repo
testadapterollamadoku
30 Beiträge 5 Kommentatoren 325 Aufrufe 5 Beobachtet
  • Älteste zuerst
  • Neuste zuerst
  • Meiste Stimmen
Antworten
  • In einem neuen Thema antworten
Anmelden zum Antworten
Dieses Thema wurde gelöscht. Nur Nutzer mit entsprechenden Rechten können es sehen.
  • crunchipC crunchip

    Konfiguration & Bedienung (Instanz)
    Die Einstellungen sind in Tabs gegliedert:

    • Basic / Grundeinstellungen — Projekt-/Dokusprache, Profil (steuert v. a. den Fokus des Markdown-Exports; alle drei HTML-Seiten Admin / User / Onboarding werden immer erzeugt). Automatik: beim Start, bei Adapter-Änderungen (mit kurzer Verzögerung), optional Intervall in Stunden. Live-Werte (Temperatur, Tür/Fenster, Alarm) nur für Onboarding, wenn du es aktivierst. Zum sofortigen Start: „Generate documentation now“; darunter siehst du, wann zuletzt erzeugt wurde.
      765ad81a-0e5b-44e4-8d52-4daf3205d45c-image.jpeg

    • My documentation — Projektname, Beschreibung, Kontakt, allgemeine Notizen; Tabellen für Hinweise pro Adapter und pro Raum; Listen, welche Räume/Adapter du in User- bzw. Onboarding-HTML ausblendest.
      9d0c551d-6b0b-40cb-9318-9dbb5ca9b725-image.jpeg

    • Advanced — nur aktivierte Instanzen dokumentieren, Markdown kürzer (ohne volle Instanzliste), Obergrenzen für Instanzen und für die Anzahl archivierter Dateisätze, optional Basis-URL für die Direktlinks in den States (sinnvoll bei Docker/fester Adresse).
      cd4ee6b7-d1f2-4ab5-a8bf-7a799c96cc32-image.jpeg

    • Notifications — nach einer Erzeugung z. B. Telegram/Pushover/E-Mail informieren (Instanz + optional Empfänger + Textvorlage).
      6592d87a-2c52-4574-ae9d-00dafe465bdf-image.jpeg

    • AI documentation — optional: Anbieter (z. B. Ollama lokal), Modell, API-Key (falls nötig), Ollama-URL, Timeout und Temperaturen getrennt für Bewohner- und Gästetext. Ohne Anbieter bleibt die KI-Box aus bzw. neutral.
      90e3e2bd-6391-41d0-8bc6-5cfff7c1beb3-image.jpeg

    Benutzung im Alltag
    Nach dem Speichern der Konfiguration: „Generate now“ oder Automatik abwarten. Die HTML-Dateien liegen unter …/files/autodoc.<Instanz>/ (z. B. autodoc-admin.html, autodoc-user.html, autodoc-onboarding.html). Im Objektbaum findest du u. a. States mit Direktlinks zu den letzten HTML-Seiten (info.htmlUrlAdmin usw.), wenn die Basis-URL passt.

    arteckA Offline
    arteckA Offline
    arteck
    Developer Most Active
    schrieb am zuletzt editiert von arteck
    #21

    @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

    09960e43-0a19-4968-b169-0039337b066f-image.jpeg

    zigbee hab ich, zwave auch, nuc's genauso und HA auch

    HomoranH crunchipC 3 Antworten Letzte Antwort
    0
    • arteckA 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

      09960e43-0a19-4968-b169-0039337b066f-image.jpeg

      HomoranH Nicht stören
      HomoranH Nicht stören
      Homoran
      Global Moderator Administrators
      schrieb am zuletzt editiert von
      #22

      @arteck sagte:

      alles Adapter spezfifische landet im iobroker-data verzeichniss

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

      kein Support per PN! - Fragen im Forum stellen -
      Benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
      Das Forum freut sich über eine Spende. Benutzt dazu den Spendenbutton oben rechts. Danke!
      der Installationsfixer: curl -fsL https://iobroker.net/fix.sh | bash -

      arteckA 1 Antwort Letzte Antwort
      0
      • HomoranH Homoran

        @arteck sagte:

        alles Adapter spezfifische landet im iobroker-data verzeichniss

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

        arteckA Offline
        arteckA Offline
        arteck
        Developer Most Active
        schrieb am zuletzt editiert von
        #23

        @Homoran sagte:

        Da ist doch dann files die nächste Ebene

        und

        rate was da nicht steht

        zigbee hab ich, zwave auch, nuc's genauso und HA auch

        1 Antwort Letzte Antwort
        0
        • arteckA 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

          09960e43-0a19-4968-b169-0039337b066f-image.jpeg

          crunchipC Abwesend
          crunchipC Abwesend
          crunchip
          Forum Testing Most Active Developer
          schrieb am zuletzt editiert von
          #24

          @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.

          umgestiegen von Proxmox auf Unraid

          1 Antwort Letzte Antwort
          0
          • sigi234S 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.

            crunchipC Abwesend
            crunchipC Abwesend
            crunchip
            Forum Testing Most Active Developer
            schrieb am zuletzt editiert von
            #25

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

            umgestiegen von Proxmox auf Unraid

            sigi234S 1 Antwort Letzte Antwort
            0
            • crunchipC crunchip

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

              sigi234S Online
              sigi234S Online
              sigi234
              Forum Testing Most Active
              schrieb am zuletzt editiert von sigi234
              #26

              @crunchip sagte:

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

              Screenshot (1483).png Screenshot (1482).png

              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?

              Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
              Immer Daten sichern!

              crunchipC 1 Antwort Letzte Antwort
              0
              • sigi234S sigi234

                @crunchip sagte:

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

                Screenshot (1483).png Screenshot (1482).png

                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?

                crunchipC Abwesend
                crunchipC Abwesend
                crunchip
                Forum Testing Most Active Developer
                schrieb am zuletzt editiert von crunchip
                #27

                @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
                

                umgestiegen von Proxmox auf Unraid

                1 Antwort Letzte Antwort
                1
                • arteckA 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

                  09960e43-0a19-4968-b169-0039337b066f-image.jpeg

                  crunchipC Abwesend
                  crunchipC Abwesend
                  crunchip
                  Forum Testing Most Active Developer
                  schrieb am zuletzt editiert von
                  #28

                  @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?

                  umgestiegen von Proxmox auf Unraid

                  1 Antwort Letzte Antwort
                  0
                  • arteckA Offline
                    arteckA Offline
                    arteck
                    Developer Most Active
                    schrieb zuletzt editiert von arteck
                    #29

                    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

                    zigbee hab ich, zwave auch, nuc's genauso und HA auch

                    crunchipC 1 Antwort Letzte Antwort
                    2
                    • arteckA 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

                      crunchipC Abwesend
                      crunchipC Abwesend
                      crunchip
                      Forum Testing Most Active Developer
                      schrieb zuletzt editiert von
                      #30

                      @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.

                      umgestiegen von Proxmox auf Unraid

                      1 Antwort Letzte Antwort
                      0

                      Hey! Du scheinst an dieser Unterhaltung interessiert zu sein, hast aber noch kein Konto.

                      Hast du es satt, bei jedem Besuch durch die gleichen Beiträge zu scrollen? Wenn du dich für ein Konto anmeldest, kommst du immer genau dorthin zurück, wo du zuvor warst, und kannst dich über neue Antworten benachrichtigen lassen (entweder per E-Mail oder Push-Benachrichtigung). Du kannst auch Lesezeichen speichern und Beiträge positiv bewerten, um anderen Community-Mitgliedern deine Wertschätzung zu zeigen.

                      Mit deinem Input könnte dieser Beitrag noch besser werden 💗

                      Registrieren Anmelden
                      Antworten
                      • In einem neuen Thema antworten
                      Anmelden zum Antworten
                      • Älteste zuerst
                      • Neuste zuerst
                      • Meiste Stimmen


                      Support us

                      ioBroker
                      Community Adapters
                      Donate

                      394

                      Online

                      32.8k

                      Benutzer

                      82.7k

                      Themen

                      1.3m

                      Beiträge
                      Community
                      Impressum | Datenschutz-Bestimmungen | Nutzungsbedingungen | Einwilligungseinstellungen
                      ioBroker Community 2014-2025
                      logo
                      • Anmelden

                      • Du hast noch kein Konto? Registrieren

                      • Anmelden oder registrieren, um zu suchen
                      • Erster Beitrag
                        Letzter Beitrag
                      0
                      • Home
                      • Aktuell
                      • Tags
                      • Ungelesen 0
                      • Kategorien
                      • Unreplied
                      • Beliebt
                      • GitHub
                      • Docu
                      • Hilfe