LUEMUT (conky + ITL)

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
TÄMÄ LAITTAA ILMATIETEEN LAITOKSEN SÄÄENNUSTEEN TYÖPÖYDÄLLESI
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Uusi versio 2014, pystysuora. työpöydän reunalle.

nettisuvu josta ennuste haetaan on http://ilmatieteenlaitos.fi
bash scripta toimii käsi kädessä conky scriptan kanssa.
jos et tunne conkya, katso tästä ennen kuin jatkat:
http://conky.sourceforge.net/

RIIPPUVUUDET
============
- html-xml-utils
- xmllint (yleensä sisältyy libxml2-pakettiin)
- conky (minulla on versio 1.9.0), grep, wget, sed.
- kirjasin "Droid Sans" sisältyy monien jakelujen lähteisiin, mutta saattavilla
  myös netistä monista paikoista.
- pkill (procps-ng)
- ping (iputils)

lisäksi vielä sed, wget, join ja ehkä jotain muutakin, mutta ne on yleensä jo
asennettuja.

TESTATTU
========
näillä jakeluilla: archlinux (simple openbox) and crunchbang (debian stable) ja
Lubuntu. kaikki vuonna 2014. shell: bash 4.3.18(1)-release

SELITYKSIÄ
==========
tarkoitus on näyttää ennusteet mahdollisimman yhtä suurella tarkkuudella ja
tavalla kuin nettisivulla. parasta jos katsot sieltä ensin.

outputti on jonkin verran VÄRITETTY sen suuruuden mukaisesti. Värit eivät ole
samoja kuin nettisivulla. sen sijaan käytän getcol.txt-tiedostoa joka sisältää
väh. 16 värikoodeja. ne ovat samoja ja samassa järjestyksessä kuin päätteen
(terminal) värit. itse käytän "getcol"-nimisen scriptan jonka avulla poimin
värikoodit :xresources-tiedostosta.

NÄIN SE TOIMII:
===============

1. kaikki riippuvuudet on asennettu.

2. pakkaus on purettu mihin vaan kansioon.

3. olet avannut conky-itlv tiedoston ja laittanut oman paikkakuntasi heti "TEXT"
   osion ensimmäiselle riville: ${exec itlv.sh <paikkakuntasi>}.
        make sure the shell scripts itl.sh and startconky are executable
   (chmod -x itl.sh).

4. Todennäköisesti haluat myös avata bash scriptan ja muokata sen alussa olevat
   muuttujat.

5. käynnistä conkyn AINA startconky scriptan avulla.
        if you want to autostart at login, consult your desktop environment on how to
   do this. don't copy the startconky script anywhere but execute in place, e.g.
   with it's absolute path, which might look sth like this:
   /home/you/.config/itl-2014-03-07/startconky &

6. conky ei välttämättä näytä mitään kun sen käynnistää ensimmäisen kerran.
   voi kestää muutaman minuutin ennen kuin ensimmäiset säätiedot tulee näkyviin.

selityksiä on lisää itl.sh ja conky-itlv tiedostoissa - niitä kannattaa joka
tapauksessa tarkistaa (valitettavasti tällä hetkellä vain englanniksi).

SÄÄ
===
conky scripta käyttää sekä lähipäivien että lähituntien ennustetta, koska
mielestäni ensimmäinen (lähipäivien) ennuste on joskus liian kaukana
tulevaisuudessa. Sade-sarakkeen tiedot eivät ole ihan itseäänselittäviä.
päällimäinen on sateen todennäköisyys, ja sen alla edeltävän tunnin sademäärä.
sininen palkki kertoo jälkimäisestä.

THE SHELL SCRIPT
================
bash scripta on tämän kokonaisuuden tärkein osa.
sen alussa voi helposti vaikuttaa sen toimivuuteen.
VARMISTA SEN ALKUOSASSA OLEVAT MUUTTUJAT JOKA TAPAUKSESSA!
==========================================================
se luo monta pientä tekstitiedostoa joita voisi käyttää muuallakin kuin
conkylla, mutta lopuksi se luo yhden isomman tiedoston joka sisältää säätietojen
lisäksi conkylle sopivia kommentoja.

CONKYSTA
========
luin jossain että "conky is a strange beast". se tekee ihmeitä työpöydällesi ja
käyttää, oikein käytettynä, todella vähän resursseja, mutta se saattaa reagoida
omituisesti muutoksiin. yleensä se toimii luotettavasti kun kaikki on säädetty,
muutta säätövaihe voi olla rasittava.
- Minun scriptalla on pitkä päivitysväli (yli 5 min) - jos teet muutoksia ja
  tallennat, conky huomaa sen ja lataa scriptan uudelleen - mutta varsinaiseen
  päivitykseen voi kulua jopa 5 min. tai sitten conky kaatuu. jos haluat välttää
  turhaa odottamista, laita "pidof conky" terminaaliin ja varmista onko se vielä
  elossa.
- Jos vaihdat kirjasimet, niin tod.näk. koko designi menee hukkaan. Voit korjata
  aika paljon muuttamalla "voffset" arvoa template3:ssä

VAROITUS
========
scripta on testattu, mutta aina voi olla jotain mitä ei toimi kunnolla.
- kun havaitset virheen, ole hyvä ja vastaa tähän viestiketjuun:
http://linux.fi/foorumi/index.php?topic=2242
tai tähän englanniksi:
http://crunchbang.org/forums/viewtopic.php?id=23233
Kiitos!

TEHTÄVÄÄ
========
- Uudet kuvakkeet. kuvakeista en oikein pidä enää, mutta niitä pitää luoda itse
  koska valmiiksi olemassa olevat sääkuvakkeet eivät sovi ilmatieteen laitoksen
  systeemiin.
- enemmän versioita, etenkin vaakasuora-versio
- apu suomenkieliseen dokumentaation kanssa.
  suomi ei ole äidinkieleni ja olisin todella kiitollinen jos joku voisi
  oikolukea ja parantaa dokumentaatiota.

Jos haluat tehdä jotain niin ota yhteyttä foorumien viestiketjuilla tai suoraan
tästä: http://iki.fi/danter/contact/
kiitos.

############################################################################

Älä unohda katsoa säätä ikkunastakin!

yritän ylläpitää ja päivittää scriptat tässä:
http://crunchbang.org/forums/viewtopic.php?id=23233
http://linux.fi/foorumi/index.php?topic=2242

ajankohtaisin versio aina tästä: http://iki.fi/danter/files/itl-current.zip

----------------------------------
jossain suomessa, heinäkuussa 2014