RSS: Unterschied zwischen den Versionen

Aus FHEMWiki
(Erste Version)
 
K (Hinweis auf rssFeed eingefügt)
 
(7 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Infobox Modul
{{Infobox Modul
|ModPurpose=Erstellen von RSS Feeds und Grafiken
|ModPurpose=Erstellen von RSS Feeds und Grafiken
|ModType=Modul
|ModType=h
<!-- |ModCategory= (noch?) nicht verwendet -->
|ModForumArea=Frontends/RSS
<!-- |ModCmdRef=  wird automatisch generiert -->
|ModTechName=02_RSS.pm
|ModTechName=02_RSS.pm
|ModOwner=Dr. Boris Neubert
|ModOwner=Dr. Boris Neubert ({{Link2FU|10|Forum}}/[[Benutzer Diskussion:Neubert|Wiki]])
}}
}}


'''02_RSS.pm''' Dieses Modul dient zum Erstellen von sog. RSS Feeds und auch evt. dazugehörigen Bildern.
Das Modul [[RSS]] stellt einen Media Feed, z.&nbsp;B. ein Statusbild zur Anzeige an einem elektronischen Bilderrahmen, zur Verfügung. Das Modul ist eine Erweiterung zu [[PGM2|FHEMWEB]] und setzt daher die Benutzung von FHEMWEB voraus.
[[Datei:17966931jv.jpg|400px|thumb|right]]


Als Bildformat wird JPEG und PNG unterstützt.


== Zielsetzung ==
''Anmerkung'': das Modul [[rssFeed]] extrahiert Daten aus einem RSS Feed hat, damit üblicherweise eine andere Zielgruppe und ist auf einer eigenen Seite beschrieben.
Dieser Artikel beschreibt die Installation sowie die Grundkonfiguration anhand einiger Beispiele.
Das Modul stellt einen "echten" RSS Feed bereit, der als einzigen Inhalt eine JPEG/PNG Datei in sich trägt.
Dieser kann z.B. von Tablets, WLAN Bilderrahmen usw. angezeigt werden.
Er entstand aus einem Workshop im Fhem Forum [http://forum.fhem.de/index.php/topic,22520.0.html Link].


== Abgrenzung ==
== Beispielanwendung ==
Die Installation auf !FritzBoxen ist zwar grundsätzlich möglich, wird hier aber nicht weiter beschrieben.
[[Datei:17966931jv.jpg|300px|thumb|right|Beispiel (aus dem Workshop) eines mit dem RSS-Modul erstellten Vollbilds]]
 
Im FHEM-Forum wird in diesem {{Link2Forum|Topic=22520|LinkText=Workshop}} Schritt für Schritt beschrieben, wie das RSS Modul verwendet werden kann, um eine Übersichtsseite, z.&nbsp;B. für die Anzeige auf einem Tablet, erstellt werden kann.
== Installation ==
Diese Beschreibung setzt ein Debian-basiertes Linux System voraus.
Die folgenden Pakete müssen, zum Beispiel mittels des Paket Verwaltungsprogramm ''apt'' installiert werden um
das Modul nutzen zu können.
 
''Debian GNU/Linux 6.0''
 
* libgd-graph-perl - zwingend!
* libgd-text-perl - optional, aber dringend empfohlen
* libimage-librsvg-perl - optional, aber dringend empfohlen
* libxml-simple-perl - optional
* mscorefonts - optional
 
Der folgende Befehlsaufruf installiert die ersten vier Pakete:
<pre>sudo apt-get install libgd-graph-perl libgd-text-perl libimage-librsvg-perl libxml-simple-perl</pre>
 
== Installation des Pakets msttcorefonts ==
Im Standard Debian ist dieses Paket nicht über den Paketmanager installierbar.
Es gibt aber ein DEB-Paket mit dessen Hilfe es installiert werden kann. Vorher ist allerdings
die Installation des Paket ''cabextract'' erforderlich.
Folgender Befehl installiert das genannte Paket:
 
<pre>sudo apt-get install cabextract</pre>
 
Nun kann das DEB-Paket heruntergeladen und installiert werden.
 
<pre>wget http://ftp.de.debian.org/debian/pool/contrib/m/msttcorefonts/ttf-mscorefonts-installer_3.4+nmu1_all.deb</pre>
 
Installiert wird es mit dem folgenden Befehlsaufruf:
 
<pre>sudo dpkg -i ttf-mscorefonts-installer_3.4+nmu1_all.deb</pre>
 
 
== Definition des Devices in fhem ==
[[Datei:RSS_device_example.png|100px|thumb|right]]
[[Datei:Rss_menu_entry.png|100px|thumb|right]]
<pre>define myrss RSS jpg <IP> ./FHEM/rss.layout</pre>
 
Beispiel:
<pre>define myrss RSS jpg 192.168.1.20 ./FHEM/rss.layout</pre>
 
== Erstellen der Datei rss.layout ==
 
Nach der erfolgreichen Definition befindet sich auf der linken Seite im Hauptmenü ein neuer Eintrag mit dem Namen '''RSS'''.
 
Nun müssen die in der Definition benutzte Datei '''rss.layout''' erzeugen. Dies kann man entweder direkt auf der Shell erledigen oder
mit dem FHEMWeb Frontend. Klickt dazu im linken Menü auf '''Edit files'''.
WICHTIG: Nicht auf '''Save''' drücken, da sonst die Originaldatei überschrieben werden würde.
Danach eine beliebige Datei selektieren und den Inhalt
mit STRG-A und ENTF löschen. Nun den Dateinamen rss.layout im rechten Textfeld eingeben und '''Save as''' drücken.
 
 
 
== ''"Hello World"'' erstellen ==
Unter '''Edit files''' die zuvor erstellte Datei rss.layout zum editieren selektieren und folgenden Text eingeben;
 
<pre>text 100 100 "Hallo, ich bin dein RSS!"</pre>
 
'''Wichtig: Nach jeder Änderung muss das Bild neu erstellt werden. Das wird durch den folgenden Befehl veranlasst:'''
<pre>set myrss rereadcfg</pre>
 
Unter dem folgenden Beispiel Link wird nun das Bild sichtbar:
 
<pre>http://192.168.1.20:8083/fhem/rss/myrss.jpg</pre>
 
Bildschirmfoto:
[[Datei:Rss_hello_world.png|800px|left]]
 
 
'''TO BE CONTINUED'''


== Links ==
== Links ==
* Thread über das Modul im [http://forum.fhem.de/index.php/topic,22520.0.html Workshop im Fhem Forum]
* RSS Workshop im Forum:
* Diskussions-Thread über den vorher genannten Workshop [http://forum.fhem.de/index.php/topic,22519.0.html Diskussion über den Workshop im Fhem Forum]
** {{Link2Forum|Topic=22520|LinkText=Workshop}}
** {{Link2Forum|Topic=22519|LinkText=Diskussion}}
** {{Link2Forum|Topic=22630|LinkText=Ergebnisse}} (was haben Benutzer aus diesem Workshop gemacht)


[[Kategorie:Code Snippets]]
[[Kategorie:Code Snippets]]

Aktuelle Version vom 15. Januar 2019, 12:11 Uhr

RSS
Zweck / Funktion
Erstellen von RSS Feeds und Grafiken
Allgemein
Typ Hilfsmodul
Details
Dokumentation EN / DE
Support (Forum) Frontends/RSS
Modulname 02_RSS.pm
Ersteller Dr. Boris Neubert (Forum /Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


Das Modul RSS stellt einen Media Feed, z. B. ein Statusbild zur Anzeige an einem elektronischen Bilderrahmen, zur Verfügung. Das Modul ist eine Erweiterung zu FHEMWEB und setzt daher die Benutzung von FHEMWEB voraus.

Als Bildformat wird JPEG und PNG unterstützt.

Anmerkung: das Modul rssFeed extrahiert Daten aus einem RSS Feed hat, damit üblicherweise eine andere Zielgruppe und ist auf einer eigenen Seite beschrieben.

Beispielanwendung

Beispiel (aus dem Workshop) eines mit dem RSS-Modul erstellten Vollbilds

Im FHEM-Forum wird in diesem Workshop Schritt für Schritt beschrieben, wie das RSS Modul verwendet werden kann, um eine Übersichtsseite, z. B. für die Anzeige auf einem Tablet, erstellt werden kann.

Links