OCDL: Unterschied zwischen den Versionen

OCDL (Quelltext anzeigen)

Version vom 26. Oktober 2012, 18:43 Uhr

837 Bytes hinzugefügt , 26. Oktober 2012

keine Bearbeitungszusammenfassung

Flopp

214

Bearbeitungen

@@ 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 unter Linux ==
+== OCDL auf Unix-artigen Systemen (Linux, BSD, Mac OS, usw.) ==
-Um OCDL nutzen zu können, muss natürlich eine aktuelle Version von Python auf dem System vorhanden sein; typische Linux-Distributionen bringen Python bereits mit.
+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.
 === Allgemein ===
@@ Zeile 13: / Zeile 13: @@
    --version             show program's version number and exit
    -h, --help            show this help message and exit
+  -s, --setup           create the necessary directories; ask the user for
+                        login credentials
    -c CONFIGDIR, --configdir=CONFIGDIR
                          specify directory for config files (cookies, login
@@ Zeile 28: / Zeile 30: @@
 | in '~/.ocdl/config.txt' (the actual directory is configurable using the   |
 | '--configdir' command line option).                                       |
+|                                                                           |
+| You can use the command line option '--setup' to create the configuration |
+| directory and to initialize the config file with your login credentials.  |
+|                                                                           |
+| Alternatively, you can manually create the configuration directory and    |
+| the config file:                                                          |
 | Make sure the directory '~/.ocdl/' (or whatever you chose by              |
 | '--configdir') exists and contains the file 'config.txt' with the         |
@@ Zeile 36: / Zeile 44: @@
 |                                                                           |
 | where username and password are your login credentials for opencaching.de |
+|                                                                           |
 |                                                                           |
 | Moreover, ocdl.py stores the login cookie 'cookies.txt' in the selected   |
@@ Zeile 43: / Zeile 52: @@
 === Konfiguration ===
-Als erstes müssen die Login-Daten zu Opencaching.de in der Datei '''config.txt''' im Verzeichnis '''~/.ocdl/''' abgelegt werden. Dabei wird folgendes Format erwartet:
+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 '''--setup''' auf und gibt seine Zugangsdaten ein:
 <pre>
-OCDE_LOGIN='username'
+user@host:~/GPX> ./ocdl.py --setup
-OCDE_PASSWORD='password'
+Performing setup.
+Enter your username for OC.de: XXX
+Enter your password for OC.de: YYY
+Setup done. You may re-run 'ocdl.py' in normal mode.
 </pre>
+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 ===
@@ Zeile 83: / Zeile 96: @@
 </pre>
-Als nächstes wird die Konfigurationsdatei in User-Verzeichnis angelegt. Dazu zuerst ein Verzeichnis '''.ocdl''' im User-Verzeichnis (z.B. '''C:\Benutzer\Flopp\''' bzw. '''C:\User\Flopp\''') erstellen. In diesem Verzeichnis dann die Datei '''config.txt''' mit dem Inhalt
+Als nächstes wird OCDL über die Setup-Funktion eingerichtet. Dazu öffnet man die '''Eingabeaufforderung''', wechselt ins OCDL-Verzeichnis und ruft OCDL mit '''ocdl.py --setup''' auf und folgt den Anweisungen.
-<pre>
-OCDE_LOGIN='username'
-OCDE_PASSWORD='password'
-</pre>
-anlegen, wobei '''username''' und '''password''' durch die Zugangsdaten von Opencaching.de zu ersetzen sind.
-Jetzt sollte '''ocdl.py''' wie im Abschnitt '''OCDL unter Linux''' benutzbar sein.
+Jetzt sollte '''ocdl.py''' wie im Abschnitt '''OCDL auf Unix-artigen Systemen''' benutzbar sein.
 == Weblinks ==