====== Nutzung persönlicher Notizen zur Wegpunkt-Erstellung und Speicherung ======

===== Automatische Erstellung von Wegpunkten =====

Wenn deine [[cachedetails#personal_note|persönliche Notiz]] zu einem Cache gültige Koordinaten (z.B. ''N50 10.123 E010 34.876'') enthält, erstellt c:geo im [[cachedetails#waypoint_tab|Wegpunkt-Reiter]] dieses Caches automatisch einen Wegpunkt daraus.

Wenn deine persönliche Notiz zum Beispiel folgendermaßen aussieht:

{{:en:personalnote_wp_1.png?direct&600|}}

erstellt c:geo automatisch den folgenden Wegpunkte dafür:

{{:en:personalnote_wp_2.png?direct&600|}}

Weitere Koordinaten in deiner persönlichen Notiz werden gleichermaßen in Wegpunkte übertragen und der Wegpunktname wird entsprechend nummeriert.

<WRAP center round tip 100%>
Wenn die Wegpunkte eines Caches bereits die gleichen Koordinaten enthalten, wie sie in deiner persönlichen Notiz gefunden wurde, erstellt c:geo nicht automatisch einen neuen Wegpunkt für diese Koordinaten, da angenommen wird, dass es in diesem Fall eine unnötige Verdoppelung wäre. Zwei Koordinaten werden als "gleich" in diesem Sinne betrachtet, wenn sie im [[.:coordformat|MinDec-Koordinatenformat]] (z.B. ''N50 10.123 E010 34.876'') vorliegen und identisch sind.
</WRAP>

===== Nutzung von Schlüsselwörtern für Wegpunkttypen =====

Normalerweise definiert c:geo den Typ des Wegpunktes für Koordinaten, die in der persönlichen Notiz gefunden wurden, als ''Referenzpunkt''. Du kannst allerdings Schlüsselwörter in deiner persönlichen Notiz verwenden, um andere Wegpunkttypen zu definieren.

Platziere dazu einfach eines der folgenden Schlüsselwörter vor die Koordinaten:

^ Symbol ^ Wegpunkt-Typ ^ Schlüsselwort in persönlicher Notiz ^ Kurz-ID in persönlicher Notiz ^
|{{ :waypoint_pkg.svg?nolink&40 |}}|Parkplatz|PARKING|P|
|{{ :waypoint_puzzle.svg?nolink&40 |}}|Station mit Frage|PUZZLE|X|
|{{ :waypoint_stage.svg?nolink&40 |}}|Station eines Multi-Caches|STAGE|S|
|{{ :waypoint_trailhead.svg?nolink&40 |}}|Ausgangspunkt|TRAILHEAD|T|
|{{ :waypoint_waypoint.svg?nolink&40 |}}|Referenzpunkt|WAYPOINT|W|
|{{ :waypoint_flag.svg?nolink&40 |}}|Final|FINAL|F|

c:geo erkennt die folgenden Schlüsselwort-Formate als Erkennung für den Wegpunkt-Typ (alle unabhängig von Groß-/Kleinschreibung:
  * Der Schlüsselwort selbst
  * Die Kurz-ID umgeben von Klammern (z.B. ''(f)'' für einen Final-Wegpunkt)
  * Die Kurz-ID selbst **direkt vor** der Koordinate

Zusätzlich funktionieren auch übersetzte Wegpunktnamen (in der Sprache, in der du c:geo verwendest), aber da c:geo in vielen verschiedenen Sprachen verfügbar ist, beschränken wir uns in dieser liste auf die englischen Schlüsselwörter.

Als Beispiel schau dir die folgende persönliche Notiz an, die einige der oben beschriebenen Varianten zur Erstellung verschiedener Wegpunkt-Typen nutzt:

{{:en:pn_with_waypoints.png?direct&600|}}

Dies erstellt dann automatisch diese Wegpunkt für dich:

{{:en:pn_created_waypoints.png?direct&600|}}

===== Wegpunkte in der persönlichen Notiz sichern =====

Es ist möglich eine in Text verpackte Sicherung aller benutzer-geänderten Wegpunkte in deiner persönlichen Notiz zu erstellen. Du kannst diese Notiz dann auf den Geoaching-Server hochladen (wenn der genutzte Geocaching-Dienst dies unterstützt) und hast damit eine Sicherung aller deiner benutzerdefinierten oder veränderten Wegpunkte. 
Da die Wegpunkt aus der persönlichen Notiz beim Öffnen des Caches automatisch erkannt werden, kannst du diese einfach wiederherstellen, wenn sie lokal einmal verloren gehen oder du den Cache aus c:geo gelöscht hast.

Um diese Sicherung zu erstellen, tippe auf das Symbol {{:ic_menu_waypoint_sync.svg?nolink&30|}} unter der persönlichen Notiz. Es wird dann eine Textpassage in deiner persönlichen Notiz erstellt, welche mit ''{c:geo-start}'' beginnt und mit ''{c:geo-end}'' endet. Diese enthält die Sicherung aller benutzerdefinierten Wegpunkte in einer erweiterten Syntax (die im nächsten Kapitel näher erläutert wird).

Um diese Wegpunktsicherung zu aktualisieren, tippe nochmal auf das Symbol{{:ic_menu_waypoint_sync.svg?nolink&30|}}. Um sie zu entfernen, kannst du auf das {{:ic_menu_waypoint_delete.svg?nolink&30|}}-Symbol tippen.

Als Beispiel ergibt eine Sicherung der folgenden Wegpunkte

{{en:pn_waypoints_for_storage.png?direct&600|}}

diese Sicherung in deiner persönlichen Notiz:

{{en:pn_with_stored_waypoints.png?direct&600|}}

===== Erweiterte Wegpunkt-Syntax =====
FIXME ÜBERSETZUNG!!

Vielleicht hast du bemerkt, dass Wegpunkte, die aus der persönlichen Notiz erstellt wurden, mit Standardnamen wie z.B. ''Persönliche Notiz 2'' angelegt werden. Wenn du mehr Möglichkeiten für Wegpunkte aus der persönlichen Notiz nutzen möchtest, kannst du die erweiterte Wegpunkt-Syntax nutzen.
Damit kannst du:

  * Die folgenden Eigenschaften vordefinierter Wegpunkte (d.h. Wegpunkte, die vom Cache-Owner vorgegeben wurden) verändern: Koordinate und die eigene Notiz
  * Wegpunkt-Typen, -Namen und eigene Notizen für benutzerdefinierte Wegpunkte erstellen oder ändern 

Um dies zu machen, benutze die folgende Syntax in deiner persönlichen Notiz:

''@[<Präfix>]<Name> (<WegpunktTypID>) <Koordinate> "<Eigene Notiz>"''

Das erweiterte Format wird erkannt wenn es mit einem ''@'' am Anfang einer neuen Zeile startet. 
Der folgende Inhalt wird ausgelesen:

  * **Wegpunktname**: Alles zwischen dem ''@'' und der Koordinate wird als Teil des Wegpunktnamens benutzt, außer wenn es in Klammern ''()'' steht 
  * **Präfix**: Wenn nach dem ''@''  direkt eckige Klammern ''[]'' folgen, dann wird der Inhalt dieser Klammern als Präfix des Wegpunktes erkannt, den du bearbeiten möchtest
  * **Eigene Notiz**:  Wenn nach der Koordinate direkt ein ''"'' in der gleichen Zeile oder der nächsten Zeile folgt, wird alles zwischen diesem ''"'' und dem nächsten ''"'' als eigene Notiz zu diesem Wegpunkt interpretiert (inklusive Zeilenumbrüche). Wenn nach der Koordinate kein ''"'' aber dennoch weiterer Inhalt in der gleichen Zeile steht, wird dies auch als eigene Notiz zum Wegpunkt erkannt.
  * **Wegpunkttyp**: Es gelten die gleichen Regeln wie in den oberen Kapiteln beschrieben
  * **Koordinate**: Es gelten die gleichen Regeln wie in den oberen Kapiteln beschrieben. Zusätzlich gibt es die spezielle Markierung ''(NO-COORD)'', die genutzt werden kann um eine leere Koordinate zu erzeugen (dies wird im seltenen Fall benötigt, dass man eine eigene Notiz zu einem existierenden vordefinierten Wegpunkt hinzufügen möchte, der keine Koordinate hat).
  * **Formel**: Es gelten die gleichen Regeln wie in den oberen Kapiteln beschrieben. Zusätzlich gibt es die spezielle Markierung ''(F-PLAIN)'', die genutzt werden kann, um die Koordinaten des Wegpunktes in dem Koordinatenformat ''Schlicht'' zu berechnen. Oft enthalten Cachebeschreibungen bereits Koordinaten in diesem Format. Du kannst evtl. schon bekannte Werte der Variablen mit dem ''|''-Symbol getrennt angeben. \\Die Formel muss den Kriterien wie unter [[de:coordinatedialog#nutzung_des_schlicht_koordinaten-formats|Nutzung des "Schlicht" Koordinaten-Formats]] beschrieben entsprechen. \\ Kannst du die Werte für die Variablen erst nach und nach ermitteln, empfiehlt es sich, ''Wegpunkt-Extraktion verhindern'' zu aktivieren, bis du alle Variablen in der persönlichen Notiz eingegeben hast. Dann kann du den Wegpunkt mit allen Werten erzeugen und es werden auch gleich die Koordinaten berechnet. (Hinweis: die restlichen Formate sind in Bearbeitung)

Die Wegpunktliste des Geocaches wird mit diesen Informationen wie folgt verändert:

  * Wenn ein **Präfix** erkannt wird und es gibt einen Wegpunkt mit dem gleichen Präfix, dann wird angenommen, dass dieser Wegpunkt verändert werden soll. Das wird normalerweise für vom Owner vorgegebene Wegpunkte genutzt.
  * Wenn ein Wegpunkt mit der gleichen Koordinate erkannt wird, wie ein bereits vorhandener Wegpunkt, wird angenommen, dass dieser Wegpunkt verändert werden soll.
  * In allen anderen Fällen wird ein neuer Wegpunkt erstellt.

Bei der Veränderung eines Wegpunktes werden die folgenden Regeln angewandt:

  * Für vom Owner vorgegebene Wegpunkte können nur die Koordinate (wenn vom Owner leer gelassen) und die eigene Notiz angepasst werden.
  * In bestehenden Wegpunkten werden Daten nur überschrieben, wenn diese entweder leer oder mit dem Standardwert (z.B. systemgenerierter Wegpunktname) gefüllt sind.
  * Eine Formel im Format ''Schlicht'' wird nur übernommen, wenn noch keine Formel oder Koordinate eingegeben wurde.

Die folgenden Beispiele zeigen unterschiedliche Texte (links) und die daraus automatisch erstellten Wegpunkte (rechts):

^ Text der persönlichen Notiz ^ Generierter Wegpunkt ^
| ''@ A good parking place N50 11.456 E010 35.345 park under the oak tree'' | {{:en:parkingplace.png}}|
| ''@ (X) marks the spot N50 12.010 E010 33.783'' |{{:en:marksthespot.png}} |
| ''@[S5]Station 5 (X) (NO-COORD) "We have to think about this later"'' \\ \\ //Hinweis: Dieses Beispiel nimmt an, dass es einen vom Owner vorgegebenen Wegpunkt mit dem Präfix S5 im Geocache gibt//|{{:en:station5.png}} |
| ''@Final (F) (F-PLAIN) N48 AB.(C*D/2) E 9 (C-D).(A+B) |A=a+b|a=5| "Formula is calculated with the variables"'' \\ \\ //Hinweis: Im Wegpunkt-Rechner ist die Formel dann eingetragen//|{{:en:final_calculated.png}} |