Istruzioni per l’utente


Indice:


Obiettivo

Le Scienze 500 for Linux, è un software sviluppato sotto Linux con una GUI qt che come obbiettivo ha quello di ricercare gli articoli dei DVD dei 500 di Le Scienze (acquistabili in edicola per 14.90 euro) nel modo più semplice ed intuitivo possibile.

Con questo software potrete comodamente navigare fra i vecchi numeri di Le Scienze visualizzando le copertine e gli indici. Salvare in un bookmark i vostri articoli preferiti commentandoli e valutandoli e con la possibilità di segnare gli articoli che si stanno  leggendo.

Rispetto al software per windows questa variante permette di cercare gli articoli senza avere inserito i DVD e permette di definire un qualsiasi percorso per i PDF degli articoli; ad esempio li potete copiare su un HD esterno o su una chiavetta USB.


Per cominciare:

L’utente, per prima cosa, ha bisogno del pachetto da installare o dell’applicativo da compilare.
Se sei un utente Ubuntu leggi questa sezione: Come compilare e creare il pacchetto deb  con Ubuntu
Se sei un utente ArchLinux visita la pagina su AUR: Le Scienze 500 – AUR.
Se sei un utente Fedora segui le istruzioni nella sezione: Come compilare con Fedora.
Se sei un utente Mandriva vedi questo post sul forum di Mandriva.
Se sei un utente Slackware puoi usare questo Slackbuild oppure usare il pachetto nel repository di www.slacky.eu.

Per tutte le altre distribuzioni seguire le istruzioni di compilazione generiche.
Gli utenti ArchLinux che usano yaourt possono installare direttamente col comando: yaourt -Sb lescienze500
Gli utenti delle distribuzioni basate su RPM come OpenSuse, Fedora o Mandriva possono basarsi sul pacchetto dei sorgeti reperibile sul forum di Mandriva.

I dati delle riviste:
Tutti i dati sulle riviste si trovano in un database denominato LeScienze.db e tutte le copertine si trovano in una cartella contenete tutte le immagini.
Per chi avvesse un installazione con dual-boot Linux-Windows puo tranqullamente usare i files dell’installazione Windows.
Che si trovano in:
C:\Program Files\Le Scienze – 500 Numeri\data\LeScienze.db
C:\Program Files\Le Scienze – 500 Numeri\copertine\
o nella cartella equivalente.

Quindi dovete configurare l’applicativo LeScienze500 in modo che vada a leggere i dati sulla partizione di Windows.

Nel caso vogliate estrarre i dati dal DVD-1 direttamente da Linux leggete questa sezione: Il comando estrai_dati



Compilazione ed avvio

Per la compilazione e l’utilizzo è necessario installare  i packages qt e sqllite3.

In alcune distribuzioni, come Fedora, potrebbe essere necessario l’uso del comando
qmake-qt4 al posto di qmake Questo comando è stato introdotto per garantire la compatibilità con la Qt3.

Una volta scaricato il pacchetto eseguire questi comandi da terminale per compilare ed avviare il software.

Entrare nella cartella dove è stato scaricato il pacchetto lescienze500-1.3.6.tar.gz e dare i seguenti comandi da shell (terminale):

Metodo di compilazione generico indipendente dall’architettura:

comandi shell:

> tar xvzf lescienze500-1.3.6.tar.gz
> cd lescienze500-1.3.6
> qmake -spec linux-g++ -r
> make
avviare con:
> ./LeScienze500

Nel caso si volesse installare bisogna dare il comando:

> make install

Coi permessi di root.
Linstallazione con questa procedura è sconsigliata e va usata solo per generare i packages per la varie distribuzioni.

Una volta installato sul menu delle applicazioni guardare nella sezione ufficio o Educazione>varie dove si trova l’icona dell’applicativo.


Guida all’uso

Dopo Il primo avvio compare un finestra di errore di connessione al database la si deve chiudere e selezionare dal menu: Le Scienze 500configura.

Una volta comparsa la finestra di configurazione per prima cosa selezionate il vostro visualizzatore PDF preferito.

Cliccate sul secondo tab per selezionare il percorso dei files con tutti gli articoli, sono due percorsi come ci sono due i DVD. Gli articoli si trovano nelle carettele articoli all’interno dei due DVD e se si ha spazio a sufficienza si possono copiare sul disco rigido.

I due percorsi possono essere uguali e possono corrispondere al punto di montaggio dei DVD.

Sul terzo tab dovete configurare il percorso del file LeScienze.db.

Questo file lo si può prendere dall’installazione windows nella directory:

C:\Program Files\Le Scienze – 500 Numeri\data\ o nella directory equivalente (cambia su win XP e win 7) e non è da escludere che il file sia nascosto.

Oppure lo si puo estrarre direttamente da Linux usando la procedura descritta nella sezione seguente.
Se tutto va bene una volta cliccato su OK si devono riempire le tabelle di ricerca.

Sul quarto tab potete definire il percorso della directory delle copertine; nell’installazione windows questo file lo si trova nella directory:

C:\Program Files\Le Scienze – 500 Numeri\copertine\

Nella ricerca estesa al testo le frasi vanno inserite fra virgolette; ad esempio per cercare la coppia di parole galassia nana si deve scrivere nel campo di ricerca: “galassia nana”


Il comando estrai dati

Per poter eseguire questo script è necessario installare nel proprio sistema il gestore di panchetti 7zip.

Nella sottodirectory estrai_dati è stato inserito lo script estrai_dati.bash che procede all’estrazione automatica delle copertine e del database direttamente dal DVD-1.
L’uso è semplicissimo:

  • Inserire in DVD-1 dei 500 numeri.
  • Entrare nella directory estrai_dati  > cd estrai_dati
  • dare il comando ./estrai_dati.bash
  • Leggere ed accettare le avvertenze
  • accertare come directory di destinazione $HOME/lescienze500-data (oppure modificarla).
  • Aspettare che la procedura sia terminata.

In alternativa si può scaricare lo script estrai_dati.bash direttamente a questo link:
https://sourceforge.net/projects/lescienze500/files/Risosrse/estrai_dati.bash/download

e dopo essere entrati nella directory di download,
avviarlo col comando > bash estrai_dati.bash

quindi seguire la stessa procedura descritta sopra.

Una volta finito nella directory $HOME/lescienze500-data troverete le cartelle:  copertine e data che contengono le immagini delle copertine e il database LeScienze.db.
Configurate l’applicativo coi nuovi percorsi.



Come compilare e creare il pacchetto deb  con Ubuntu

Per la pacchettizzazione sotto Ubuntu è necessario installare questi pachetti:

sudo apt-get install devscripts dh-make make build-essential dpkg apt

Ed ovviamente dovrete pure installare  le dipendenze di compilazione per il progetto Le Scienze 500,

ovvero libqt4-dev libsqlite3-dev.

sudo apt-get install libqt4-dev libsqlite3-dev

Per prima cosa è necessario scaricare i sorgenti ed estrarre il pacchetto:

tar xvzf lescienze500-1.3.6.tar.gz
cd  lescienze500-1.3.6

In seguito preparare il pacchetto col comando dh_make

dh_make -e vostro@indirizzo -n -copyright gpl

Se lo ritenete opportuno mettete il vostro e-mail
dh_make termina con un avviso di warning, nessun problema, dovete solo definire un paio di variabili d’ambiente e costruire il makefile dando i comandi:

export CFLAGS="-Wall -g -O2"
qmake  ./LeScienze500.pro -r -spec linux-g++

Adesso è tutto pronto per la compilazione finale e la fabbricazione del pacchetto definitivo, semplicemente dando il comando.

debuild binary

Il pacchetto proto per l’uso si trova nella directory superiore quindi dare i comandi:

cd ..
sudo dpkg -i lescienze500_1.3.6_i386.deb

Una volta installato la entry dell’applicativo la troverete nel menu applicazioni nella sezione ufficio oppure nella sezione educazione scienza.


Come compilare con Fedora

Installare i pachetti: sqlite-devel qt4-devel
Coi comandi:

> yum install sqlite-devel
> yum install qt4-devel

quindi eseguire questi comandi, partendo dal pachetto di base.

> tar xvzf lescienze500-1.3.6.tar.gz
> cd lescienze500-1.3.6
> qmake-qt4 -spec linux-g++ -r
> make
avviare con:
> ./LeScienze500

Per ulteriori osservazioni leggere la sezione: Compilazione ed avvio


Come compilare sotto windows

  • Cosa serve:

Per prima cosa si deve scaricare l’ambiente di sviluppo Qt4 direttamente dal sito di Nokia, usare la versione LGPL:
http://qt.nokia.com/downloads

Installare tutto l’ambiente di sviluppo.

Scaricare la versione corrente o da SVN i sorgenti de l’applicativo Le Scienze 500.

Scaricare da http://www.sqlite.org/download.html il pacchetto sqlite-amalgamation.

  • Procedimento di compilazione:

Aprire i sorgenti di Le Scienze 500 in una directory qualsiasi.
Aprire il pacchetto di sqlite3 e copiare i files sqlite3.c e sqlite3.h nella sottodirectory src\sqlite all’interno della directory del progetto.
Lanciare Qt Creator e aprire il progetto lescienze500.pro.
Compilare e avviare.


Il Backup dei preferiti:

L’applicativo genera periodicamente un backup del database dei favoriti.
Il file di backup viene messo nella directory:
$HOME/.config/LeScienze500
assieme al database corrente e al file di configurazione.
Il file di backup si chiama: bookmark_ls500.backup.* (dove al posto dell’asterisco c’è la data di salvataggio).
Mentre il file dei preferiti si chiama:  bookmark_ls500.db
Nel caso, molto raro, che si danneggi il file dei preferiti è sempre possibile usare uno dei backup per recuperare almeno in parte i propri dati.


Come estrarre le copertine e il database

Un metodo scomodo per estrarre il database LeScienze.db e le copertine direttamente da Linux è quello di eseguire via wine l’installazione windows.

Ma usando l’applicativo 7zip è possibile aprire il panchetto di installazione per Machintosh install.dmg, situato sul primo DVD.

Il package di 7zip è di fatto disponibile nei repository ufficiali di tutte le distribuzioni Linux:
Sotto ArchLinux si deve installare il pachetto p7zip.
Con Ubuntu si deve installare il pacchetto  7zip-full

La procedura è molto semplice, basta solo dare il comando di di estrazzione archivi con 7zip.

Per prima cosa bisogna copiare il file install.dmg situato nel  DVD 1 di Le Scienze in una cartella nel proprio sistema.

Dopo esser entrati nella cartella nella quale è stato copiato install.dmg dare i seguenti comandi da shell (o terminale)

Comandi shell:

> 7z x install.dmg 2.hfs
> 7z x 2.hfs Le\ Scienze\ -\ 500\ Numeri/Le\ Scienze\ -\ 500\ Numeri/copertine/
> 7z x 2.hfs Le\ Scienze\ -\ 500\ Numeri/Le\ Scienze\ -\ 500\ Numeri/data/LeScienze.db

A questo punto nella directory:

Le Scienze – 500 Numeri/Le Scienze – 500 Numeri/copertine/

troverete la collezione di tutte le copertine.

Mentre il file:

Le Scienze – 500 Numeri/Le Scienze – 500 Numeri/data/LeScienze.db

è il database in formato sqllite3 e contiene tutte le informazioni sulle riviste.
Le due directory si trovano nella stessa cartella di install.dmg.

Con 7z –help o man 7z si possono avere maggiori dettagli sull’uso di questo software.


Come scaricare da SVN (deprecato: ora sono passato su github)

Premessa: La versione in SVN è una versione di sviluppo quindi non viene fatto nessun test e non viene garantito il coretto funzionamento dell’applicativo. Non è da escludere la perdita di dati o il danneggiamento del file di configurazione.

Raccomando sempre di utilizzare l’ultima versione scaricabile dalla home-page.

Quegli utenti che scaricano da SVN avranno osservato struttura del repository SVN.

Quindi per poter scaricare solo i sorgenti della versione corrente si deve dare il comando:

svn co https://lescienze500.svn.sourceforge.net/svnroot/lescienze500/lescienze500 lescienze500

Questo permette di scaricare solo i sorgenti della versione attuale escludendo l’archivio delle release.

Buon divertimento …..

%d blogger hanno fatto clic su Mi Piace per questo: