Hintergrundinformationen

Neue Elemente für Abschnitte

<rb:chapter xmlns="http://www.w3.org/1999/xhtml"
 xmlns:html="http://www.w3.org/1999/xhtml"
 xmlns:rb="http://www.dokutransdata.de/"
 id="chap_sommer2006" 
 title="Hinterglemm 2006">

<rb:section id="sec_anreise" title="Anreisetag">
<rb:motto>Wer alles es kann</motto>
<rb:journeyday title="Anreisetag" date="2006/07/01"/>
<rb:subsection id="sec_anreise" title="Anreisetag">
<rb:subsubsection id="sec_anreise" title="Anreisetag">
</rb:subsubsection>
</rb:subsection>
</rb:section>
</rb:chapter>

Die Schemadefinition bzw. DTD liefere ich, wenn das Format einigermaßen stabil ist! Eine Datei kann als Root/Hauptelement folgendes haben:

chapter

Kapitel ist etwas übertrieben, meist ist es nur der Reisetag.
Unterelemente können sein: journeyday, section.

foreword

Vorwort.
Unterelemente können sein: section.

appendix

Anhang.
Unterelemente können sein: section.

Die Dateien können weiter unterteilt sein mit section - subsection - subsubsection. Wobei chapter auf h1 bzw. \section*, section auf h2 bzw. \subsection*, subsection auf h3 bzw. \subsubsection*, subsubsection auf h4 bzw. \paragraph* abgebildet wird.

motto

Liefert ein eingerückten Paragraphen mit den "Überschrift" Motto.
Ist gedacht als Leitspruch zum Tag oder zur Tour.

journeyday

Datum des Reisetages, das Datum wird derzeit nicht mehr ausgewertet. Der Titel lieferft evtl. die Kapitelüberschrift, sofern dieser beim chapter bzw. section fehlt.

Neue Elemente

Wirksamkeit der Elemente

Element	Ausgabeformat
kml	HTML
itrackviewer	HTML, PDF
wiki	HTML, PDF
map	HTML
footnote	HTML, EPUB, PDF
timage	HTML
turl	HTML
tgeorss	HTML
image	HTML, EPUB, PDF, Mobile … sofern nicht über mode gefiltert.
sound	HTML
mailto	HTML, EPUB, PDF
touroverview	HTML, EPUB, PDF

Erläuterung

Sofern nicht anders erwähnt, sind die Attribute bei den Elementen Pflicht!

<touroverview></touroverview>

Container der folgende Elemente enthalten kann:

Elemente in

touroverview

Element	Ausgabeformat	Erläuterung
station	HTML,PDF	Ortsname durch den man/frau gefahren ist.
tourlength	HTML,PDF	Streckenlänge der Tour
tourduration	HTML,PDF	Zeitverbrauch der Tour (nicht die reine Fahrzeit!)
tourtype	HTML,PDF	Knackige Charakterisierung der Tour.
touraltitude	HTML,PDF	Höhenmeter der Tour.

<kml/>

Verweis auf eine KML-Datei, diese wird mittels GoogleMaps oder OpenStreetMaps dargestellt.

Attribut	Bedeutung	Format
kmfile	Name der Zwischendatei	HTML
title	Titel in der Zwischendatei.	HTML
mapid	Identifikator für die Karte	HTML
class	Sollte pic_left oder pic_right sein.	HTML
fullurl	Adresse der KML-Datei, muss weltweit erreichbar sein.	HTML
width	Breite der eingebundenen Karte	HTML
mapwidth	Breite der Karte in der Zwischendatei.	HTML
height	Höhe der eingebundenen Karte	HTML
mapheight	Höhe der Karte in der Zwischendatei.	HTML
lonCenterKml	Kartenmittelpunkt - Längengrad, muss für OpenLayer angegeben werden :-(
latCenterKml	Kartenmittelpunkt - Breitengrad, muss für OpenLayer angegeben werden :-(
url	Lokale URL wenn mit OpenLayer gearbeitet wird! Die Datei muss lokal zur HTML-Datei liegen, d.h. für eine Frame-Version ist eine weitere Kopie anzufertigen!

<rb:kml kmlfile="strafwanderung_001" mapid="strafwanderung_001" 
class="pic_right" 
url="http://www.ich-bin-am-wandern-gewesen.de/tracks/Hinterglemm2006/20060703_Tour_Panorama_2_Panorama_5.kml" 
title="Strafwanderung um Hinterglemm" width="540px" height="340px"
 mapwidth="520px" mapheight="320px"/>

<itrackviewer></itrackviewer>

Es wird ein Track von GPSies oder Bikemap etc. eingebunden.

Attribut	Bedeutung	Format
gpsies	Identifikator für den Track bei GPSies	HTML, PDF
toursprung	Portal für Tracks: bikemap, wandermap etc.	HTML, PDF
tour	Identifikator für den Track auf einer Toursprung-Seite	HTML, PDF
class	Sollte pic_left oder pic_right sein.	HTML
width	Breite der eingebundenen Karte	HTML
height	Höhe der eingebundenen Karte	HTML
mode	html oder ltx: Bild erscheint nur in dem gewünschten Ausgabeformat.	HTML, PDF

Bei der PDF-Ausgabe wird nur ein Link zum Track auf dem Portal erstellt, in der EPUB-Ausgabe wird das Element komplett ignoriert.

<rb:itrackviewer mode="html" class="pic_right" 
width="520" height="340" 
toursprung="bikemap" tour="43570">Radtour nach Zell am See
</rb:itrackviewer>

<image/>

Bindet ein Bild ein und erstellt ggfs. eine separate HTML-Datei für das Originalbild.

Attribut	Bedeutung	Format
src	Eingebundenes Bild	HTML, EPUB
mainsrc	Bild für die externe Datei.	HTML
mode	html, epub oder ltx: Bild erscheint nur in dem gewünschten Ausgabeformat.	HTML, EPUB, PDF
lsrc	Eingebundenes PDF-Bild	PDF
width	Breite des Bildes	HTML, EPUB
fwidth	Breite des Bildes	FOP
lwidth	Breite des Bildes	PDF
height	Höhe des Bildes	HTML, EPUB
fheight	Höhe des Bildes	FOP
lheight	Höhe des Bildes	PDF
id	Eindeutiger Schlüssel, wird als Rücksprung-Label verwendet.	HTML
alt	Alternativer Text	HTML
subtitle	Bildunterschrift	HTML
class	Sollte pic_left oder pic_right sein.	HTML

<rb:image class="pic_left" lwidth=".45\textwidth" width="40%"
 alt="Frosch-Hotel" mainsrc="100_0641.JPG" src="100_0641_s.JPG"
 lsrc="100_0641_s" id="IMG_100_0641"/>

<tgeorss></tgeorss>

Erstellt ein Tooltip-Fenster mit den POIs in der Umgebung zu einem Fotopunkt. Es wird im Hintergrund www.geonames.org in der freien Verson genutzt, deswegen kann der Zugriff zufällig nicht funktionieren...

Attribut	Bedeutung	Format	Modus
lat	Breitengrad	HTML
lon	Längengrad	HTML
title	Titel	HTML
georssfile	Name der Zwischendatei zur Darstellung	HTML
url	URL der KML-Datei	HTML
captiontitle	Überschrift	HTML

<map/>

Erstellt ein Tooltip-Fenster mit dem POI/Fotopunkt in OpenStreetMap oder GoogleMap.

Attribut	Bedeutung	Format	Modus
lon	Längengrad für den POI	HTML	pflicht
lat	Breitengrad für den POI	HTML	pflicht
title	Bezeichnung des POI	HTML	pflicht
id	Schüssel, wird für das Popup-Fenster benötigt und die externe Datei!	HTML	pflicht
zoom	Zoomstufe der Karte	HTML	optional

<rb:map lon="47.383333" lat="12.633333"
 title="Saalbach-Hinterglemm"/>

<wiki/>

Erstellt eine Referenz und ein Tooltip-Fenster mit dem Inhalt der WikiPedia-Seite

Attribut	Bedeutung	Format	Modus
target	Ziel in WikiPedia	HTML	pflicht
id	Schüssel, wird für das Popup-Fenster benötigt	HTML	pflicht
source	Quelle des Wiki-Eintrages (WikiPedia='', Radreise-Forum-Wiki='radreisewiki')	HTML	pflicht
ltarget	PseudoZiel in WikiPedia, für die Ausgabe nach PDF wegen der Kodierung von Umlauten etc. wichtig :-(	PDF	optional
width	Breite des Tooltip-Fenster	HTML	optional
height	Höhe des Tooltip-Fenster	HTML	optional

<rb:wiki target="Saalbach-Hinterglemm" width="600px" 
height="300px"/>

<footnote/>

Erzeugt eine Fussnote.

Attribut	Bedeutung	Format
id	Eindeutiger Identifikator	HTML
text	Text der als Tooltip bzw. Fussnote erscheint.	HTML, PDF

<rb:footnote id="fn_01" 
text="Als ich zu Hause war, habe ich GPS-Trackmaker aktualisiert und ..."
/>

<sound/>

Es wird der Flashplayer emff zum Abspielen von MP3-Dateien eingebunden oder das HTML5 Element

audio

verwendet.

Attribut	Bedeutung	Format	Modus
src	Pfad zur MP3-Datei	HTML	pflicht
title	Überschrift zum Player	HTML	optional

<rb:sound src="test.mp3" title="Naturgeräusche"/>

<timage></timage>

Damit kann ein Bild über ein Tooltip eingebunden werden.

Attribut	Bedeutung	Format
src	Pfad zur Bilddatei	HTML
theight	Höhe des Tooltip	HTML
twidth	Breite des Tooltip	HTML

<turl></turl>

Damit kann eine Webseite über ein Tooltip eingebunden werden.

Attribut	Bedeutung	Format
href	Adresse der WebSeite	HTML
theight	Höhe des Tooltip	HTML
twidth	Breite des Tooltip	HTML

<mailto></mailto>

Erzeugt ein normalen Anker für EMails, in PDF-Mode wird daraus eine Fussnote!

Attribut	Bedeutung	Format
to	Adressat	HTML, EPUB, PDF
subject	Betreff	HTML, EPUB

<rb:mailto to="jaloma@dokutransdata.de"
 subject="Schoener Reisebericht ;-)">
 Tadel</rb:mailto>

Verkappte Entities

<rb:hsmiley/>

Erzeugt ein Happy-Smiley

<rb:ssmiley/>

Erzeugt ein Sad-Smiley

<rb:prozent/>

Erzeugt das Prozentzeichen für die unterschiedlichen Ausgabeformate.

Einschränkungen

Featureliste der erstellten Tools

Douglas-Peucker

Der aufgezeichnete Pfad kann jetzt ausgedünnt werden, entweder über den Ramer-Douglas-Peucker Algorithmus oder brutal über den Abstand zwischen zwei Punkten.

Ortsinformationen

Die ausgedünnten Spuren/Tracks können jetzt an GeoNames geschickt werden um

• eine Ortsliste zur Strecke
• oder eine POI-Liste an der Strecke

zu erstellen. Die Ortsliste wird zu einer Stationsliste für den Tourüberblick. Die POI-Liste kann als HTML- oder RDF-Datei weiterverwendet werden.

Fotoinformationen

Sind die Fotos mit Geo-Informationen (z.B. GeoSetter) ergänzt worden, kann ebenfalls mittels GeoNames eine POI-Liste erstellt werden.

get_image_infos all 'ImageBaseName' pl

Erstellt alle derzeit wichtigen Daten wie PDF-Bild, Map-Tag zum Bild, GeoNames-Informationen zum Punkt, GooglePlaces-Ergebnisse.

Fotomanipulationen

Ist ImageMagick installiert, können die Foto skaliert und als "Polaroid" manipuliert werden.

POI-Informationen

Die POI-Liste wird über Googles-Place-API erstellt, dazu sind die Bilder in "data\imgBaseInfos" abzulegen. Ein Aufruf mit

get_image_infos googleplaces 'ImageBaseName' de

erstellt eine HTML-Datei mit einer GoogleMap und den gefundene POIs. Sollen nach der ersten Suchanfrage nur noch Zoomstufe o.ä. in der Ergebnisdatei geändert werden, so kann dies mit 'googlehtml' erfolgen. Zeitgleich mit der Suchanfrage wird eine GPX-Datei mit Wegpunkten der Ergebnisse erstellt, diese kann bei der Vorplanung interessant sein.

Einzelaktionen bei 'get_image_infos.bat'

Argument	Aktion
xmpcoords	Extrahiert aus der *.xmp die notwendigen Koordinateninformationen und erstellt Property-Dateien zur weiteren Verwendung.
getcoords	Wie vorher, nur direkt über das ExifTool!
geonames	Über Geonames.org POI-Informationen besorgen.
resize	Bild mittels ImageMagick verkleinern
pdf	Bild mittels ImageMagick nach PDF konvertieren für die LaTeX-Ausgabe
polaroid	Bild mittels ImageMagick in ein "Polaroid" verwandeln
rotate	Bild mittels ImageMagick rotieren
wiki	Wiki-Informationen über GeoNames.org besorgen.
places	Orte über GeoNames.org besorgen
googleplaces	Hotels, Camping etc. über Google-Places besorgen.
googlehtml	Resultat von Google-Places nach HTML konvertieren. Eigenständiger Aufruf damit nicht ein weiterer Request nach Google geschickt werden muss... (kostet Geld!)
googlegpx	Resultat von Google-Places nach GPX konvertieren.

Einzelaktionen bei 'doit_peucker.bat'

Sollen Information aus den Tracks erstellt werden, liegt im Verzeichnis "data\tracks" eine Batchdatei zur Verarbeitung und die Tracks müssen dort abgelegt werden! Aufruf:

doit 'mode' 'lang' 'baseGPXFilename' 'tag'

Argument	Bedeutung
mode	Aktion die durchgeführt werden soll. (s. Tabelle)
lang	Sprache für die WikiPedia-Anfragen.
baseGPXFilename	Nur den Namen der GPX-Datei, die Datei muss in dem Verzeichnis 'originals' liegen, es ist auch keine Endung '.gpx' anzugeben.
tag	Ein Tag um die Ergebnisdatei zwischen einzelnen Läufen zu unterscheiden.

Erläuterungen zum Arbeitsmodus

Argument (mode)	Aktion
full	Erzeuge alle Informationen
orte	Erstelle die Ortliste für 'touroverview'
wiki	Hole die Wiki-Informationen über GeoNames zum Track
wikiRDF	Erstelle die RDF-Datei zu den Wiki-Informationen.
peucker	Track mittels Douglas-Peucker ausdünnen
ausduennen	Noch weiter ausdünnen über die Streckenlänge
getorte	Ortsinformationen über den ausgedünnten Track holen!
getwiki	Wikiinformationen über den ausgedünnten Track holen!
googleplaces	Rattert den ausgedünnten Track durch, fragt bei GooglePlaces nach Daten und erzeugt eine HTML-Datei mit GoogleMaps-Anbindung, sowie eine GPX-Datei mit Wegpunkten pro Abfrage! Es werde viele Hilfsdateien erzeugt, zum einen Ergebnisdatei von GooglePlaces-Antworten, sowie einige Build-Dateien für Ant. Evtl. produziere ich hier noch eine eigene Anwendung.
places	Die Java-Anwendung zu GooglePlaces, liefert mir eine XML-Datei die mit einigen Zusatzinformationen aus der Detail-Anfrage ergänzt ist. Diese Datei kann einfacher in eine HTML-Map umgewandelt werden.