Read Me

=====================================================================
		=======================
		  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:

dieta.sw@gmail.com

Buona DIETA a tutti!!!