Email
2 Logbook
2010-08-03
Martin Horak, martinhorak@centrum.cz
www.horakovi.eu
[CZ] Tento dokument obsahuje základní informace k používání aplikace email2log.
email2log je aplikace, a nástroj, na automatické generování webové stránky (html). Jako vstupy pro vygenerování stránky slouží SMS, či emaily, zaslané uživatelem. Předpokládá se, že SMS/email obsahuje geografickou pozici např. z GPS zařízení, a další doplňkový text. Výsledná html stránka bude pak obsahovat mapku s trasou a popis. Právě přítomnost mapy je důvod, proč nejde použít Facebook. Výsledná stránka se přenese na webový server, takže bude moci být přístupna všem lidem. Dále bude na konci přenosu poslán informativní email.
[EN] This document contains basic info for email2log application. The
application is using SMS or email as an input (e.g. containing GPS position),
and generates HTML page as a result to web server. More information in English
will be added later on, or on demand – see email of author.
Hlavní myšlenka celého systému
Uživatel zprávu
z mobilního telefonu, obsah zprávy se pak dekóduje a následně se
vygeneruje HTLM soubor/stránka. Soubor se pak přenese na webový server – čímž
je možné, pro uživatelovi přátele, si následně stránku prohlídnout ve webovém
prohlížeči (Internet Explorer, Firefox, Opera, atd) kdekoli na světě.
Zpráva
z mobilního telefonu se posílá pomocí emailu (v mobilním telefonu je nutno
vybrat položku Poslat zprávu jako email), či pomocí SMS.
Pokud uživatel
posílá SMS, pak SMS musí být ve formátu, aby výsledkem byl poslán email. Formát
SMS definuje mobilní operátor.
Např Vodafone má SMS
tvar: email2log@gmail.com
email_v_normalizovaném_tvaru
Uživatel
mobilního telefone pro Vodafone posílá tuto SMS na
číslo 2255. Tím firma Vodafone zařídí, že na adresu email2log@gmail.com bude zaslán email v jehož těle bude
zpráva email_v_normalizovaném_tvaru .
Systém Email2log si všechny příchozí
emaily na této adrese pravidelně „čte“, např. jednou za 30 minut.
Aby se mohl
následně vygenerovat HTML soubor/stránka, musí být vstupní SMS/email zaslaný
mobilním telefonem v definovaném (normalizovaném) tvaru.
Normalizovaný tvar emailu (či v SMS poli email_v_normalizovaném_tvaru)
Formát emailu email_v_normalizovaném_tvaru:
ID_emailu Datum [Lat+Lon] Text_do_konce_emailu
-nebo-
ID_emailu Datum Text_do_konce_emailu
Formát datumu Datum:
Číselný:
RRRRMMDDHHMM --> 12 číslic: Rok na 4 číslice následovaný Měsícem na 2 číslice následovaný Dnem na 2 číslice. Dále Hodina na 2 číslice následovaná Minutou na 2 číslice.
RRRRMMDD --> 8 číslic: Rok na 4 číslice následovaný Měsícem na 2
číslice následovaný Dnem na 2 číslice. Hodina a minuta budou nastaveny na
00:00.
DDHHMM --> 6 číslic: Den na 2 číslice, dále Hodina na 2 číslice
následovaná Minutou na 2 číslice. Rok a měsíc bude nastaven na momentální rok a
měsíc.
HHMM --> 4 číslice: Hodina na 2
číslice následovaná Minutou na 2 číslice. Rok, měsíc a den budou odpovídat
momentálnímu (dnešnímu) datu.
DD --> 2 číslice: Den na 2
číslice. Rok, měsíc a den budou odpovídat momentálnímu datu. Hodina a minuta
budou nastaveny na 00:00.
Písmena:
A --> Jedno písmeno „A“ – aktuální den a čas.
D --> Jedno písmeno „D“ – aktuální den (tedy
dnešní datum). Hodina a minuta budou nastaveny na 00:00.
Příklad 1: Email/SMS přidá pro datum 28.6.2010 geografické
souřadnice a text.
demo 20100628
<50.075896+14.415073> Je tu Mallorca.
Příklad 2: Email/SMS přidá pro datum 28.6.2010 další text.
demo 20100628 Tento text se přidá za
text Je tu Mallorca.
Příklad 3: Email/SMS přidá pro datum 30.6.2010 text „Přepluli
jsme do Itálie“, a do záhlaví dne přidá extra text „Itálie“.
demo A
%Itálie%Přepluli jsme do Neapole.
Příklad 4: Email/SMS přidá pro datum 30.6.2010 v čase
11:05 text.
demo 201006301105 !A zde řádek pro datum a specifický čas, řádek začne novým odstavcem.
Předpoklad:
-
Každý
účastník posílá email na společný účet email2log@gmail.com
-
To pro
kterého účastníka je email poslán (pro který jeho projekt), co určuje
identifikátor ID_emailu. Tento identifikátor je naprosto jednoznačný a
jedinečný.
-
Na text
napsaný v Subject/Předmětu emailu se nebere
ohled. Samotný text pro účely systému se nalezne v těle emailu – tedy tělo
emailu bude dekódováno.
Zvláštnost Text_do_konce_emailu:
-
Pokud text začíná znakem “!” (Vykřičník), pak
text za tímto znakem bude začínat na samostatném řádku.
-
Pokud text začíná znakem “%”, pak text do
dalšího znaku “%” (tedy text nacházející se mezi procenty) bude označen ve
zvláštním poli.
- Více viz kapitola „Zpracování textu Text_do_konce_emailu“
Příklady povoleného
formátu geografických souřadnic Latitude a Lontitude (zeměpisná šířka a výška):
-
<50.075896+14.415073> …
tedy stupně tečka minuty, znaménku plus uprostřed
-
<50.075896 +
14.415073> … tedy stupně tečka minuty, znaménku
plus uprostřed s mezerami
-
<50° 10.75896+15°
5.12345> … tedy stupně mezera minuty
s desetinnou tečkou
-
<50 10.75896+15
5.12345> … tedy stupně mezera minuty
s desetinnou tečkou
-
<50° 10’ 25“ + 15° 5‘
12“> … tedy stupně mezera minuty mezera vteřiny
-
<N50.075896 +
14.415073E> … zápis pro určení Severní šířky a
Východní délky. Písmeno pro šířku musí být na první pozici, písmeno pro označení
délky musí být na poslední pozici.
Upozornění: Systém
rozezná zápis souřadnic podle to, že jsou ohraničeny znaky menší a větší
(„<“ resp “>”) a ve vnitř je znaménko „+“
(plus).
Upozornění: Pokud
nejsou uvedena písmena „N“,“S“,“E“,“W“ (tedy severní šířka, jižní šířka,
východní délka, západní délka), pak je standardně předpokládána severní šířka a
východní délka.
Pomoc námořníkům
v Chorvatsku používající chorvatské mapy (např. Male Karte)
v použití geografických souřadnic: Chorvatské mapy nepoužívají WGS 84
souřadnicový systém používaný v GPS přístrojích, ale systém "Bessel 1841" (Besselův
elipsoid) jenž nebývá běžně dostupný v GPS přístrojích. Jak je psáno na http://www.dalmacia.org/ucebnitext/gpsi.htm
: „pro chorvatské mapy se hodnota posunutí zeměpisné šířky mění v rozmezí 0 -
0,01´(cca 20 m) směrem jižním, a hodnota posunutí zeměpisné délky je 0,27´-
0,31´ (cca 380 m) směrem východním.“. Systém MhoWebLogbook
proto automaticky přepočte pozici na WGS 84 a to posunem východní zeměpisné
délky o střední hodnotu 0,29´.
Příklady povoleného
formátu geografických souřadnic Latitude a Lontitude (zeměpisná šířka a výška) pro tyto chorvatské
mapy:
-
<C50° 10.5 + 15° 5.2>
-
<C50°10.5+15°5.22>
-
<C50 10.5+15 5.21>
-
<50° 10.5+15° 5.2EC>
-
<N50° 10.5+15° 5.2EC>
-
<CN50° 10.5+15° 5.2E>
Upozornění: Systém
rozezná zápis souřadnic podle to, že je použito písmeno „C“ na začátku či konci
zápisu souřadnic. Písmeno „C“ musí předcházet písmenu pro šířku („N“), resp.
následovat za písmenem označujícím délku („E“).
Upozornění: Systém
nepracuje pro souřadnice definované „stupně tečka minuty“. Důvodem je, že tento
systém je používán standardně v GPS přístrojích a nikoli chorvatských
mapách.
Zpracování textu Text_do_konce_emailu
Pro vysvětlení použijeme
sadu příkladů. Příklady předpokládají, že se pošlou 2 SMS pro stejný datum,
popř. datum a čas, např:
demo 20100628 text1
demo 20100628 text2
Výsledkem je, že text2 se přidá
za text1. Následující příklady zobrazují výsledný text (na
uvozovky v příkladech neberte zřetel v čase , slouží jen pro lepší
vysvětlení)
Příklad 5:
Text1:
demo
20100628 Máma mele.
Výsledek:
Máma
mele. ... mezery před a za textem „Máma mele.“ jsou smazány – na mezery se
nebere zřetel.
Příklad 6:
Text1:
demo
20100628 !Máma mele.
Výsledek:
Máma
mele. ... mezery před a za textem „Máma mele.“ jsou smazány – na mezery se
nebere zřetel. Následně je použit znak „!“
sloužící pro vypsání textu na samostatném odstavci.
Příklad 7:
Text1:
demo 20100628
kole
Text1:
demo
20100628 no
Výsledek:
koleno ...
slovo je spojeno.
Příklad 8:
Text1:
demo
20100628 Ahoj.
Text1:
demo
20100628 Nazdar.
Výsledek:
Ahoj.
Nazdar. ... slova jsou spojena s tím, že pokud první („Ahoj.“) končí
tečkou, pak před dalším slovem („Nazdar.“) se automaticky přidá mezera.
Příklad 9:
Text1:
demo
20100628 Je tu
Text1:
demo
20100628 .krásně;
Výsledek:
Je tu
krásně; ... slova jsou spojena s tím, že pokud druhé („krásně;“) začíná
tečkou, pak se před druhé slovo („krásně;“) automaticky přidá mezera.
Upozornění:
-
Znaménka
menší a větší („<“ resp “>”) jsou používány pro
zvláštní případy – a to jak v rámci systému MHo
Web Logbook, tak i v rámci jazyka HTML
sloužícího pro zápis stránek. Můžete proto v textu použít některé prvky
HTML, např.:
1.
Máma
<i>mele</i> maso. …
výsledkem bude text: Máma mele maso.
2.
Máma
<u>mele</u> maso. … výsledkem
bude text: Máma mele maso.
3.
Máma
<b>mele</b> maso. … výsledkem
bude text: Máma mele maso.
-
Pokud si
přejete ve vašem textu zapsat znaménka menší a větší („<“ resp “>”), pak použijte dvojitě zapsané znaménko -
„<<“ resp “>>”. Mezi těmito dvojitými
znaménky nesmí být mezera.
Zvláštní příkazy
Slouží pro nepřímou
spolupráci se systémem za pomoci mobilního telefonu či emailu.
ID_emailu
Datum <CLEAR_ALL> -nebo-
ID_emailu
Datum <CLEARALL>
Vymažou se všechny dříve
poslané záznamy a vygeneruje se HTML stránka/soubor bez záznamů.
Příklad 10: demo 20100628 <CLEAR_ALL>
ID_emailu
Datum <CLEAR_DATE> -nebo-
ID_emailu
Datum <CLEARDATE>
Vymažou se všechny dříve
poslané záznamy pro konkrétní datum a vygeneruje se HTML stránka/soubor.
Příklad 11: demo 20100628 <CLEAR_DATE>
ID_emailu
Datum <REFRESH>
Vygeneruje se HTML stránka/soubor.
Příklad 12: demo 20100628 <REFRESH>
ID_emailu
Datum <DUMP>
Vypíšou se základní informace do LOG souboru.
Příkazy pro vzdálené nastavení systému
ID_emailu
Datum <SET ZOOM cele_cislo_zvetseni>
Nastavení
inicializačního zvětšení mapy.
Příklad 13: demo 20100628 Datum <SET ZOOM 10>
ID_emailu
Datum <SET CENTER Lat+Lot>
Nastavení
inicializačního centrálního bodu mapy.
Příklad 14: demo 20100628 Datum <SET CENTER
50.075896+14.415073>
Pozor: souřadnice
jsou odděleny znaménkem „+“ (plus), viz popis zápisu formátu souřadnic popsaný
výše.
ID_emailu
Datum <SET EMAILADD aaa@bbb.cz>
Přidání další
emailové adresy do seznamu adres. Pokud dojde ke změně stránky, pak je na tyto
adresy zaslán informační email.
Příklad 15: demo 20100628 Datum <SET EMAILADD nekdo@adresa.com>
ID_emailu
Datum <SET EMAILCLEAR>
Vymažou se seznam
emailových adres – informační email při změně stránek se tak nebude zasílat.
Demonstrační příklad
Pro vyzkoušení
systému je možno použít demonstrační příklad.
Adresa vygenerované
stránky:
http://www.horakovi.eu/email2log/Demonstrace.html
Adresa vygenerované
stránky pro majitele – slouží pro přehled co se přihodilo v projektu (LOG
soubor):
Info: jen vlastník projektu zná ID_emailu. Bez
znalosti tohoto kódu neví běžný uživatel tuto adresu. ID_emailu musí být napsán
velkými písmeny.
http://www.horakovi.eu/email2log/Demonstrace_DEMO.html
Příklad 16: přidání
textu pro datum 20100628:
1) Z mobilního telefonu, operátor Vodafone, pošlete tuto SMS na číslo 2255: email2log@gmail.com demo 20100628 Můj text
do konce zprávy.
2)
Po
určité době budou přegenerovány obě HTML stránky na
obou adresách popsaných v předchozích odstavcích.
Počáteční nastavení před používáním systému
Dříve než se začne
systém používat, musí autor (nebo-li správce systému) vytvořit nový projekt.
Vytvořením nového projektu vznikne kód ID_emailu.
Pro vytvoření
projektu je nutné nastavit základní parametry projektu, jako např.:
1)
Nastavení
grafických parametrů výsledné HTML stránky/souboru. Např.
a.
Barva
pozadí
b.
Barva
textů
c.
Nadpis
umístěný v horní části stránky
2)
Geografické
údaje sloužící pro mapu
a.
Souřadnice
středu mapy
b.
Nastavení
zvětšení náhledu mapy
3)
Adresa
a přihlašovací údaje cílového webového serveru (FTP přenos)
4)
Seznam
emailových adres, na které automaticky pošle systém upozornění, pokud byla
vy/pře-generována nová HTML stránka.
Posílání MMS – posílání fotek z mobilního telefonu
Mobilní operátoři
dosud zaslání MMS na emailovou adresu neumožňují. Proto je možno fotku (soubor
typu JPG) poslat z mobilního telefonu pomocí volby Poslat email.
Emailová adresa
nechť je email2log@gmail.com
Na Předmět/Subjekt
emailové zprávy se nebere zřetel.
Foto je uloženo
v příloze.
Tělo zprávy musí
být v definovaném (normalizovaném) tvaru – viz tento dokument výše,
např: demo 20100628 Posilam
foto z Benatek.
Na výsledném HTML
soboru/stránce se foto objeví v malých rozměrech – náhledu. Kliknutím myší
na náhled se foto objeví v plné velikosti.
Pozor: Čím větší
(rozměry šířka a výška) je posílaná fotka, tím více bytů se musí
z mobilního telefonu poslat, a tím více bude přenos dotyčné zprávy stát –
mobilní operátor bude vymáhat po vás větší cenu. Proto doporučuji fotku před
odesláním zmenšit.
Omezení:
V jednom emailu může být jen jedna fotka. Soubor s fotka musí být formátu
JPG.
Posílání několika zpráv v jednom emailu
Do těla jedné SMS
mající jen 160 znaků se pravděpodobně vleze jen jedna zpráva
v normalizovaném stavu. Pokud ale posíláme z mobilního telefonu email,
pak se do těla emailu vleze více zpráv v normalizovaném stavu. Je tedy
finančně asi výhodnější poslat jeden email z mobilního telefonu, než sled
několika SMS.
Formát zprávy –
z mobilního telefonu:
ID_emailu ZPRÁVA $$$ ID_emailu ZPRÁVA
Formát zprávy –
z počítače:
ID_emailu ZPRÁVA
... zde je přechod na nový řádek, další zpráva začíná dalším řádkem
ID_emailu ZPRÁVA
ZPRÁVA má formát:
Datum <Lat+Lon>
Text_do_konce_emailu
-nebo-
Datum Text_do_konce_emailu
Vysvětlení:
-
Jednotlivé
zprávy jsou tedy odděleny trojicí znaků „$”
(dolar).
-
Počet
zpráv ZPRÁVA může být uvedeno teoreticky nekonečně mnoho
– tedy nejen dvě jak je uvedeno v odstavci „Formát zprávy“.
Pozor:
-
Posílejte
email jako prostý text, tedy neformátovaný. Např. email zaslaný z google (gmail.com)
je většinou ve Formátovaném tvaru – je použito formátování HTML. Formátovaný
tvar neumí systém zpracovat.
Příklad 17:
Email
z mobilního telefonu – vše psáno na jeden řádek:
demo 20100721
Hello world.$$$ demo
20100722 A jsem zde. $$$demo 20100723 %Itálie%Hurá.
Email
z počítače – co zpráva, to nový řádek:
demo
20100721 Hello world.
demo 20100722 A jsem zde.
demo 20100723 %Itálie%Hurá.
Posílání emailů pomocí SMS
T-MOBILE:
O2:
Vodafone:
Pozor:
-
Všimněte
si mezery mezi emailovou adresou a email_v_normalizovaném_tvaru , či mezi EML a adresou.
-
Ne všechny
znaky jsou pro SMS podporovány – např. Vodafone při
zaslání SMS obsahující znaky {,},[,],| zašle email kde místo těchto znaků je
uveden jen znak ? (otazník).
-
V SMS
se nesmí vyskytovat české znaky, nebo musíte vypnout podporu přenosu českých
znaků v mobilu (v tom případě se české znaky neodešlou, odešle se náhrada
bez češtiny – např. písmeno „s“ místo písmena „š“).
Závěr
Chcete založit
projekt? Není problém, stačí napsat email autoru systému Email2log na
adresu martinhorak @ centrum.cz
Konec souboru