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

  • Neues YouTube-Video: Visualisierung im Devices-Adapter
    BluefoxB
    Bluefox
    14
    1
    2.4k

  • Neuer ioBroker-Blog online: Monatsrückblick März/April 2026
    BluefoxB
    Bluefox
    8
    1
    2.7k

  • Verwendung von KI bitte immer deutlich kennzeichnen
    HomoranH
    Homoran
    11
    1
    1.6k

Test Adapter autodoc

Geplant Angeheftet Gesperrt Verschoben ...nicht in offiziellem Repo
testadapterollamadoku
48 Beiträge 7 Kommentatoren 2.1k Aufrufe 11 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 Abwesend
    crunchipC Abwesend
    crunchip
    Forum Testing Most Active Developer
    schrieb am zuletzt editiert von crunchip
    #2

    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.
      58cc0080-ef01-4333-93d7-389fa396a83f-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.
      4744810f-22aa-4513-b46c-f3b69929d133-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).
      ecbfb0f6-ba9a-4071-bdf8-1ce01b295d9f-image.jpeg

    • HTML-Export/PDF
      e00e3b35-0522-41fa-be56-51360c69f521-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.

    umgestiegen von Proxmox auf Unraid

    sigi234S arteckA 2 Antworten Letzte Antwort
    1
    • 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.
        58cc0080-ef01-4333-93d7-389fa396a83f-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.
        4744810f-22aa-4513-b46c-f3b69929d133-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).
        ecbfb0f6-ba9a-4071-bdf8-1ce01b295d9f-image.jpeg

      • HTML-Export/PDF
        e00e3b35-0522-41fa-be56-51360c69f521-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.

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

      @crunchip sagte:

      wenn die Basis-URL passt.

      Muss ich die unter Windows extra angeben?

      Screenshot (1475).png

      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:

        wenn die Basis-URL passt.

        Muss ich die unter Windows extra angeben?

        Screenshot (1475).png

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

        @sigi234 was meinst du mit extra angeben?
        Eigentlich deine iobroker ip:port
        In meinem Fall 10.1.1.111:8081

        umgestiegen von Proxmox auf Unraid

        sigi234S 1 Antwort Letzte Antwort
        0
        • crunchipC crunchip

          @sigi234 was meinst du mit extra angeben?
          Eigentlich deine iobroker ip:port
          In meinem Fall 10.1.1.111:8081

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

          @crunchip sagte:

          @sigi234 was meinst du mit extra angeben?
          Eigentlich deine iobroker ip:port
          In meinem Fall 10.1.1.111:8081

          Ja läuft jetzt . IOB läuft bei mir unter Win ja local.

          http://localhost:8091

          Screenshot (1476).png

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

          1 Antwort Letzte Antwort
          1
          • crunchipC crunchip

            Hallo zusammen,

            ich stelle hier meinen Adapter ioBroker.autodoc vor — das ist mein erster Adapter für ioBroker; über konstruktives Feedback und Tipps freue ich mich sehr.

            Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.

            Was der Adapter heute schon kann

            Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente erzeugt, sowie PDF auf Wunsch — per Knopf oder automatisch (Start, Intervall, Änderungen an Adaptern). In einem Lauf entstehen drei Lesarten:

            • Admin — technischer Überblick (Adapter, Hosts, Skripte, Wartung, Aliase, eigene Datenpunkte, …)
            • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
            • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon

            Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.

            Aktuell liegt der Fokus auf stabiler Dokuerzeugung und guter Lesbarkeit der drei Profile.

            Seit Kurzem ist der Adapter auch als npm-Paket iobroker.autodoc installierbar (weiterhin alternativ per Git/URL).
            Aufnahme in die offizielle Adapterliste (repositories, latest): PR gestellt, Merge ausstehend


            Links

            • Repo: https://github.com/crunchip77/ioBroker.autodoc
            • npm: https://www.npmjs.com/package/iobroker.autodoc
            • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
            • Kurzanleitungen im Repo: User-Guide EN · Szenario DE (dort verlinkt)
            • Ausführlicher Verlauf: README — Changelog

            ioBroker.autodoc — Stand npm 0.9.44

            Kurz für euch: Wer per npm installiert oder aktualisiert, ist auf 0.9.44. Kein Handlungsbedarf — es ist keine Funktionsumstellung eurer bestehenden Konfiguration nötig.

            Was sich zuletzt „offiziell“ auf npm getan hat (ohne Technik-Details):

            • 0.9.44 — bessere Hilfen rund um die Kapitel‑JSON‑Felder plus Log‑Hinweise bei falschen oder doppelten Einträgen; kleine Anpassungen bei der Schnellstart‑Auswahl in den Exporten.“
            • 0.9.43 — Nur Hintergrund (Metadaten für ioBroker/npm-Regeln). Dokuerzeugung und Verhalten im Alltag bleiben wie bei 0.9.42.
            • 0.9.42 — Erstes npm-Update nach der zuletzt auf npm veröffentlichten 0.9.38. Wer von npm kommt, zieht damit in einem Rutsch die Zwischenentwicklung nach (u. a. Themen rund um Speicher/Export und Volltext unter /files/ — wer tiefer einsteigen will: README-Changelog).
            • 0.9.38 und davor — wie gehabt: lauffähige npm-Historie; 0.9.35 war das erste öffentliche npm-Paket.

            Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

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

            @crunchip

            Hallo,

            f18e2ecd-8835-4dd5-9c66-50b20fa2b38a-image.jpeg

            Ist im Dark Mode nicht zu lesen!

            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

              Hallo,

              f18e2ecd-8835-4dd5-9c66-50b20fa2b38a-image.jpeg

              Ist im Dark Mode nicht zu lesen!

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

              @sigi234 ok, guck mal durch ob noch weitere Felder dabei sind. Hatte bisher nur auf nem Testserver laufen, da ist nicht viel installiert, von daher nicht alles ausgefüllt.
              Korrigiere ich später

              umgestiegen von Proxmox auf Unraid

              sigi234S 1 Antwort Letzte Antwort
              0
              • crunchipC crunchip

                @sigi234 ok, guck mal durch ob noch weitere Felder dabei sind. Hatte bisher nur auf nem Testserver laufen, da ist nicht viel installiert, von daher nicht alles ausgefüllt.
                Korrigiere ich später

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

                @crunchip sagte:

                ok, guck mal durch ob noch weitere Felder dabei sind.

                Nein, nur diese.

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

                1 Antwort Letzte Antwort
                0
                • crunchipC crunchip

                  Hallo zusammen,

                  ich stelle hier meinen Adapter ioBroker.autodoc vor — das ist mein erster Adapter für ioBroker; über konstruktives Feedback und Tipps freue ich mich sehr.

                  Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.

                  Was der Adapter heute schon kann

                  Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente erzeugt, sowie PDF auf Wunsch — per Knopf oder automatisch (Start, Intervall, Änderungen an Adaptern). In einem Lauf entstehen drei Lesarten:

                  • Admin — technischer Überblick (Adapter, Hosts, Skripte, Wartung, Aliase, eigene Datenpunkte, …)
                  • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
                  • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon

                  Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.

                  Aktuell liegt der Fokus auf stabiler Dokuerzeugung und guter Lesbarkeit der drei Profile.

                  Seit Kurzem ist der Adapter auch als npm-Paket iobroker.autodoc installierbar (weiterhin alternativ per Git/URL).
                  Aufnahme in die offizielle Adapterliste (repositories, latest): PR gestellt, Merge ausstehend


                  Links

                  • Repo: https://github.com/crunchip77/ioBroker.autodoc
                  • npm: https://www.npmjs.com/package/iobroker.autodoc
                  • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
                  • Kurzanleitungen im Repo: User-Guide EN · Szenario DE (dort verlinkt)
                  • Ausführlicher Verlauf: README — Changelog

                  ioBroker.autodoc — Stand npm 0.9.44

                  Kurz für euch: Wer per npm installiert oder aktualisiert, ist auf 0.9.44. Kein Handlungsbedarf — es ist keine Funktionsumstellung eurer bestehenden Konfiguration nötig.

                  Was sich zuletzt „offiziell“ auf npm getan hat (ohne Technik-Details):

                  • 0.9.44 — bessere Hilfen rund um die Kapitel‑JSON‑Felder plus Log‑Hinweise bei falschen oder doppelten Einträgen; kleine Anpassungen bei der Schnellstart‑Auswahl in den Exporten.“
                  • 0.9.43 — Nur Hintergrund (Metadaten für ioBroker/npm-Regeln). Dokuerzeugung und Verhalten im Alltag bleiben wie bei 0.9.42.
                  • 0.9.42 — Erstes npm-Update nach der zuletzt auf npm veröffentlichten 0.9.38. Wer von npm kommt, zieht damit in einem Rutsch die Zwischenentwicklung nach (u. a. Themen rund um Speicher/Export und Volltext unter /files/ — wer tiefer einsteigen will: README-Changelog).
                  • 0.9.38 und davor — wie gehabt: lauffähige npm-Historie; 0.9.35 war das erste öffentliche npm-Paket.

                  Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

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

                  @crunchip

                  Hallo, habe da

                  Skripte ohne Beschreibung - Handlungsbedarf (338)

                  wo/wie soll ich die Beschreibung ändern?

                  Screenshot (1478).png

                  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

                    Hallo, habe da

                    Skripte ohne Beschreibung - Handlungsbedarf (338)

                    wo/wie soll ich die Beschreibung ändern?

                    Screenshot (1478).png

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

                    @sigi234 das sollte dazu dienen Beschreibungen aus den Scripten auszulesen, welche direkt im Script (common.desc) hinterlegt sind, weiterführend dann zu verarbeiten, was macht das Script.
                    edit
                    selbst gemerkt, das dies der falsche Ansatz war, muss ich mir was anderes überlegen

                    umgestiegen von Proxmox auf Unraid

                    1 Antwort Letzte Antwort
                    0
                    • crunchipC crunchip

                      Hallo zusammen,

                      ich stelle hier meinen Adapter ioBroker.autodoc vor — das ist mein erster Adapter für ioBroker; über konstruktives Feedback und Tipps freue ich mich sehr.

                      Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.

                      Was der Adapter heute schon kann

                      Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente erzeugt, sowie PDF auf Wunsch — per Knopf oder automatisch (Start, Intervall, Änderungen an Adaptern). In einem Lauf entstehen drei Lesarten:

                      • Admin — technischer Überblick (Adapter, Hosts, Skripte, Wartung, Aliase, eigene Datenpunkte, …)
                      • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
                      • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon

                      Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.

                      Aktuell liegt der Fokus auf stabiler Dokuerzeugung und guter Lesbarkeit der drei Profile.

                      Seit Kurzem ist der Adapter auch als npm-Paket iobroker.autodoc installierbar (weiterhin alternativ per Git/URL).
                      Aufnahme in die offizielle Adapterliste (repositories, latest): PR gestellt, Merge ausstehend


                      Links

                      • Repo: https://github.com/crunchip77/ioBroker.autodoc
                      • npm: https://www.npmjs.com/package/iobroker.autodoc
                      • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
                      • Kurzanleitungen im Repo: User-Guide EN · Szenario DE (dort verlinkt)
                      • Ausführlicher Verlauf: README — Changelog

                      ioBroker.autodoc — Stand npm 0.9.44

                      Kurz für euch: Wer per npm installiert oder aktualisiert, ist auf 0.9.44. Kein Handlungsbedarf — es ist keine Funktionsumstellung eurer bestehenden Konfiguration nötig.

                      Was sich zuletzt „offiziell“ auf npm getan hat (ohne Technik-Details):

                      • 0.9.44 — bessere Hilfen rund um die Kapitel‑JSON‑Felder plus Log‑Hinweise bei falschen oder doppelten Einträgen; kleine Anpassungen bei der Schnellstart‑Auswahl in den Exporten.“
                      • 0.9.43 — Nur Hintergrund (Metadaten für ioBroker/npm-Regeln). Dokuerzeugung und Verhalten im Alltag bleiben wie bei 0.9.42.
                      • 0.9.42 — Erstes npm-Update nach der zuletzt auf npm veröffentlichten 0.9.38. Wer von npm kommt, zieht damit in einem Rutsch die Zwischenentwicklung nach (u. a. Themen rund um Speicher/Export und Volltext unter /files/ — wer tiefer einsteigen will: README-Changelog).
                      • 0.9.38 und davor — wie gehabt: lauffähige npm-Historie; 0.9.35 war das erste öffentliche npm-Paket.

                      Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

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

                      @crunchip

                      Hallo, irgendwie fehlt mir in der Systemübersicht die NPM Version?

                      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

                        Hallo, irgendwie fehlt mir in der Systemübersicht die NPM Version?

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

                        @sigi234 sollte jetzt alles behoben sein

                        umgestiegen von Proxmox auf Unraid

                        sigi234S 1 Antwort Letzte Antwort
                        1
                        • U Offline
                          U Offline
                          UlliJ
                          schrieb am zuletzt editiert von
                          #13

                          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🤔

                          3a427022-4107-4c4e-b047-59838c9a223e-image.jpeg

                          Proxmox auf iNuc, lxc für IoB, InfluxDB2, Grafana, u.a. *** Homematic & Homematic IP, Shellies, Zigbee etc

                          crunchipC 2 Antworten Letzte Antwort
                          0
                          • crunchipC crunchip

                            @sigi234 sollte jetzt alles behoben sein

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

                            @crunchip sagte:

                            @sigi234 sollte jetzt alles behoben sein

                            Ja, Danke

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

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

                              3a427022-4107-4c4e-b047-59838c9a223e-image.jpeg

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

                              @UlliJ sagte:

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

                              Ja das fehlt bei mir noch ein wenig

                              umgestiegen von Proxmox auf Unraid

                              U 1 Antwort Letzte Antwort
                              0
                              • crunchipC crunchip

                                @UlliJ sagte:

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

                                Ja das fehlt bei mir noch ein wenig

                                U Offline
                                U Offline
                                UlliJ
                                schrieb am zuletzt editiert von
                                #16

                                @crunchip sagte:

                                Ja das fehlt bei mir noch ein wenig

                                mal quick & dirty auf Teile der Autodoku verlinkt
                                b59aae01-9386-4542-929d-f0ed35449b59-image.jpeg

                                Proxmox auf iNuc, lxc für IoB, InfluxDB2, Grafana, u.a. *** Homematic & Homematic IP, Shellies, Zigbee etc

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

                                  3a427022-4107-4c4e-b047-59838c9a223e-image.jpeg

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

                                  @UlliJ sagte:

                                  Die Kombi aus beidem wäre perfekt

                                  Ich hab mal mit auf die todo Liste gesetzt

                                  umgestiegen von Proxmox auf Unraid

                                  1 Antwort Letzte Antwort
                                  0
                                  • crunchipC crunchip

                                    Hallo zusammen,

                                    ich stelle hier meinen Adapter ioBroker.autodoc vor — das ist mein erster Adapter für ioBroker; über konstruktives Feedback und Tipps freue ich mich sehr.

                                    Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.

                                    Was der Adapter heute schon kann

                                    Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente erzeugt, sowie PDF auf Wunsch — per Knopf oder automatisch (Start, Intervall, Änderungen an Adaptern). In einem Lauf entstehen drei Lesarten:

                                    • Admin — technischer Überblick (Adapter, Hosts, Skripte, Wartung, Aliase, eigene Datenpunkte, …)
                                    • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
                                    • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon

                                    Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.

                                    Aktuell liegt der Fokus auf stabiler Dokuerzeugung und guter Lesbarkeit der drei Profile.

                                    Seit Kurzem ist der Adapter auch als npm-Paket iobroker.autodoc installierbar (weiterhin alternativ per Git/URL).
                                    Aufnahme in die offizielle Adapterliste (repositories, latest): PR gestellt, Merge ausstehend


                                    Links

                                    • Repo: https://github.com/crunchip77/ioBroker.autodoc
                                    • npm: https://www.npmjs.com/package/iobroker.autodoc
                                    • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
                                    • Kurzanleitungen im Repo: User-Guide EN · Szenario DE (dort verlinkt)
                                    • Ausführlicher Verlauf: README — Changelog

                                    ioBroker.autodoc — Stand npm 0.9.44

                                    Kurz für euch: Wer per npm installiert oder aktualisiert, ist auf 0.9.44. Kein Handlungsbedarf — es ist keine Funktionsumstellung eurer bestehenden Konfiguration nötig.

                                    Was sich zuletzt „offiziell“ auf npm getan hat (ohne Technik-Details):

                                    • 0.9.44 — bessere Hilfen rund um die Kapitel‑JSON‑Felder plus Log‑Hinweise bei falschen oder doppelten Einträgen; kleine Anpassungen bei der Schnellstart‑Auswahl in den Exporten.“
                                    • 0.9.43 — Nur Hintergrund (Metadaten für ioBroker/npm-Regeln). Dokuerzeugung und Verhalten im Alltag bleiben wie bei 0.9.42.
                                    • 0.9.42 — Erstes npm-Update nach der zuletzt auf npm veröffentlichten 0.9.38. Wer von npm kommt, zieht damit in einem Rutsch die Zwischenentwicklung nach (u. a. Themen rund um Speicher/Export und Volltext unter /files/ — wer tiefer einsteigen will: README-Changelog).
                                    • 0.9.38 und davor — wie gehabt: lauffähige npm-Historie; 0.9.35 war das erste öffentliche npm-Paket.

                                    Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

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

                                    @crunchip

                                    Hallo,

                                    wie sehe ich Live Werte?

                                    Screenshot (1479).png

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

                                    crunchipC 1 Antwort Letzte Antwort
                                    0
                                    • HomoranH Homoran verschob dieses Thema von Tester am
                                    • HomoranH Homoran verschob dieses Thema von ...nicht in offiziellem Repo am
                                    • HomoranH Homoran verschob dieses Thema von Tester am
                                    • sigi234S sigi234

                                      @crunchip

                                      Hallo,

                                      wie sehe ich Live Werte?

                                      Screenshot (1479).png

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

                                      @sigi234 sagte:

                                      Live Werte

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

                                      umgestiegen von Proxmox auf Unraid

                                      1 Antwort Letzte Antwort
                                      0
                                      • crunchipC crunchip

                                        Hallo zusammen,

                                        ich stelle hier meinen Adapter ioBroker.autodoc vor — das ist mein erster Adapter für ioBroker; über konstruktives Feedback und Tipps freue ich mich sehr.

                                        Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.

                                        Was der Adapter heute schon kann

                                        Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente erzeugt, sowie PDF auf Wunsch — per Knopf oder automatisch (Start, Intervall, Änderungen an Adaptern). In einem Lauf entstehen drei Lesarten:

                                        • Admin — technischer Überblick (Adapter, Hosts, Skripte, Wartung, Aliase, eigene Datenpunkte, …)
                                        • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
                                        • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon

                                        Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.

                                        Aktuell liegt der Fokus auf stabiler Dokuerzeugung und guter Lesbarkeit der drei Profile.

                                        Seit Kurzem ist der Adapter auch als npm-Paket iobroker.autodoc installierbar (weiterhin alternativ per Git/URL).
                                        Aufnahme in die offizielle Adapterliste (repositories, latest): PR gestellt, Merge ausstehend


                                        Links

                                        • Repo: https://github.com/crunchip77/ioBroker.autodoc
                                        • npm: https://www.npmjs.com/package/iobroker.autodoc
                                        • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
                                        • Kurzanleitungen im Repo: User-Guide EN · Szenario DE (dort verlinkt)
                                        • Ausführlicher Verlauf: README — Changelog

                                        ioBroker.autodoc — Stand npm 0.9.44

                                        Kurz für euch: Wer per npm installiert oder aktualisiert, ist auf 0.9.44. Kein Handlungsbedarf — es ist keine Funktionsumstellung eurer bestehenden Konfiguration nötig.

                                        Was sich zuletzt „offiziell“ auf npm getan hat (ohne Technik-Details):

                                        • 0.9.44 — bessere Hilfen rund um die Kapitel‑JSON‑Felder plus Log‑Hinweise bei falschen oder doppelten Einträgen; kleine Anpassungen bei der Schnellstart‑Auswahl in den Exporten.“
                                        • 0.9.43 — Nur Hintergrund (Metadaten für ioBroker/npm-Regeln). Dokuerzeugung und Verhalten im Alltag bleiben wie bei 0.9.42.
                                        • 0.9.42 — Erstes npm-Update nach der zuletzt auf npm veröffentlichten 0.9.38. Wer von npm kommt, zieht damit in einem Rutsch die Zwischenentwicklung nach (u. a. Themen rund um Speicher/Export und Volltext unter /files/ — wer tiefer einsteigen will: README-Changelog).
                                        • 0.9.38 und davor — wie gehabt: lauffähige npm-Historie; 0.9.35 war das erste öffentliche npm-Paket.

                                        Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

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

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

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

                                        crunchipC 1 Antwort Letzte Antwort
                                        0
                                        • 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.
                                            58cc0080-ef01-4333-93d7-389fa396a83f-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.
                                            4744810f-22aa-4513-b46c-f3b69929d133-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).
                                            ecbfb0f6-ba9a-4071-bdf8-1ce01b295d9f-image.jpeg

                                          • HTML-Export/PDF
                                            e00e3b35-0522-41fa-be56-51360c69f521-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

                                          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

                                          392

                                          Online

                                          32.9k

                                          Benutzer

                                          83.2k

                                          Themen

                                          1.3m

                                          Beiträge
                                          Community
                                          Impressum | Datenschutz-Bestimmungen | Nutzungsbedingungen | Einwilligungseinstellungen
                                          ioBroker Community 2014-2026
                                          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