Home Assistant Dokumentation

Ich hätte gerne die gesamte Home Assistant Dokumentation als ein pdf Gesamtdokument. Es sollen alle Unterseiten ausgegeben werden. Gibt es diese Dokumentation irgendwo zum Download?

Macht meines Erachtens nicht viel Sinn da viel zu dynamisch, in 4 Wochen vieles schon nicht mehr aktuell!

Kennst du das . Gibt es als Ebook und wird auch regelmäßig aktualisiert?

Da gilt aber auch meine Aussage von oben! :wink:

1 „Gefällt mir“

Für welchen Zweck soll das sein? Nur für eine Offline-Nutzung oder willst du es ausdrucken?

Ansonsten bin ich auch der Meinung, dass das wegen der fehlenden Aktualität nur mäßig sinnvoll erscheint :slight_smile:

1 „Gefällt mir“

Ich stimme Dr.Big zu.
Die Doku ist ein ziemlich „dickes Brett“, dessen Inhalt sich relativ häufig verändert bzw. aktualisiert.
Evtl. wäre es ein Weg, das folgende Script regelmäßig laufen zu lassen, um dadurch die PDF-Datei „auf dem Laufenden“ zu halten.

Das Script ist nicht von mir und ich habe es auch nicht getestet.
Aber vor dem Hintergrund deiner Frage sieht es interessant aus.

Vor dem Download auf Windows mindestens 5 GB freien Speicherplatz einplanen.

@echo off
title Home Assistant Gesamtdokumentation als PDF
color 0B

:: =========================================================
:: HOME ASSISTANT DOKU → EIN GROSSES PDF
:: =========================================================
:: Dieses Skript:
:: 1. Spiegelt die Home Assistant Doku lokal
:: 2. Sammelt alle HTML-Seiten
:: 3. Baut daraus EIN Gesamt-PDF
::
:: Voraussetzungen:
:: - wget.exe
:: - wkhtmltopdf.exe
::
:: Installation:
:: wget:
:: https://eternallybored.org/misc/wget/
::
:: wkhtmltopdf:
:: https://wkhtmltopdf.org/downloads.html
::
:: wget.exe + wkhtmltopdf.exe entweder:
:: - im gleichen Ordner wie dieses Skript
:: ODER
:: - im PATH
:: =========================================================

setlocal enabledelayedexpansion

:: Zielordner
set TARGET=%USERPROFILE%\Desktop\HA_Doku_PDF
set SITE=%TARGET%\site
set PDF=%USERPROFILE%\Desktop\Home_Assistant_Gesamtdokumentation.pdf
set LIST=%TARGET%\html_list.txt

echo.
echo ===============================================
echo   Home Assistant Doku wird heruntergeladen...
echo ===============================================
echo.

if not exist "%TARGET%" mkdir "%TARGET%"
if not exist "%SITE%" mkdir "%SITE%"

cd /d "%SITE%"

:: ---------------------------------------------------------
:: Doku spiegeln (nur docs + integrations für Vollversion)
:: ---------------------------------------------------------
wget ^
 --mirror ^
 --convert-links ^
 --adjust-extension ^
 --page-requisites ^
 --no-parent ^
 --domains home-assistant.io ^
 https://www.home-assistant.io/docs/ ^
 https://www.home-assistant.io/integrations/

echo.
echo ===============================================
echo   HTML-Dateiliste wird erstellt...
echo ===============================================
echo.

:: HTML-Dateien sammeln
if exist "%LIST%" del "%LIST%"

for /r %%F in (*.html) do (
    echo file:///%%F>>"%LIST%"
)

echo.
echo ===============================================
echo   PDF wird erstellt...
echo   Dies kann je nach Umfang lange dauern...
echo ===============================================
echo.

:: ---------------------------------------------------------
:: wkhtmltopdf erzeugt EIN Gesamt-PDF
:: ---------------------------------------------------------
wkhtmltopdf ^
 --enable-local-file-access ^
 --javascript-delay 1000 ^
 --load-error-handling ignore ^
 --load-media-error-handling ignore ^
 --footer-center "[page]/[topage]" ^
 --footer-font-size 8 ^
 --margin-top 15mm ^
 --margin-bottom 15mm ^
 --margin-left 10mm ^
 --margin-right 10mm ^
 --book ^
 --read-args-from-stdin ^
 "%PDF%" < "%LIST%"

echo.
echo ===============================================
echo FERTIG!
echo PDF gespeichert unter:
echo %PDF%
echo ===============================================
echo.

if exist "%PDF%" start "" "%PDF%"

pause

Ich teste gerade eine lokale KI mit dem Thema Coding. Ich beabsichtige die Dokumentation als Wissensdatenbank zur Verfügung zu stellen.

Ah, cool! Dafür muss ja auch nicht immer die neuste Version da sein. Das könntest du dann mit einem Script, wie von @Schorsch vorgeschlagen, wahrscheinlich ganz gut lösen!

Ich weiß ja nicht wofür die KI sein soll, aber vielleicht wäre eine Internet-Research-Einbindung auch eine gute Sache? Also dass die lokale KI statt auf das riesige PDF Dokument zuzugreifen, direkt eine Websuche startet, wo ja dann auch die Doku auftaucht.

Dann muss es ja nicht zwingend pdf sein, spiegel dir doch einfach die entsprechende(n) Webseiten lokal!? Aller paar Tage mal aktualisieren lassen und gut ist!

1 „Gefällt mir“

Es soll eine spezielle lokale Home Assistant KI werden, die auf alle für Home Assistant wichtigen Programmiersprachen und Dokumentationen zugreifen kann.

Da kann dir Jan @jayjojayson sicher Tipps geben, den er hat sich so was in der Art aufgebaut mit einem eigenen Wiki die in der Ki eingebunden ist!

Hi, so eine KI für HA gibt es schon mehrfach inzwischen. Ich selber habe auch eine Integration erstellt, die auch mit lokaler KI arbeiten kann. Der HAcoBot hat dann vollen Systemzugriff, wenn man es in den Integrationseinstellungen zulässt. Ich bin nur immer noch nicht dazu gekommen, es vorzustellen und weiter auszubauen. Er kann Automatisierungen bauen, Blueprints erstellen, komplette Dashboards erstellen, HA Backup/Update ausführen, HA neustarten usw.

Ansonsten habe ich der KI einfach gerade mal die Aufgabe gestellt. 15min hat sie gebraucht eine kombinierte Ausgabe als MD Datei zu erstellen und das in eine PDF zu wandeln. Die md Datei könnte man also direkt wieder maschninell einlesen, ist im github hinterlegt und kann gerne genutzt werden.

Die PDF kann ich hier nicht hochladen, wegen der Größe von 11MB (5300 Seiten), habe sie daher ebenfalls mit ins github aufgenommen. Dort findest du auch das Script für die Erstellung sowie eine README zur Erklärung.

8 „Gefällt mir“

Danke. Ich werde mir die Daten laden.