Wikipedia Plugin
----------------

Autor:    barabas (IHAD) fr die Dreambox
          portiert auf Dbox2 von SnowHead (New-Tuxwetter-Team)
          angepasst Anonymisierung von SnowHead (New-Tuxwetter-Team)
          angepasst an Yjogol Webserver 3.1.3 von DrStoned
Version:  1.5
Datum:    09.01.2009


Zweck des Plugins:
------------------

Das Plugin dient zur Suche von Begriffen im Wikipedia mit der Dbox2.
Dabei werden die zu suchenden Begriffe vom Wikipedia-Internetserver geholt.
So kann man zum Beispiel bei einer Quizsendung wie 'Wer wird Millionr', kurz 
mal an der Glotze nach der Lsung suchen, sofern sie im Wikipedia richtig 
reingestellt wurde.


Vorraussetzungen:
-----------------

Zur Dateneingabe wird das Input-Plugin, zur Datenausgabe wird das New-Tuxwetter-
Plugin bentigt. Diese Plugins sind nicht im Archiv enthalten und mssen extra
runtergeladen und installiert werden. Ausserdem wird zur Fehlerausgabe noch die 
Messagebox bentigt, die aber im aktuellen JtG-Image seit Ende August 2006 
enthalten ist.
Optional kann auch das Flexmen (shellexec) fr den Aufruf verwendet werden.

Diese zustzlichen Plugins knnen alle im JtG-Plugin Forum herunterladen werden.

Ausserdem mu die Box unbedingt ber einen Internetzugang verfgen.


Installation:
-------------

Die folgenden Dateien sind per FTP im BINR-Modus auf die Box in die entsprechenden
Verzeichnisse zu bertragen, und die Rechte so zu vergeben, wie sie angegeben sind.

Dieser Hinweis gilt besonders fr Benutzer des FTP-Programms Filezilla.
-----------------------------------------------------------------------


Bentigte Dateien:
------------------

Datei                   Verzeichnis auf Dbox            Rechte      im Archiv   unbedingt bentigt
-------------------------------------------------------------------------------------------------------------------------
wiki.cfg                /var/tuxbox/plugins/            644         ja          optional
wiki.so                 /var/tuxbox/plugins/            755         ja          optional
wiki                    /var/plugins/                   755         ja          optional
wiki.sh                 /var/plugins/                   755         ja          ja
input                   /var/bin/                       755         nein        ja
msgbox                  /var/bin/                       755         nein        im aktuellen JtG-Image in /bin/ enthalten
tuxwetter.cfg           /var/tuxbox/plugins/            644         nein        ja
tuxwetter.so            /var/tuxbox/plugins/            755         nein        ja
tuxwetter               /var/tuxbox/plugins/tuxwet/     755         nein        ja
convert.list            /var/tuxbox/plugins/tuxwet/     644         nein        ja
tuxwetter.conf          /var/tuxbox/plugins/tuxwet/     644         nein        ja
bmps.tar.Z              /var/tuxbox/plugins/tuxwet/     644         nein        ja
swisstime               /var/tuxbox/plugins/tuxwet/     755         nein        ja
shellexec               /var/plugins/                   755         nein        optional
shellexec.conf          /var/tuxbox/config/             644         nein        optional


Wer das Flexmenu installiert hat, bentigt die Dateien wiki.cfg, wiki.so und 
wiki nicht. Stattdessen ist in der Datei shellexec.conf in /var/tuxbox/config/
folgende Zeile einzufgen:

ACTION=&Wikipedia,(/var/plugins/wiki.sh)

Diese Eingabe mu mit einem Unix-Editor im Linux-Format gemacht werden.
-----------------------------------------------------------------------


Bedienung:
----------

Das Plugin kann, je nach Ausfhrung der Installation, sowohl ber die blaue Taste, 
als auch ber das Flexmen aufgerufen werden. Nach dem Starten erscheint eine 
Eingabebox, in die der zu suchende Begriff eingeben wird.  Bei der Suche nach 
mehreren Wrtern sind Leerzeichen durch '+' zu ersetzen. Dann die OK-Taste drcken. 
Der Begriff wird jetzt auf dem Wikipedia-Server im Internet gesucht, und dann ber 
das Tuxwetter-Plugin auf dem Bildschirm angezeigt, mit Pfeil-Rechts wird im Text 
nach unten gescrollt, mit Pfeil-Links nach oben.  Home oder OK springt zurck ins 
Eingabefenster. Jetzt kann ein neuer Begriff gesucht werden oder das Plugin mit
der Home-Taste verlassen werden. 
Sollte der gesuchte Begriff nicht gefunden werden, wird dies mit einer Meldung 
ebenfalls angezeigt, die entweder mit Home oder Ok verlassen werden kann und 
dann zurck in die Eingabebox springt. Sollte der Server nicht gefunden werden, 
wird eine Fehlermeldung in einer Messagebox angezeigt. 


Zum Schluss noch ein Tip:
-------------------------

Gebt mal 'd-box' ein und schaut wo Ihr da landest. ;-)

Credits:
--------

Vielen Dank an barabas vom IHAD fr die Erstellung des Skripts fr die Dreambox.
Ebenfalls Danke an SnowHead vom New-Tuxwetter-Team fr die Portierung auf die 
Dbox2 und an robspr1 fr die Hilfe bei der Anpassung an den neuen Yjogol 
Webserver 3.1.3, damit das Plugin auch auf den neuesten Neutrino Images luft.

Viel Spa mit dem Wiki-Pedia Plugin wnscht Euch DrStoned :-) :-) :-)