LL-PORTABLE EDIZIONE 2.21
App per accedere alla Biblioteca Digitale per i Ciechi
Copyright 2011-2023 Giuliano Artico
Pagina Web — Scrivi all'autore
Istruzioni per l'uso

Sommario

0. Presentazione

LL-portable è un'applicazione con interfaccia console in ambiente Windows per la consultazione della Biblioteca Digitale per i Ciechi. Vedere anche le domande frequenti.

LL-portable è una app di tipo portable, cioè non richiede installazione, ed è costituita dal solo file ll.exe.

Al primo avvio, per accedere alla Biblioteca Digitale inserire username e password, dati che per un periodo di 30 giorni non sarà necessario reinserire. Vedere nel seguito le opzioni /U e /Z per scavalcare questo automatismo. Se per qualunque motivo non si dispone momentaneamente delle credenziali, è possibile premere Esc per accedere al modo disconnesso (off-line) che consente soltanto la lettura delle opere già scaricate in sessioni precedenti.

Per ottenere le credenziali occorre iscriversi alla Biblioteca Digitale (per informazioni consultare la pagina Web sopra indicata).

Per il prelievo e l'installazione vedere [6].

Nota. Normalmente l'app LL-portable accede a Internet soltanto per interagire con i server della Biblioteca Digitale per i Ciechi, server che sono provvisti di certificato di sicurezza SSL. Fanno eccezione i comandi per la ricerca in rete di approfondimenti sulle opere in catalogo, come spiegato in [2.5].

Torna al sommario.

1. Utilizzo in breve

Una volta effettuato correttamente l'accesso, sono disponibili tre ambienti.
  1. Generale: ricerca, anteprima, download di opere nell'intero catalogo.
  2. Ultimi arrivi: ricerca, anteprima, download di opere incluse nell'ultimo aggiornamento.
  3. Opere scaricate: accesso alle opere già scaricate in precedenza (questa modalità è l'unica disponibile in caso di mancata autenticazione).
Commutare a rotazione fra i tre modi premendo F2.

Nei modi generale e ultimi arrivi, immettere una stringa di ricerca e battere Invio. la stringa può consistere in una lista di parole o porzioni di parola separate dal carattere spazio: verranno cercate sia nell'autore sia nel titolo le opere che contengono tutti i termini specificati, indipendentemente dall'ordine, dalle maiuscole e dalle lettere accentate (queste ultime sono trattate come le corrispondenti lettere senza accento). Se si preme Invio senza scrivere nulla, vengono selezionate tutte le opere dell'elenco. I criteri di ricerca sono descritti più precisamente in [3].

Dopo aver premuto Invio, si passa alla finestra di scelta e visualizzazione dove compare l'elenco delle corrispondenze trovate. Viene mostrata un'opera per volta e sono disponibili vari comandi per l'interazione con questo elenco. Alcuni comandi importanti sono:

Sono inoltre disponibili alcuni servizi accessori che si possono attivare premendo i tasti da F3 a F8, F11, F12 e Shift+F12. Vedere l'elenco completo dei tasti in [2].

Notare che gli elenchi delle opere vengono automaticamente aggiornati all'occorrenza.

1.1. Collocazione dei libri scaricati

Il termine cartella della app indica la cartella che contiene il file eseguibile ll.exe.
La cartella contenitore dei file scaricati è normalmente la sottocartella download della cartella della app. Un comportamento diverso viene adottato quando il file eseguibile ll.exe si trova nella stessa cartella del programma Lettura libri, cioè se la cartella di installazione di quest'ultimo coincide con la cartella della app. In questa situazione, la app LL-Portable sincronizza i due programmi e fa coincidere il contenitore dei file scaricati con la cartella deposito di Lettura libri: si ha così il vantaggio che i file scaricati con una delle due applicazioni risultano direttamente accessibili anche con l'altra.
Consultare anche il paragrafo 7.1 del manuale di Lettura libri.

1.2. Conversione in audio MP3 e altre elaborazioni delle opere

La visualizzazione delle opere avviene normalmente con la app associata ai file di tipo .txt.
È inoltre possibile elaborare le opere scaricate in diversi modi appoggiandosi ad app esterne.

1.3. Conservazione delle credenziali e configurazioni della app

Al termine di una sessione in cui l'autenticazione è avvenuta correttamente, LL-Portable memorizza una configurazione contenente alcune informazioni che ne consentiranno in seguito il riavvio nello stesso sistema senza dover reinserire le credenziali. Sono possibili due situazioni.
Avvio da unità non removibile (disco fisso)
In questa situazione ha senso un'unica configurazione. La app riconosce il PC in uso in base al numero di serie dell'unità sistema di Windows.
Avvio da unità removibile (pen drive, unità flash, disco USB)
Se la cartella della app si trova in una unità removibile, si può utilizzare la app in due PC, ad esempio un PC fisso e un portatile, e l'autenticazione potrà aver luogo automaticamente in entrambi i PC senza dover reinserire le credenziali, sempre che non si lascino trascorrere più di trenta giorni fra un accesso e l'altro.
Per controllare la configurazione avviare LL-Portable con l'opzione /Z nel modo seguente: 
ll.exe /Z
Si può utilizzare il file batch DTestCfg.bat, contenuto nell'archivio di distribuzione, che deve trovarsi nella cartella della app. Se sono presenti una o più configurazioni, le relative informazioni vengono mostrate a video. Premere Tab e Shift+Tab per passare da una configurazione all'altra, premere Spazio per selezionare la configurazione visualizzata. Alla pressione di Esc la app chiede il consenso per cancellare eventuali configurazioni che sono state selezionate.

Note.

Torna al sommario.

2. Comandi e tasti

Di seguito sono descritti i comandi disponibili in base al contesto.
In tutti i casi, F1 mostra una pagina di aiuto contestuale, F9 apre il manuale completo e Alt+H mostra le variazioni nella versione in uso.
In ogni momento si può variare il volume dei suoni premendo i tasti < (minore) e > (maggiore).

2.1. Immissione delle credenziali

Le credenziali devono essere necessariamente immesse al primo avvio oppure se dall'ultimo utilizzo della app sono trascorsi 30 giorni o più. Per ulteriori particolari v. [1.3]
F1, F9 e Alt+H
Mostrano rispettivamente una pagina di aiuto contestuale, il manuale con le istruzioni complete e le variazioni nella versione in uso.
Invio o Tab
Accetta il valore immesso.
Esc o Alt+F4
Nel campo Username abbandona l'immissione delle credenziali e attiva il modo disconnesso.
Nel campo Password ritorna al campo Username (si può usare anche Shift+Tab).

2.2. Finestra di immissione del criterio di ricerca

F1, F9 e Alt+H
Mostrano rispettivamente una pagina di aiuto contestuale, il manuale con le istruzioni complete e le variazioni nella versione in uso.
Shift+F1
Aiuto iniziale.
F2 Commuta a rotazione fra i tre ambienti ricerca generale, ricerca ultimi arrivi e opere scaricate.
Da F5 a F8, F11, F12, Shift+F12
Attivano i servizi accessori descritti in [2.4].
Invio
Avvia la ricerca delle opere.
Esc o Alt+F4
Uscita dalla app (il tasto dovrà poi essere premuto nuovamente per confermare).

2.3. Finestra di scelta e visualizzazione

F1, F9 e Alt+H
Mostrano rispettivamente una pagina di aiuto contestuale, il manuale con le istruzioni complete e le variazioni nella versione in uso.
Shift+F1
Aiuto iniziale.
Invio
Visualizza l'opera selezionata, proponendone lo scaricamento se essa non è già stata acquisita in precedenza).
Tab/Shift+Tab
Opera successiva/precedente.
Lo stesso con i tasti -/+ oppure PgDn/PgUp.
I tasti possono essere premuti a lungo per uno scorrimento rapido.
Ctrl+PgDn/Ctrl+PgUp
Salto avanti/indietro di un numero di opere commisurato alla quantità di risultati.
Freccia su/giù
Spostamento verticale del cursore.
F4/Shift+F4
Salto all'autore successivo/precedente.
F5/Shift+F5
Salto alla lettera iniziale dell'autore successiva/precedente.
F10
Visualizza l'anteprima dell'opera.
Ctrl+Invio
Conversione dell'opera in formato audio MP3, vedere l'opzione /T [4.2].
Ctrl+F1 ... Ctrl+F10
Elaborazione dell'opera con una delle app assegnate nel file di inizializzazione ll.ini [4.1].
Ctrl+Canc
Ripristino del file di inizializzazione predefinito.
Lettera A-Z
Salto al primo autore che inizia con la lettera indicata.
Cifre 0-9
Digitando da una a sei cifre e subito dopo il tasto Invio, si salta all'opera che ha numero d'ordine uguale al numero composto da tali cifre (le cifre non compaiono a schermo).
Alt+D, Alt+G, Alt+L
Ricerca di informazioni sull'opera visualizzata rispettivamente con DuckDuckGo, Google, Google libri.

2.4. Servizi accessori

Nella schermata di ricerca e in quella di scelta e visualizzazione sono disponibili alcuni servizi forniti dai server della Biblioteca Digitale, ai quali la app si collega mediante il browser predefinito. I servizi sono associati ai tasti funzione elencati nel prospetto che segue.
F3
Informazioni generali sulla Biblioteca Digitale per i Ciechi.
F4
Nella finestra di ricerca apre la Biblioteca Digitale per i Ciechi, versione Web.
Nella finestra di scelta e visualizzazione seleziona l'autore successivo.
F5
Nella finestra di ricerca apre il ricettario di cucina della Biblioteca Digitale, una raccolta contenente quasi 30.000 ricette organizzate per categoria.
Nella finestra di scelta e visualizzazione seleziona la lettera successiva.
F6
Suggerimenti e informazioni per l'uso di dispositivi con tecnologia assistiva.
F7
Supplementi della Biblioteca Digitale. Dalla finestra di immissione viene aperto l'elenco degli autori provvisti di supplementi, da quella di visualizzazione opere vengono mostrati eventuali supplementi dell'autore selezionato.
F8
Notizie e avvisi per gli iscritti.
F10
Nella finestra di ricerca apre la cronistoria della Biblioteca Digitale.
Nella finestra di scelta e visualizzazione apre l'anteprima.
F11
Statistiche personali di accesso e utilizzo.
F12
Home page di LL-portable.
Shift+F12
Domande frequenti sulla Biblioteca Digitale (FAQ).

2.5. Risorse esterne alla Biblioteca Digitale per i Ciechi

(nella finestra di scelta e visualizzazione sono disponibili alcuni comandi per cercare in rete approfondimenti sull'opera visualizzata: premere Alt+D, Alt+G, Alt+L per interrogare rispettivamente i motori di ricerca DuckDuckGo, Google, Google libri.

Viene chiesta all'utilizzatore l'approvazione per poter accedere a queste risorse esterne alla Biblioteca Digitale: premere S se si desidera acconsentire. Successivamente, se per 30 giorni non si utilizza nessuna di queste risorse, il consenso viene azzerato e dovrà essere espresso nuovamente.

Torna al sommario.

3. Ricerca delle opere

La stringa per impostare il criterio di ricerca può essere specificata digitando semplicemente uno o più termini oppure facendo ricorso alle espressioni regolari. Notare che non è assolutamente necessario conoscere le espressioni regolari ma, quando si vuole, si può farne uso e si può ottenere una ricerca anche molto sofisticata. I paragrafi che seguono descrivono le varie possibilità, le quali consentono un'accuratezza dei risultati via via crescente.

3.1. Ricerca semplice

Scrivere una lista di termini (se si specificano due o più termini, essi vanno separati con spazio). Verranno individuate le opere che, nell'autore o nel titolo, contengono tutti i termini indicati. I termini possono essere parole intere o porzioni di parola. Vengono applicate le regole indicate di seguito.
  1. I termini sono cercati in qualunque posizione. Ad esempio, inserendo vita si ottiene Vita di Dante e anche Malavita.
  2. Si possono usare indifferentemente caratteri maiuscoli e minuscoli. Ad esempio, è lo stesso scrivere Dante o dante.
  3. Le lettere accentate equivalgono alle stesse senza accento. Ad esempio, è lo stesso scrivere verità o verita.
  4. Se la stringa è composta da due o più termini, vengono cercate le occorrenze che contengono tutti i termini, indipendentemente dall'ordine in cui vengono immessi. Ad esempio, alighieri dante e dante alighieri trovano gli stessi risultati.

3.2. Distinzione fra autore e titolo

È possibile effettuare la ricerca separatamente per autore e per titolo e specificare termini distinti per l'uno e l'altro. Anche in questo caso i termini vanno scritti di seguito nella stessa riga, separando con il carattere «:» (due punti) quelli che si riferiscono all'autore da quelli che si riferiscono al titolo. In pratica, il carattere di separazione spezza idealmente i dati in due campi distinti e i termini vengono raggruppati in due sottoliste, potendo una delle due essere vuota.
Ad esempio, cercando dante: si troverà l'autore Dante Alighieri (ma non il titolo Il viandante musicale), mentre con :dante si trova la seconda voce.

3.3. Ricerca mediante espressioni regolari

È possibile impiegare un'espressione regolare, in luogo di una stringa composta da termini ordinari, allo scopo di eseguire ricerche più mirate. Fra poco descriveremo le regole adottate da questa ap , che sono quelle più convenzionali. Per informazioni complete sulle espressioni regolari si può consultare ad esempio Wikipedia.

3.4. Combinazione complessa

Anche con le espressioni regolari è possibile distinguere la ricerca per autore da quella per titolo. Basta specificare due espressioni separandole, come nel caso semplice, con il carattere «:» (due punti), la prima relativa all'autore, la seconda al titolo.

È infine possibile combinare le due tecniche descritte, specificando per l'autore un'espressione regolare e per il titolo una lista di termini (o viceversa).

3.5. Caratteri nelle espressioni regolari

Nelle espressioni regolari ci sono alcuni caratteri che hanno significato letterale (lettere, numeri, il carattere di sottolineatura «_»), altri che hanno un ruolo sintattico. In molti casi i caratteri non alfanumerici vanno preceduti da «\» (barra inversa) per mantenere il significato letterale, ad esempio per indicare un punto si deve scrivere «\.».

3.6. Ricerca all'inizio del campo

Per cercare un termine all'inizio del campo, anteporre il carattere «^».
Esempi.

3.7. Ricerca alla fine del campo

Per cercare un termine alla fine del campo posporre il carattere «$». Ad esempio, per cercare "natale alla fine del campo: 
natale$

3.8. Quantificatori

I quantificatori si applicano al carattere o al simbolo che li precede immediatamente a sinistra. Si possono usare i seguenti quantificatori:
* significa un numero arbitrario (0 o più)
+ significa almeno uno (1 o più)
? significa al massimo uno (0 o 1)
In particolare, l'espressione .* (punto seguito da asterisco) significa una stringa arbitraria perché il punto indica un carattere qualsiasi.
Esempi.

3.9. Classe di caratteri

Due o più caratteri fra parentesi quadre definiscono una classe di caratteri. Tutti i caratteri indicati costituiscono possibili alternative. Ad esempio indicando la seguente espressione 
p[aeo]lo
si trovano le parole palo, pelo e polo.
Si può anche indicare un intervallo come [a-g], che equivale a [abcdefg].
Si può combinare una classe di caratteri con i simboli descritti più sopra. Ad esempio, per cercare gli autori che hanno come iniziale una lettera fra C e L e come finale la G: 
^[c-l].*g$

3.10. Ricerca di parole esatte

Il simbolo \b indica il bordo di una parola, quindi può rappresentare l'inizio o la fine del campo oppure un carattere non alfabetico. Ad esempio, per cercare vera come intera parola (escludendo ad esempio veramente o primavera): 
\bvera\b

3.11. Altre espressioni

Sono possibili espressioni più complicate. Ad esempio, l'espressione seguente trova i campi contenenti esattamente due parole separate da uno spazio: 
^\w+\s\w+$
Significato dei simboli nella precedente espressione:
\w indica un carattere word (di parola), cioè alfanumerico o «_»;
+ uno o più caratteri, quindi \w+ indica una parola;
\s carattere spazio.

Torna al sommario.

4. Personalizzazione

4.1. File di inizializzazione ll.ini

Il file di inizializzazione ll.ini è un file di testo che consente di personalizzare alcune impostazioni. In questo paragrafo vengono descritti il formato del file e le regole per il suo utilizzo.

La posizione del file di inizializzazione è determinata con gli stessi criteri dei file di configurazione [1.3].

Il file di inizializzazione predefinito viene generato al primo avvio della app. La prima riga del file contiene la stringa identificativa [LL-Portable]. Non è consentito modificare questa riga, pena il ripristino automatico del file predefinito. La seconda riga contiene una data nel formato [GG/MM/AAAA], riferimento temporale puramente indicativo che potrà variare se in futuro dovessero essere apportate modifiche al formato del file. Se una riga inizia con il carattere #, ciò che segue è un commento o una spiegazione che non incide sul funzionamento. Le righe rimanenti contengono comandi con la seguente struttura: 

Chiave = valore
CApp* = [:]NomeProg [Parametri]
Con le chiavi CApp1 ... CApp10 si definiscono le app che verranno avviate rispettivamente con i tasti Ctrl+F1 ... Ctrl+F10 nella finestra di scelta e visualizzazione [2.3]. L'utilizzatore può modificare, disporre in diverso ordine o cancellare le definizioni preimpostate nel file di inizializzazione predefinito, in base alle app installate nel proprio sistema. Il paragrafo [4.1.1] contiene alcune informazioni sulle app predefinite.
La sintassi e i termini che la compongono sono descritti qui di seguito.
  1. Il carattere * nella chiave sta a indicare un numero compreso fra 1 e 10.
  2. Il carattere facoltativo «:» all'inizio del valore forza l'uso della chiamata sincrona: di solito è ininfluente per le app di tipo GUI ma deve essere senz'altro omesso se NomeProg è una app di tipo console.
  3. L'estensione di NomeProg può essere .exe, .bat oppure .vbs.
  4. Il termine NomeProg può includere un percorso completo e può essere racchiuso fra virgolette. Le virgolette sono obbligatorie se la stringa contiene spazi.
  5. Se NomeProg è specificato con il semplice nome senza percorso, viene fatta una scansione per individuare la posizione dell'eseguibile. La ricerca avviene nelle cartelle indicate di seguito e nelle loro sottocartelle al primo livello:
    • programmi a 32 e 64 bit,
    • cartelle presenti nel PATH di sistema,
    • cartella dei file di tipo portable, v. la chiave CPortable del file ll.ini,
    • cartelle il cui nome inizia con UT in tutte le unità esistenti (ut, util, utility, eccetera).
  6. Se la componente Parametri è vuota, si assume per default il valore %f.
  7. Nei parametri si possono includere alcuni simboli speciali, che sono adoperati da LL-Portable come variabili (le lettere sono obbligatoriamente minuscole):
    • %f = percorso completo del file da elaborare,
    • %n = nome del file senza estensione,
    • %p = percorso completo della cartella che contiene il file,
    • %w = cartella di lavoro,
    • %x = estensione del file.
    Eventuali virgolette che racchiudono i simboli sono eliminate e verranno ripristinate all'occorrenza al momento dell'elaborazione.
  8. Se nel comando sono incluse variabili di ambiente, almeno il primo carattere a destra di % deve essere maiuscolo, qualora coincida con uno di quelli utilizzati nei simboli speciali. Per semplicità, le eventuali variabili di ambiente possono essere scritte interamente in maiuscolo.
CPortable=d:\portable
A destra dell'uguale specificare una cartella facoltativa, già esistente nel sistema, alla quale verrà estesa la scansione per cercare le app specificate con le chiavi CApp*. Il nome predefinito è d:\portable.
CUser=
Nome utente per l'accesso alla Biblioteca Digitale. Questa chiave può essere utile per specificare il nome utente quando la cartella della app si trova in una unità removibile che contiene già due configurazioni incompatibili con il PC in uso. In tal caso le credenziali dovranno essere immesse ogni volta e al termine dell'esecuzione non verrà né memorizzata né aggiornata alcuna configurazione. Lo stesso effetto si può ottenere utilizzando l'opzione /U.

4.1.1. App predefinite

Questo paragrafo contiene alcune informazioni sulle app preimpostate nel file di inizializzazione predefinito. Eccezion fatta per quelle incluse in Windows, le app qui utilizzate sono tutte gratuite.
Nota. Le app DSpeech e TestiMp3 citate qui di seguito, abbinate ai tasti Ctrl+F1 e Ctrl+F3, eseguono la conversione in MP3 in modo non interattivo. I rispettivi archivi devono essere decompressi in una cartella visibile alla app LL-Portable, secondo i criteri illustrati in [4.1]. Ad esempio, sono buone posizioni le cartelle C:\util e d:\portable. In questi due casi, i file MP3 risultanti dalla conversione verranno posti in una sottocartella, con nome uguale a quello del file elaborato, all'interno della cartella in cui si trova l'eseguibile.
DSpeech
App che riunisce funzioni di editor e di TTS (Text-To-Speech), capace cioè di trasformare file di testo in parlato e in file MP3o in altri formati audio, è pratico da usare, ricco di funzioni, non richiede installazione. Vengono proposte due varianti: Ctrl+F1 avvia direttamente la conversione in MP3, Ctrl+F4 avvia una sessione interattiva che consente sia di editare il file sia di effettuare altre manipolazioni.
Biblos,
App freeware, in italiano, con funzioni molto utili per non vedenti. In particolare, è possibile convertire i testi in file audio MP3.
TestiMp3, versione portable
TestiMp3 è il noto programma di Francesco Tranfaglia per convertire file di testo in audio MP3. Dato che il sito originale dell'autore non è attualmente raggiungibile in rete, gli archivi sono stati resi disponibili in un altro spazio Web. Se si preferisce si può utilizzare la versione installabile, ma in questo caso occorrerà adattare opportunamente la definizione nella chiave CApp3 includendo il percorso completo del file eseguibile.
PSPad
Editor freeware, portable con menù in italiano, con capacità di editing di eccellente qualità.
GMEditor
Editor di tipo portable e di uso molto semplice, realizzato da Guido Melani. Questa app è già inclusa nel pacchetto Lettura libri, ma può essere utilizzata in modo autonomo.
Notepad++
Senza dubbio uno dei migliori e più completi editor oggi disponibili per Windows.
Notepad
Il Blocco note di Windows. Pur avendo il pregio di essere sempre disponibile, questa app ha il difetto di non conservare la posizione nel file fra una sessione e l'altra, funzione che è presente in tutte le app indicate più sopra.
Write
WordPad, il programma di videoscrittura incorporato in Windows. Vale la stessa considerazione fatta più sopra per il Blocco Note.

4.2. Opzioni di avvio

La sintassi di avvio della app LL-portable è la seguente: 
ll.exe [/?] [/C] [/N] [/S volume] [/U[username]] [/Z] [/T...]

Tutte le opzioni sono facoltative e possono essere specificate, ad esempio, in un file batch o nelle proprietà del collegamento della app.
Qualunque opzione può essere specificata anche nella variabile di ambiente LL-PORTABLE ma in ogni caso ha priorità il valore assegnato nella riga di comando o nel collegamento.
/?
Mostra la sintassi di avvio e alcune brevi spiegazioni.
/C
Fornisce le informazioni sulla configurazione attuale, comprendenti la cartella di download, il nome utente del PC, l'username della Biblioteca Digitale, l'ultima data di accesso alla stessa con la app LL-Portable e l'elenco delle app abbinate ai tasti Ctrl+F1 ... Ctrl+F10. I dati vengono memorizzati nel file ll-log.txt.
/N
Se si specifica questa opzione, qualora il certificato SSL non possa essere verificato, la connessione avviene ugualmente ignorando il certificato stesso.
/S volume
Imposta l'intensità delle segnalazioni acustiche espressa in percentuale. Indicare un valore numerico compreso fra 0 e 100, dove il valore 0 implica la soppressione dei suoni. Il valore predefinito è 25.
Esempio: ll.exe /S15
/T[:]NomeProg [Parametri]
Specifica una app da eseguire quando si preme Ctrl+Invio, in sostituzione della app predefinita TestoToMP3 che effettua la conversione in formato audio MP3.
Il significato dei termini a destra di /T è identico a quello per le chiavi CApp* del file di inizializzazione ll.ini [4.1].
L'opzione /T deve essere sempre specificata per ultima, tanto nella riga di comando quanto nella variabile di ambiente LL-PORTABLE.
/U[username]
Questa opzione permette di specificare il nome utente. Essa è utile quando la cartella della app si trova in una unità removibile che contiene già due configurazioni incompatibili con il PC in uso. Se si specifica questa opzione, al termine della sessione la app non memorizza le credenziali e non mostra alcun messaggio di errore. L'opzione /U può anche essere utilizzata da sola, senza indicare l'username.
/Z
Questa opzione apre una schermata che mostra le configurazioni esistenti e ne consente l'eventuale cancellazione.

Torna al sommario.

5. Licenza per l'uso e l'accesso ai servizi

Gli utenti iscritti alla Biblioteca Digitale per i Ciechi possono utilizzare liberamente la app LL-portable. Come per gli altri metodi di accesso, non è richiesto alcun costo né di attivazione né di abbonamento.
Chiunque scarica o utilizza la app LL-portable accetta e si impegna a rispettare integralmente il regolamento della Biblioteca Digitale per i Ciechi:. Chi è in disaccordo anche con una sola delle condizioni deve rinunciare a qualunque impiego di questo software.

Gli interessati possono consultare le informazioni generali e le domande frequenti sulla Biblioteca Digitale per i Ciechi.

Nota bene.
La app LL-portable è stata realizzata da Giuliano Artico.
Il software è distribuito «com'è»: se decidete di usarlo, lo fate a vostro rischio. L'autore declina ogni responsabilità per eventuali conseguenze riconducibili in qualunque modo a questo software e a qualunque elemento ad esso associato, ivi incluse le procedure lato server con cui esso dialoga. L'utilizzatore assume implicitamente in modo completo e in prima persona tale responsabilità nel momento in cui avvia la app o inizia a servirsene e non potrà rivalersi in alcuna forma né sull'autore né su soggetti a lui collegati per danni o conseguenze di qualunque natura, reali o presunti, che si possano far risalire direttamente o indirettamente all'uso di questo software.

Torna al sommario.

6. Download e osservazioni

La app LL-portable viene distribuita mediante un archivio compresso di tipo Zip, scaricabile gratuitamente al seguente indirizzo:
https://www.bdciechi.it/ll/
Decomprimere l'archivio in una cartella abilitata in scrittura, anche in un'unità removibile. Non collocare mai i file direttamente nella radice dell'unità e utilizzare un percorso non troppo annidato (si consiglia un percorso con lunghezza complessiva non superiore a 70-80 caratteri). La cartella non può trovarsi nei programmi a 64 bit, mentre nei programmi a 32 bit è ammessa solo la cartella in cui è installata la app Lettura libri.
Può essere utile porre sul desktop un collegamento a ll.exe per facilitarne l'avvio.

Vengono estratti i file seguenti:

6.1. Osservazioni sul sistema operativo e sulla sicurezza

La app LL-portable può essere utilizzata nelle versioni di Windows a partire da Windows XP. A seconda della versione, occorre tenere presenti le seguenti considerazioni.
File wget.exe in Windows XP
NOTA IMPORTANTE. L'utilizzo di un PC in Windows XP espone a gravi rischi di sicurezza che possono comportare la compromissione dei propri dati personali, oltre al funzionamento del PC stesso, tutte le volte che con esso si accede a Internet (anche quando banalmente si apre un allegato di un messaggio e-mail). Si raccomanda caldamente di aggiornare l'hardware e il sistema, per poter usufruire delle misure di sicurezza indispensabili su tutti i dispositivi collegati alla rete.
Premesso quanto sopra, si avvisa che il file wget.exe incluso nell'archivio di distribuzione è utilizzabile in Windows a partire dalla versione 7. Per utilizzare LL-portable in Windows XP occorre sostituire wget.exe con la versione adatta a tale sistema. Le due versioni e la relativa documentazione sono reperibili da varie fonti, ad esempio scaricando il seguente archivio:
wget.zip
Console legacy in Windows 7 o versione successiva
Può accadere che lo screen reader in sintesi vocale JAWS non reciti spontaneamente le scritte prodotte da LL-portable (ciò può riguardare in generale tutti gli applicativi di tipo console). Se questo è il caso, per ripristinare il funzionamento desiderato, avviare la app (o equivalentemente il prompt di Windows), premere Alt+Spazio e con le frecce verticali andare alla voce Predefinite premendo poi Invio. Quindi, mediante Tab, andare a Usa console legacy e attivare questa casella (che normalmente è deselezionata), premendo infine Ok per accettare. Al successivo avvio di LL-portable, o di qualunque altra app in modalità console, la sintesi vocale funzionerà regolarmente.
Blocco della app da parte dell'antivirus
Può accadere che l'antivirus blocchi LL-Portable, come avviene anche per molte altre app, perché le attribuisce una bassa reputazione in quanto poco conosciuta. In questi casi occorre fare opportune impostazioni, che sono specifiche per ciascun antivirus, ad esempio definendo un'eccezione per la app o abilitando l'accesso alla cartella che la contiene.
Verifica del certificato SSL
È stato segnalato qualche raro caso in cui la app LL-Portable non funziona perché l'agent wget.exe non riesce a verificare la validità del certificato di sicurezza SSL. Questo fatto è imputabile a svariati fattori (caratteristiche del PC, della rete in uso, del software antivirus, eccetera).
Allo scopo di consentire l'utilizzo anche in questo caso,, è possibile avviare la app con l'opzione /N, in presenza della quale l'accesso avviene tralasciando la verifica del certificato SSL.
Ricordiamo che la app LL-Portable, oltre che ai server della Biblioteca Digitale, si può collegare solo ai motori di ricerca citati in [2.5].

Torna al sommario.

7. Variazioni

In questa sezione sono riportate le modifiche della app rispetto alle versioni precedenti.

Variazioni nella versione 2.21

  1. L'aiuto contestuale (tasto F1) è una pagina più esauriente e meglio organizzata. Essa contiene inoltre vari link per accedere alle risorse della Biblioteca Digitale.
  2. Shift+F1 ora apre l'aiuto iniziale (la stessa schermata che si ottiene con F1 nella finestra di immissione credenziali).
  3. F12 ora apre la home page di LL-portable.
  4. Shift+F12 apre la pagina delle Domande frequenti.
  5. Alt+H mostra le variazioni nella versione in uso.
  6. Nel file ausiliario TestCfg.bat corretto un banale errore che impediva l'avvio della app.

Variazioni nella versione 2.20

  1. Introdotto il file di inizializzazione LL.ini, utile per effettuare alcune personalizzazioni [4.1]. Al primo avvio della app viene generato il file di inizializzazione predefinito.
  2. Il nuovo comando Ctrl+Invio per impostazione predefinita effettua la conversione del testo in formato audio MP3 mediante TestoToMP3, app che può essere sostituita con un'altra a piacere mediante l'opzione /T [1.2].
  3. Aggiunti i nuovi comandi Ctrl+F1 ... Ctrl+F10 per elaborare le opere con altrettante app che possono essere impostate liberamente utilizzando il file di inizializzazione ll.ini.
  4. Premendo Invio per elaborare un file già esistente, ora non viene più chiesto il consenso.
  5. Qualunque opzione può essere ora specificata mediante la variabile di ambiente LL-PORTABLE. Ha priorità il valore assegnato da riga di comando.
  6. Corretti i difetti indicati di seguito.
    a) Nel caso di app collocata in un'unità non removibile, non veniva generata la sottocartella download e le opere scaricate non venivano poste nella posizione descritta dal manuale ma, ad esempio, nella cartella deposito di Lettura libri.
    b) Eliminato il difetto di visualizzazione che si verificava dopo aver utilizzato F1 o Shift+F1.

Variazioni nella versione 2.10

  1. In ogni momento è possibile variare il volume dei suoni premendo i tasti < (minore) e > (maggiore).
  2. Questo punto e i successivi riguardano solo la finestra di scelta e visualizzazione.
    Sono state aggiunte nuove combinazioni di tasti per cercare con i motori di ricerca informazioni sull'opera visualizzata: Alt+D cerca con DuckDuckGo, Alt+G cerca con Google, Alt+L cerca con Google libri. [2.5].
  3. Ora è possibile selezionare un'opera indicandone il numero d'ordine: a tal fine, digitare da una a sei cifre e subito dopo il tasto Invio. Notare che le cifre non vengono visualizzate [2.3].
  4. Per visualizzare l'opera precedente e successiva, ora si possono usare anche i tasti - (meno) e + (più) [2.3].

Variazioni nella versione 2.0

  1. A partire dalla versione 2.0 le credenziali, una volta inserite, vengono conservate e l'autenticazione è automatica per un periodo di trenta giorni (se si lasciano trascorrere trenta giorni senza utilizzare la app, le credenziali dovranno essere reinserite). In caso di avvio da unità removibile, sono ammesse due configurazioni distinte, ad esempio per il PC fisso e per il portatile, in modo da consentire l'avvio della app in entrambi senza dover reimmettere le credenziali [1.3].
  2. Per esaminare lo stato delle configurazioni utilizzare una delle opzioni /C oppure /Z [4]. Con /Z si possono controllare anche eventuali configurazioni non compatibili con il sistema in uso ed eventualmente cancellare quelle che non interessano.
  3. Aggiunti alcuni servizi accessori attivabili con i tasti da F3 a F8, F11 e F12 (informazioni,FAQ, ricettario di cucina, statistiche, eccetera) [2.4].
  4. Specificando da riga di comando l'opzione /N, qualora il certificato SSL non possa essere verificato, la connessione avviene ugualmente ignorando il certificato stesso.
  5. Anche in Windows XP, se si presenta la difficoltà di cui al punto precedente, ora l'opzione /N deve essere specificata esplicitamente (nelle versioni precedenti di LL-Portable, in Windows XP l'applicazione ignorava automaticamente la verifica del certificato qualora si presentassero problemi per la sua verifica).
  6. Aggiunti all'inizio dell'anteprima (tasto F10) il titolo e la grandezza dell'opera.

Variazioni nella versione 1.21

Corretto un difetto a causa del quale la app poteva scaricare le opere da salottopertutti.it solo se avviata da una cartella con percorso molto breve.

Variazioni nella versione 1.20

Utilizzare la versione 1.20 se il file ll.exe è stato posto nella stessa cartella del programma Lettura libri. In questo modo le opere scaricate con ciascuna delle due app potranno essere aperte anche con l'altra.

Variazioni nella versione 1.11

  1. Chi ha scaricato la versione 1.1 datata 6/5/2022 è pregato di sostituirla con la versione 1.11 perché si trattava di un file di prova che è stato rilasciato per errore.
  2. Con la versione 1.0 l'avviso di disponibilità di una versione aggiornata non funziona correttamente (la app non apre la pagina per effettuare il download). Il problema è stato corretto nella versione 1.1.
  3. Se il file ll.exe versione 1.0 si trova in una cartella con nome particolarmente lungo, si riceve il messaggio 6 Formato della richiesta non valido al momento di scaricare un libro o di visualizzare un'anteprima. Il difetto è stato attenuato. In ogni caso, in questa versione la lunghezza complessiva del percorso, compresa la lettera di unità, non deve superare 60 caratteri.
  4. Fermo restando quanto precisato in [6.1], la app LL-portable può essere utilizzata in Windows XP.

Torna al sommario.