OCDL: Unterschied zwischen den Versionen

Zur Navigation springen Zur Suche springen
477 Bytes entfernt ,  27. Oktober 2012
Überflüssiges Windows-Zeug entfernt
(displaytitle wieder raus)
(Überflüssiges Windows-Zeug entfernt)
Zeile 1: Zeile 1:
'''OCDL''' ('''O'''pen'''c'''aching '''D'''own'''l'''oader) ist ein [[wikipedia:Python_(Programmiersprache)|Python]]-Skript zum komfortablen Download von [[Suchformular#Gespeicherte Suche|gespeicherten Suchen]] als [[GPX-Datei|GPX-Dateien]]. OCDL ist besonders dann nützlich, wenn man regelmäßig gespeicherte Suchen herunterladen möchte, beispielsweise um die Cache-Datenbank von [[OpenCacheManager]] auf einem aktuellen Stand zu halten.
'''OCDL''' ('''O'''pen'''c'''aching '''D'''own'''l'''oader) ist ein [[wikipedia:Python_(Programmiersprache)|Python]]-Skript zum komfortablen Download von [[Suchformular#Gespeicherte Suche|gespeicherten Suchen]] als [[GPX-Datei|GPX-Dateien]]. OCDL ist besonders dann nützlich, wenn man regelmäßig gespeicherte Suchen herunterladen möchte, beispielsweise um die Cache-Datenbank von [[OpenCacheManager]] auf einem aktuellen Stand zu halten.


== OCDL auf Unix-artigen Systemen (Linux, BSD, Mac OS, usw.) ==
== Systemvoraussetzungen ==
Um OCDL nutzen zu können, muss natürlich eine aktuelle Version von Python auf dem System vorhanden sein; typische Unixe bringen Python bereits mit.
OCDL ist ein plattformübergreifendes Python-Skript und sollte auf allen Systemen lauffähig sein, auf denen eine aktuelle Python-Version installiert ist.
Typische Unixe bringen Python bereits mit; unter Windows ist meist eine manuelle Installation von Python notwendig (z.B. [http://www.activestate.com/activepython ActivePython]).


=== Allgemein ===
== Allgemein ==
OCDL ist ein Kommandozeilenprogramm und wird daher innerhalb der Kommandozeile (Linux/Unix: Terminalfenster, Windows: Eingabeaufforderung) verwendet.
Wie für Kommandozeilenprogramme üblich, verfügt OCDL über eine integrierte Hilfsfunktion, die über den Kommandozeilenparameter <tt>--help</tt> aufgerufen werden kann:
Wie für Kommandozeilenprogramme üblich, verfügt OCDL über eine integrierte Hilfsfunktion, die über den Kommandozeilenparameter <tt>--help</tt> aufgerufen werden kann:
<pre>
<pre>
Zeile 51: Zeile 53:




=== Konfiguration ===
== Konfiguration ==
OCDL hat eine Setup-Funktion, die die notwendigen Verzeichnisse anlegt und den Nutzer nach seinen Zugangsdaten für Opencaching.de fragt. Dazu ruft man OCDL mit dem Parameter <tt>--setup</tt> auf und gibt seine Zugangsdaten ein:
OCDL hat eine Setup-Funktion, die die notwendigen Verzeichnisse anlegt und den Nutzer nach seinen Zugangsdaten für Opencaching.de fragt. Dazu ruft man OCDL mit dem Parameter <tt>--setup</tt> auf und gibt seine Zugangsdaten ein:
<pre>
<pre>
Zeile 62: Zeile 64:
Danach ist OCDL fertig konfiguriert und kann normal verwendet werden. Falls sich die Zugangsdaten ändern sollten, kann die Setup-Funktion jederzeit wieder aufgerufen werden.
Danach ist OCDL fertig konfiguriert und kann normal verwendet werden. Falls sich die Zugangsdaten ändern sollten, kann die Setup-Funktion jederzeit wieder aufgerufen werden.


=== Verfügbare gespeicherte Suchen auslesen ===
== Verfügbare gespeicherte Suchen auslesen ==
Mit dem Kommandozeilenparameter <tt>--list</tt> wird die Liste der online verfügbaren gespeicherten Suchen abgefragt und ausgegeben:
Mit dem Kommandozeilenparameter <tt>--list</tt> wird die Liste der online verfügbaren gespeicherten Suchen abgefragt und ausgegeben:
<pre>
<pre>
Zeile 71: Zeile 73:
In obigem Beispiel sind zwei Suchen verfügbar, nämlich "Tradis Berlin" mit der ID "11339629" und "OC-only Deutschland" mit der ID "42325999". Die ID-Werte sind wichtig für den Download der Suchen.
In obigem Beispiel sind zwei Suchen verfügbar, nämlich "Tradis Berlin" mit der ID "11339629" und "OC-only Deutschland" mit der ID "42325999". Die ID-Werte sind wichtig für den Download der Suchen.


=== Download der Suchen ===
== Download der Suchen ==
Hat man festgestellt, welche Suchen überhaupt verfügbar sind, kann man diese auch herunterladen. Dazu gibt man die entsprechende ID als Parameter an OCDL.  
Hat man festgestellt, welche Suchen überhaupt verfügbar sind, kann man diese auch herunterladen. Dazu gibt man die entsprechende ID als Parameter an OCDL.  


Zeile 86: Zeile 88:
* <tt>--name NAME</tt> erzeugt Dateien nach dem Schema '''Name.zip''', wobei '''Name''' der Name der gespeicherten Suche ist; Leerzeichen im Name werden dabei durch Unterstriche ersetzt; im Beispiel: '''OC-only_Deutschland.zip'''
* <tt>--name NAME</tt> erzeugt Dateien nach dem Schema '''Name.zip''', wobei '''Name''' der Name der gespeicherten Suche ist; Leerzeichen im Name werden dabei durch Unterstriche ersetzt; im Beispiel: '''OC-only_Deutschland.zip'''
* <tt>--name NAME+DATE</tt> erzeugt Dateien nach dem Schema '''Name_Datum.zip'''; im Beispiel: '''OC-only_Deutschland_2012-10-26.zip'''
* <tt>--name NAME+DATE</tt> erzeugt Dateien nach dem Schema '''Name_Datum.zip'''; im Beispiel: '''OC-only_Deutschland_2012-10-26.zip'''
== OCDL unter Windows ==
Unter Windows muss zunächst Python installiert werden, da es nicht zum Lieferumfang gehört. Hier bietet sich z.B. [http://www.activestate.com/activepython ActivePython] an. Im Folgenden wird davon ausgegangen, dass Python ins Verzeichnis <tt>C:\Python27</tt> installiert wurde.
Als erster Schritt muss die Datei '''ocdl.py''' an die installierte Python-Version angepasst werden. Dazu öffnet man die Datei mit einem Texteditor und ersetzt die erste Zeile durch
<pre>
#!C:\Python27\python.exe
</pre>
Als nächstes wird OCDL über die Setup-Funktion eingerichtet. Dazu öffnet man die '''Eingabeaufforderung''', wechselt ins OCDL-Verzeichnis und ruft OCDL mit <tt>ocdl.py --setup</tt> auf und folgt den Anweisungen.
Jetzt sollte '''ocdl.py''' wie im Abschnitt '''OCDL auf Unix-artigen Systemen''' benutzbar sein.


== Weblinks ==
== Weblinks ==
* [https://github.com/flopp/ocdl.py Download bei github.com]
* [https://raw.github.com/flopp/ocdl.py/master/ocdl.py Direkt-Download von OCDL]
* [https://github.com/flopp/ocdl.py OCDL bei github.com]
* [http://www.python.org/ Python]
* [http://www.python.org/ Python]


[[Kategorie:Geocaching-Software]]
[[Kategorie:Geocaching-Software]]
[[Kategorie:Opencaching]]
[[Kategorie:Opencaching]]
214

Bearbeitungen

Navigationsmenü