
* DEPENDENCIES
* INSTALLATION
* LICENCE
* USER MANUAL
* THANKS TO
* DEVELOPER INFORMATIONS


/********************************************************************************************\
*                                  D E P E N D E N C I E S                                   *
\********************************************************************************************/

The following libraries and development packages are needed:
KDE >=4.2.x
QT  >=4.5.x	(i do not know if this plasmoid can be compiled with an older version of qt or kde.)


/********************************************************************************************\
*                                  I N S T A L L A T I O N                                  *
\********************************************************************************************/

run ./install.sh

or
     mkdir build
     cd build
     cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` ..
     make
     sudo make install
     kbuildsycoca4

You have to restart plasma after installation

kquitapp plasma; sleep 3; plasma # For KDE 4.2
kquitapp plasma-desktop; sleep 3; plasma-desktop # For KDE 4.3


/********************************************************************************************\
*                                       L I C E N C E                                        *
\********************************************************************************************/

See COPYING the GPL (General Public Licence)
http://www.gnu.org/licenses/gpl-2.0.txt


/********************************************************************************************\
*                                   U S E R   M A N U A L                                    *
\********************************************************************************************/

This plasmoid is a redesign of yaWP 0.2.X with the following main focus:

* multi-city and multi-provider support
* simple user interface
* more animations


This plasmoid shows the informations from the weatherproviders on three different pages:
Clicking on one of the marbles/balles in the top-left will change the current page.

* Preview
  You will see the some informations of the current day in the top
    - high and low temperature
    - weather-condition-icon
    - current temperature and windcondition
    - cityname

     When the weather-data-xml of the selected provider supports informations for day and night
     you can switch between them clicking on the weathericon. All informations of the current day
     you see in the top depends on the state of the weathericon. So, the current temperature is not always visible.

* Details
  You will find the weatherinformations of the selected day in the top of this plasmoid (like in the Preview-Page).
  In the bottom you will find the
    - description of the weathercondition
    - sunrise and sunset
    - realfeel high and low temperature

   The information in the bottom of this page also depends on the state of the weathericon (in the top of this page).
   This informations depends on what data we get from the selected provider.
   Par example: Google does not sends Sunrise/Sunset and the realfeel temperature.

   Clicking on the left and the right arrow-button (in the middle of this plasmoid and below the city name) will switch to another day.

* Satelite
  This page shows a satelitemap of the location.


When you configured more than one city, than you will find arrow-buttons on the left and the right side of the city name.
Clicking on this button will switch to another city, this is on all pages possible.


* Config-Dialog
  * Page Locations
      - here you can add and delete cities.
      When you wants to add a city, click on the button <Add City>, select one provider, enter the city name and click on the button <Find>

  * Settings
      Here you can select
      - the unit system for temperature and windspeed
      - update time. 
      - Animation styles
        I like the Qt4 style Bespin <http://cloudcity.sourceforge.net/> and was inspired by Bespins-Tab-Change-Algorithms
        So i added a slightly modified version of this algorithm to yaWP for all animation-sequences.

  * Panel
      - Panel informations (like in yaWP 0.2.X)

  * Theme
      - Theme settings (background style, custom theme file and font color) (like in yaWP 0.2.X)


*** THANKS TO ***

  Thomas Lübking 
    - for the Tab-Change-Algorithms    <http://cloudcity.sourceforge.net/>



/********************************************************************************************\
*                         D E V E L O P E R   I N F O R M A T I O N S                        *
\********************************************************************************************/

Rootlevel CMakeLists.txt contains the Versioninformations used in this plasmoid (line 44-47)

SET(MAJOR_VERSION 0)
SET(MINOR_VERSION 3)
SET(PATCH_VERSION 0)
SET(YAWP_VERSION_STRING "${MAJOR_VERSION}.${MINOR_VERSION}.${PATCH_VERSION}")


Furthermore it contains a simple QtDebug based logfile-system.
To enable just uncomment the following lines in the CMakeList.txt or comment them out to disable it.
#add_definitions( -DENABLE_DSTREAMLOGGER )
#add_definitions( -DEXTENDED_DEBUG_OUTPUT )


The Archive contains a folder unittest. This is disabled by the normal make-process but might be usefull for
testing or modifing some stuff.

WeatherServiceModel (src/weatherservice.h) manages all cities for this plasmoid using a simple interface for yawp.
Due to the fact that this object has all informations of all cities, this object received an QAbstractTableModel-Interface to
be used in the config-dialog as well.
