OCDL: Unterschied zwischen den Versionen
Überflüssiges Windows-Zeug entfernt
(displaytitle wieder raus) |
Flopp (Diskussion | Beiträge) (Ü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. | ||
== | == Systemvoraussetzungen == | ||
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 == | |||
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 == | |||
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 == | |||
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 == | |||
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''' | ||
== 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]] | ||