Per favore leggi questo documento se hai delle domande sul programma.

Questo programma (TCBR Shell) serve per preparare libri e testi da poter leggere su qualsiasi telefono cellulare, usando TequilaCat BookReader midlet.

Sotto, è descritto il programma Shell. Puoi trovare ulteriori dettagli ed informazioni su BookReader midlet sulla homepage del programma:
http://tequilacat.narod.ru/dev/br/
Ti raccomando di controllare novità e nuove versioni sulla homepage, per nuove caratteristiche e sistemazione di bug.

Le caratteristiche di BookReader sono:
1. I libri preparati con Shell possono essere divisi in capitoli, per intestazione capitolo o per una massima dimensione specificata.
2. Diverse marche di telefoni sono supportate: Nokia, Siemens, Motorola ecc...
3. Quando prepari un libro, puoi scegliere il carattere per leggerlo sul telefono, fra tutti i caratteri a larghezza fissa installati sul tuo pc Windows.
 Al momento solo i caratteri a larghezza fissa sono supportati come Courier, nelle prossime versioni saranno supportati anche i caratteri a dimensioni variabili.
4. Puoi scegliere i colori dello sfondo e dei caratteri, per una lettura più confortevole.
5. Puoi scegliere tra numerose opzioni per la lettura.
6. Se lo Shell include la localizzazione del file, puoi optare per localizzare il midlet, così tutti i comandi e i menù sul telefono saranno disponibili nella tua lingua.

================================================
Come usare BookReader Shell:
================================================
1. Premi il bottone "+" per aggiungere file(s)di testo per includerli nel libro
2. Premi "-" per rimuovere testi dalla lista
3. Rinomina i testi usando il bottone "Rinomina"  per cambiare i nomi che vedrai sul telefono
4. Sulla tabella "Opzioni", seleziona la versione per la tua marca e modello
5. Seleziona le opzioni desiderate e le restrizioni sulle dimensioni (vedi ulteriori dettagli sulle restrizioni sotto)
 L'opzione "Estendi schermo in altezza" è applicabile solamente ai telefoni Motorola e Samsung, per abilitare il display a schermo intero usando la parte bassa dello schermo dove sono solitamente visualizzati i comandi.
6. Sulla tabella "Caratteri", seleziona i caratteri ed i colori. Seleziona "Usa caratteri del telefono" per salvare spazio per i libri (1-2 kilobytes di testo), se il tuo telefono ha limitazioni di dimensioni (ancora, vedi sotto)
7. Inserisci il nome del libro nella parte inferiore della finestra. Questo nome sarà usato sul telefono, quindi usa solo lettere e numeri latini, non usare caratteri speciali.
8. Seleziona la directory in cui vuoi che venga generato il libro, premendo il bottone "...". Dopo aver creato il libri, puoi aprire questa directory cliccando sul link evidenziato.
9. Clicca "Crea!" per generare i libri.

Nota: Il BookReader midlet supporta solamente il file di testo. Per leggere file MS Word devi prima convertirli in formato testo, salvandoli come "Salva con nome..." e seleziona tipo file "solo testo (*.txt).

Il programma genera libri: una coppia di files tipo JAD e JAR, la loro dimensione dipende dalle opzioni e dalla grandezza del testo. Ogni libro è composto da un file JAR ed un file JAD.

Il file JAR è il libro vero e proprio - ognuno include file di testo e il BookReader midlet. In effetti il file JAR sono file zippati con estensione .JAR, e possono essere esaminati con un qualsiasi programma di decompressione (WinZip, WinRar ecc...).
Il file JAD è un piccolo file di testo che descrive le midlets. Generalmente ad ogni file JAR dovrebbe corrispondere un file JAD. Alcuni telefoni però non necessitano del file JAD, ad esempio il SE T6x0 e la famiglia dei Motorola Accompli.

Una volta creato il libro, installalo sul telefono e buona lettura.
Per ulteriori informazioni sull'installazione di midlet leggi il manuale del telefono o qualche forum internet - ci sono molte informazioni in merito. Per alcuni modelli che non supportano l'installazione diretta di midlet Java via cavo, IRDA o BlueTooth, dovresti uploadare i libri in qualche sito WAP e poi downloadarli tramite telefono.

====================================
FAQ (Importante!)
====================================

Perché dividere i file JAR per dimensione o dividerli in capitoli?

I telefoni mobili sono piccole apparecchiature con funzionalità limitate. Fra le limitazioni, la memoria di vari telefoni è piuttosto limitata. Quindi molto spesso i fabbricanti di telefoni, mettono delle restrizioni sulle dimensioni delle applicazioni che possono essere caricate, diverse spesso per ogni modello.

A causa della memoria limitata, vi sono limitazioni sulla grandezza dei testi che possono essere aperti. Se la dimensione di un capitolo è troppo grande, il telefono non riuscirà a caricarlo correttamente, mostrando un file di errore o caricando solo una parte del capitolo.

Per bypassare queste restrizioni, TCBR Shell permette la divisioni in capitoli separati, e per grandezza del file JAR.

Quindi, se hai seguenti problemi:

Problema:
I file JAD e JAR non possono essere installati sul tuo telefono, o non riescono ad essere caricati dopo un installazione completata con successo (con errori tipo "Errore applicazione", "File troppo grande" ecc)

Soluzione 1:
Il file JAR è troppo grande per il tuo telefono - diminuisci la grandezza del file JAR nella tabella opzioni.

Soluzione 2:
Hai scelto la versione midlet sbagliata - per un marca differente, o per un modello differente di telefono. Scegli la versione midlet adatta per il tuo telefono.

Problema:
Il file JAR viene installato correttamente e funziona, ma contiene libri che non possono essere aperti. O, i libri possono essere aperti ma alcune parti del testo non appaiono (il testo non è uguale a textfile.txt all'interno del file JAR)

Soluzione:
I capitoli generati sono troppo grandi per la memoria del tuo telefono. Restringi la dimensione del capitolo nelle opzioni.

Problema:
Ci sono molti capitoli generati, o molti file JAR.

Soluzione:
Hai specificato la dimensione del file in kilobytes (es. 60) ma la dimensione deve essere espressa in bytes (quindi, 60000).

Le dimensioni raccomandate per alcuni telefoni sono:

Nokia S40 (come la maggior parte dei telefoni Nokia) - JAR massimo 64000, capitoli massimo 60000

SonyEricsson T6x0 e Motorola T720 - pare non ci siano limitazioni di grandezza per il file JAR (o 200-300 kilobytes), capitoli massimo 120000-150000.

Se il tuo telefono non è tra quelli sopra riportati, ed hai avuti problemi come quelli appena descritti, prova a fissare un numero adatto alle tue caratteristiche.
Ti sarei grato (anche agli altri utilizzatori di Bookreader) se mi mandassi le dimensioni personalizzate in modo che io le possa elencare qui.



Questo programma è protetto da copyright da TequilaCat, vedi license.txt per i dettagli.

Include altri software gratis (come DLL):
* FreeImage library
* infozip' zip library
* ZipBuilder library creato su infozip' zip library
Grazie ai loro autori, aggiungerò presto le informazioni sulle licenze.
