SIstory augmented reality V1.0 XML Schema
Version: 1.0
Date: 2013-10-10
Used to validate XML instances of Data Sets to be converted to Layar SQL, Junaio XML and Wikitude XML.
This software is dual-licensed:
1. Distributed under a Creative Commons Attribution-ShareAlike 3.0
Unported License http://creativecommons.org/licenses/by-sa/3.0/
2. http://www.opensource.org/licenses/BSD-2-Clause
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
This software is provided by the copyright holders and contributors
"as is" and any express or implied warranties, including, but not
limited to, the implied warranties of merchantability and fitness for
a particular purpose are disclaimed. In no event shall the copyright
holder or contributors be liable for any direct, indirect, incidental,
special, exemplary, or consequential damages (including, but not
limited to, procurement of substitute goods or services; loss of use,
data, or profits; or business interruption) however caused and on any
theory of liability, whether in contract, strict liability, or tort
(including negligence or otherwise) arising in any way out of the use
of this software, even if advised of the possibility of such damage.
Andrej Pančur, Inštitut za novejšo zgodovino, Ljubljana (Institute of contemporary history, Ljubljana)
slovenski
Slovenian
angleški
English
nemški
German
hrvaški
Croatian
srbski
Serbian
bosanski
Bosnian
makedonski
Macedonian
francoski
French
španski
Spanish
italijanski
Italian
madžarski
Hungarian
ruski
Russian
poljski
Polish
češki
Czech
slovaški
Slovak
danski
Danish
nizozemski
Dutch
Povezava do zunanje spletne strani.
Obstaja samo ena jezikovna varianta te spletne strani, ki je primerna za povezave vseh
jezikovnih variant točk interesa. Če obstaja več jezikovnih variant spletne strani,
se jih vnese v okviru linksGroup.
Združuje povezave do spletne strani, ki obstaja v več jezikovnih enačicah.
Povezava na drugo layar aplikacijo.
Če bo obstajala povezava na dodatno zunanjo spletno stran, na kateri bodo dodatne informacije (opis, slike, galerije),
je boolean vrednost true, v nasprotnem primeru se tega elementa ne vpisuje.
Telefonska številka, katero se direktno pokliče.
Vpisuje se samo številke, brez presledkov, pomišljajev, vezajev, plusov ipd.
Naslov elektronske pošte, na katerega se neposredno piše.
(napiši pravi regex patern za validacijo)
Telefonska številka, na katerega se neposredno pošlje sms.
Velja samo za Layar.
Naslov hišne številke in kraja, ki ga zazna tudi google maps
(poleg geografske dolžine in širine je to dodatna informacija za prikazovanje na zemljevidu).
Ime ulice.
Hišna številka.
Kraj.
Država.
Naslov posamezne točke interesa (POI).
Ni omejitev glede dolžine, vendar je verjetno priporočljivo, da ni predolgo.
Mapiranje: ar:title (Junaio), kml:name (Wikitude).
Za Layar je posebni element layar:title, ki ima dolžino omejeno na 60 znakov.
Daljši opis vsebine za Junaio in Wikitude POIs.
Prikaže jih na glavnem zaslonu za izpis vsebine.
Mapiranje: ar:description (Junaio), kml:description (Wikitude).
Čeprav za Wikitude ni omejitve glede dolžine znakov in je pri Junaio omejitev 1024 znakov,
se število znakov omeji na 1024 (kar povsem zadošča za opis za nadgrajeno resničnost).
Za opise vsebine pri Layar glej layar:description.
Če je sistory:description krajši od 140 znakov, se ga mapira v layar:description,
če pa je daljši od 140 znakov pa v layar:webDescription
Referenca na vse Dublin Core elemente AR/DublinCore/dc[@id],
ki se nanašajo na opis vsebine.
Če je opis POI daljši od 140 znakov in ga zato ni mogoče mapirati v layar:description,
se ga vpiše sem in potem po možnosti prenese v mobilno spletno stran dodatne vsebine in galerije POIs
(povezava preko Layar action weblink). Nov odstavek gre v nov element.
Referenca na vse Dublin Core elemente AR/DublinCore/dc[@id],
ki se nanašajo na daljši opis vsebine za na spletno stran.
Če je naslov POI krajši od 60 znakov, se ga vpiše samo v layar:title (velja za Layar, Junaio, Wikitude),
če pa je naslov daljši od 60 znakov, se ga vpiše v sistory:title (velja za Junaio in Wikitude).
Če je opis vsebine krajši od 140 znakov, se ga vpiše samo v layar:description (velja za Layar, Junaio, Wikitude),
če pa je daljši od 140 znakov (in krajši od 1024 znakov), se ga vpiše v sistory:description (velja za Junaio in Wikitude,
za Layar pa se ta podatek prikazuje na povezani spletni strani).
Če je opis vsebine daljši od 1024 znakov, se ga vpiše v sistory:webDescription, pri čemer se za Layar in Junaio
prikazuje na povezani spletni strani, za Wikitude pa v okviru opisa POI (če ni drugega daljšega opisa).
Referenca na vse Dublin Core elemente AR/DublinCore/dc[@id],
ki se nanašajo na celotno vsebino children elementov.
Elementa description in webDescription imasta zaradi potencialno
večje dolžine besedila opisa lahko referenco na svoje DC metapodatke.
Okvirni element za naslove hiš, elektronske pošte, povezave na spletne strani,
telefonske številke, sms sporočila, ki s pritiskom na gumb sprožijo akcijo povezovanja,
klicanja, pošiljanja.
Geografska širina.
Geografska dolžina.
Nadmorska višina.
Možno je naložiti več slik. Glavna slika je vedno prva v vrsti.
Ostale slike se uporabi za galerijo na zunanji spletni strani.
Originalna slika iz katere izhajajo vse druge slike.
Slika, ki je primerna za prikazovanje na zunanji spletni strani.
Velikost nekje med 400 do 600 pikslov.
Opis slike, ki se ga lahko prikazuje pri galeriji ali
v primeru, če slike ne naloži.
Če imamo naloženo samo eno sliko, katere velikost potem prilagajamo s &=400&=600,
vstavimo tukaj pot do te slike, npr v primeru SIstory
http://www.sistory.si/publikacije/image/?id=12345
Če podatke za te slike vpisujemo račno v sistory-ar, lahko v elementu
AR/providerINFO/imageResizePath dodamo skupno pot do slik, v elementu imageID pa nato
samo še identifikacijkos številko te slike, npr. 12345
Referenca na vse Dublin Core elemente AR/DublinCore/dc[@id],
ki se nanašajo na sliko (in verzije slike) tega elementa.
Dublin Core podatki, ki veljajo samo za posamezno točko interesa.
Sem se npr. vpisujejo različne relacije med objekti.
Sem se npr. zapiše SIstory URN in URL, iz katerega se je prekonvertiralo ta POI.
Unikaten ID točke interesa (POI) znotraj posameznega XML zapisa.
Ta ID se nato prenaša v Layar, Junaio in Wikitude.
Priporočljivo je, da slike in drugi dokumenti, ki so priloga te POI, v imenu datoteke vsebujejo tudi ta ID.
Primer za Mursko Soboto: ms_1
Izvorni - originalni URI, če podatki prvotno izvirajo iz kakšne druge baze.
Če je ta POI npr. vnešena tudi v SIstory, se sem vnese URL te SIstory publikacije.
Naprej se bo procesiralo samo tiste POIs, katere bodo imele boolean vrednost true.
POIs, ki jih (začasno) ne želimo več prikazovati, tako preprosto označimo z negativno vrednostjo false.
Neobvezno se lahko vpiše tudi tip točke interesa, za katerega v sistory-artype XML shemi
obstaja kontroliran vokabular, kateri se lahko s popravljanjem te sheme sproti dopolnjuje.
Potencialno bi lahko različni tipi omogočili filtriranje točk interesa pri XSLT transformaciji.
Metapodatki, katere ni mogoče vpisati v obstoječe metapodatke
in niso nujno potrebni za delovanje nadgrajene resničnosti,
vendar so pomembni glede avtorstva, avtorskih pravic, sorodnih objektov ipd.
Relacije, ki so pomembne samo za posamezen POI, se vpisuje kod otroke elementa dc tega POI.
Okvirni element, ki vsebuje enega alii več Dublin core elementov istega objekta.
Identifikacijska oznaka posameznega Dublin Core elementa,
ki se nanaša na eden ali več elementov točk interesa in njihove elemente:
AR/POIs/poi/text[@dcRef]
AR/POIs/poi/text/description[@dcRef]
AR/POIs/poi/text/webDescription[@dcRef]
AR/POIs/poi/images/image[@dcRef]
Glavno ime za Junaio (admin) in Wikitude (admin).
Dolžina ni omenjena, vendar verjetno bolje, da je krajše.
Ime za Layar se piše posebej, ker ima omejitve glede dolžine.
Pot do slik, katerim prilagajamo velikost.
Za vsako sliko posebej ne nato potrebno vnesti še njeno identifikacijsko številko
v elementu AR/POIs/poi/images/image/imageResize/imageID