=====================================================================
		=======================
		  A T T E N Z I O N E
		=======================

		PER CHI STA AGGIORNANDO

		CON UNA NUOVA VERSIONE ! ! ! ! !

=====
N.B.:
=====
Con l'aggiornamento alla release 0.3.3 SI CONSIGLIA di caricare le
nuove definizioni degli alimenti (o con Restore Defaults o con il
successivo import di 'AggiornamentoDefinizioniAlimenti.xml) in quanto
è cambiato il meccanismo di computo calorie (che sono state tutte
ricalcolate) e per gli alcoolici è indispensabile il grado alcoolico.
======================================================================

La prima volta che viene eseguita la versione aggiornata richiede se
si intende utilizzare il nuovo database (che contiene un po' di
aggiornamenti sulle definizioni degli alimenti) oppure se si intende
conservare il proprio.

Se si sceglie
		Restore Defaults
si avranno i nuovi alimenti, ma si perderanno tutte le proprie
registrazioni del diario alimentare.

Se si sceglie
		Ignore
si conservano le proprie registrazioni del diario alimentare, ma non
si caricano le nuove definizioni degli alimenti.

Indipendentemente dalla scelta fatta, la si puo' comunque modificare.

>>> 	Se si è scelto  'Restore defaults' si può recuperare la
precedente versione del database che è stata rinominata in 'diet.nnn'
e sostituirla al nuovo 'diet'.

>>>	Se si è scelto  'Ignore' si possono comunque caricare le
definizioni aggiornate degli alimenti e delle ricette scegliendo la
funzione 'Import' (freccia in giù) e poi indicando come il file da
importare:
'AggiornamentoDefinizioniAlimenti.xml'.
    e/o
'Ricette.xml'

=====================================================================










Cos'è DIETA?
============

    DIETA è un programma che permette l'agevole gestione di un
    `Diario Alimentare` di supporto al seguire una dieta.

    Si può impostare un `Riferimento giornaliero` personalizzato di
    ammontare calorico a cui ci si intende attenere per la dieta.
    Tale valore in calorie verrà anche opportunamente suddiviso tra i vari
    principi nutritivi (protidi, lipid, glucidi) a seconda della tipologia
    di dieta prescelta (dieta bilanciata, iperproteica, dieta a zona, ...).

    Ogni giorno del diario è suddiviso in piu' `pasti` e per ogni pasto
    andrà indicato cosa si è consumato.
    Il programma tiene automaticamente conto del `residuo giornaliero` di calorie
    ancora a disposizione.

    Per ogni giorno del diario, oltre al consumo dei pasti giornalieri,
    è possibile inserire il proprio peso del giorno.
    Si potranno quindi visualizzare gli andamenti del proprio peso e
    dei consumi alimentari giornalieri nel tempo via via che procede la dieta.

    Utilizza un data-base contenente la composizione per principi nutritivi
    di un notevole numero di alimenti.
    Tale data-base è modificabile ed ampliabile a piacimento.



Scaricare DIETA
===============

La versione corrente di DIETA e le precedenti sono disponibili presso:
https://sourceforge.net/projects/dieta/files/latest


Installazione di DIETA
======================

La procedura dipende dalla versione che è stata scaticata.

Binario Windows
---------------
E' un eseguibile di installazione classico. Basta lanciarlo e seguire le istruzioni.

NOTA x Windows-Vista:
consiglio di operarne l'installazione in una directory privata
(ad es. sotto l'alberatura Documenti o Desktop) e _non_ sotto quella di default
(C:\Programmi\DIETA)



Binario Mac OsX
---------------
E' in formato dmg. Dopo averlo aperto copiare l'applicazione `dieta` in una directory
utente (cioè per la quale si abbiano i permessi di scrittura) e lanciare l'applicazione da lì.



Binario Linux
---------------
La versione corrente e' stata buildata su una Fedora 11 x86_64, ma probalilmente
riesce a girare anche su altre distro a 64 bit che abbiano python 2.6
Scompattare il file tar.gz in una directory utente.
Settare come current directory la cartella `dieta' radice dello scompattamento.
Lanciare l'eseguibile ./dieta


Sorgenti
--------
Questo programma è scritto in Python, linguaggio interpretato multipiattaforma.
Ciò significa che la stessa versione del codice può funzionare su windows,
come su linux, come su OsX o quant'altro, fatto salvo che siano rispettati i seguenti
REQUIREMENTS:
* sia installato un interprete Python di versione 2.5 o successiva
[non l'ho testato, ma non dovrebbero esserci problemi neanche con le precedenti;
utilizzando le precedenti sincerarsi di avere anche sqlite]
* sia installato Qt4
* siano installati i Python bindigs PyQt4 a Qt4
* sia installato PyQwt ver. 5 [opzionale]
Per installarlo, scompattare direttamente la distribuzione dove più aggrada e
dopo essersi posizionati nella directory di installazione eseguire:
python dieta.py


Licenza
=======

Questo programma è distribuito con la GPL ver.2.


Ringraziamenti
==============

Alla Python Software Foundation per lo sviluppo di questo fantastico linguaggio.
Alla TrollTech per lo sviluppo di un sw professionale multipiattaforma come Qt Open Source Edition version 4 e la sua distribuzione sotto GPL.
Alla Riverbank per lo sviluppo dei bindings tra Qt e Python.
Allo sviluppo di Qwt e PyQwt.
A Detlev Offenbach che ha sviluppato eric4, un' IDE per PyQt4, che mi è stato di aiuto fondamentale sia per lo sviluppo che ... per imparare ad usare empiricamente Qt4, andando ad utilizzare suoi pezzetti di codice qua e là!!!


Contatti
========

Per segnalarmi bachi o proporre nuove funzionalità potete contattarmi a:

[email protected]

Buona DIETA a tutti!!!