Istallazione

ghini.desktop è un programma multipiattaforma e funziona su macchine unix (Linux e MacOSX) ma anche su Windows.

uso Linux proprio perché ho fretta

Scarica ed esegui lo script di installazione. La documentazione può attendere.

Il gruppo di sviluppo di Ghini è piccolo, preferiamo lavorare al migliorare il programma, o a documentarlo, piuttosto che perder tempo con pacchetti di installazione. Invece di tanto pacchetti differenti, uno per piattaforma, offriamo una stessa procedura di installazione per tutte le piattaforme. Questo non solo ci risparmia tempo, ci regala anche un po’ di vantaggi, che apprezzeremo nel corso dell’uso del software.

L’installazione è basata sull’esecuzione di uno script.

  • Lo script GNU/Linux si occupa di tutto, dalla soluzione delle dipendenze alla installazione per tutti gli utenti nel gruppo ghini.

  • Lo script per Windows richiede l’installazione previa di un paio di cose.

  • Su MacOSX utilizzeremo lo stesso script di GNU/Linux, però non avendo OSX un gestore di pacchetti ne istalleremo uno prima di eseguire lo script.

Seguendo le seguenti istruzioni di installazione si ottiene ghini.desktop installato in un ambiente Python virtuale, tutte le dipendenze saranno installate localmente e non entreranno in conflitto con altri programmi Python che possono essere sullo stesso elaboratore.

Le dipendenze che non è possibile installare in un ambiente virtuale Python sono: Python, virtualenv, GTK+, e PyGTK. La loro installazione differisce per piattaforma.

Se dovessi in seguito decidere di rimuovere Ghini, basterà rimuovere l’ambiente virtuale, che è una directory, con tutto il suo contenuto.

Installare su Linux

Aprire una finestra di terminale di shell e seguire queste istruzioni.

  1. Scaricare il programmino devinstall.sh ed eseguirlo:

    https://raw.githubusercontent.com/Ghini/ghini.desktop/ghini-1.0-dev/scripts/devinstall.sh
    

    Siete pregati di notare che lo script non vi aiuterà a installare alcun connettore aggiuntivo di database. Questo non è strettamente necessario e si può fare in qualsiasi passo successivo.

    Se il programmino di installazione termina senza errori, si può ora avviare ghini:

    ~/bin/ghini
    

    o aggiornare ghini all’ultima versione rilasciata nella linea di produzione:

    ~/bin/ghini -u
    

    Lo stesso programmino puoi utilizzarlo per cambiare ad un’altra linea di produzione. Al momento ci sono la ghini-1.0 e ghini-1.1.

  2. su Unity, apri un terminale, avvia ghini, la sua icona (il signor Ghini mostrando il suo erbario) apparirà nel launcher, e se si vuole lo si può saldare al launcher.

  3. Se si desidera utilizzare il valore predefinito ‘ SQLite <http: sqlite.org/=”“>’ _ database oppure non so che cosa questo significa, allora si può saltare questo passaggio. Se si desidera utilizzare un database back-end diverso da backend SQLite predefinita quindi è necessario anche installare un connettore database.</http:>

    Se si desidera utilizzare un ‘ PostgreSQL <http: www.postgresql.org=”“>’ _ database poi attivare l’ambiente virtuale e installare psycopg2 con i seguenti comandi::</http:>

    source ~/.virtualenvs/ghide/bin/activate
    pip install -U psycopg2
    

    Si potrebbero bisogno di risolvere le dipendenze. Come farlo, dipende dal sapore che GNU/Linux si sta utilizzando. Consultare la documentazione di distribuzione.

nota per il principiante

Per eseguire uno script, in primo luogo assicurarsi che avete segnato il nome della directory in cui avete scaricato lo script, quindi si apre una finestra di terminale e in quella finestra si digita ‘bash’ seguita da uno spazio e il nome completo dello script incluso nome directory e colpire il tasto di invio.

nota tecnica

You can study the script to see what steps if runs for you. In short it will install dependencies which can’t be satisfied in a virtual environment, then it will create a virtual environment named ghide, use git to download the sources to a directory named ~/Local/github/Ghini/ghini.desktop, and connect this git checkout to the ghini-1.0 branch (this you can consider a production line), it then builds ghini, downloading all remaining dependencies in the virtual environment, and finally it creates a startup script. If you have sudo permissions, it will be placed in /usr/local/bin, otherwise in your ~/bin folder. Again if you

Prossimo...

Connettersi ad una base dati.

L’installazione su MacOSX

Essendo MacOSX un ambiente unix, la maggior parte andrà bene lo stesso come su GNU/Linux (sorta di).

Ultima volta che abbiamo testato, alcune delle dipendenze non poteva essere installato su MacOSX 10.5 e presumiamo che problemi analoghi si mostrerebbe anche su vecchie versioni OSX. Ghini è stato testato con successo con 10.7, 10.9 e 10.12.

Prima di tutto, avete bisogno di cose che sono parte integrante di un ambiente unix, ma che mancano in un mac disponibile immediatamente:

  1. strumenti per gli sviluppatori: xcode. controllare la pagina di wikipedia per la versione supportata sul vostro mac.

  2. Gestione pacchetti: homebrew (tigerbrew per le vecchie versioni OSX).

con sopra installato, aprire una finestra terminale ed eseguire:

brew doctor

Assicurarsi di che comprendere i problemi segnala e correggerli. PyGTK dovrà xquartz e brew non risolverà automaticamente la dipendenza. installare xquartz utilizzando brew o il modo che preferisci:

brew install Caskroom/cask/xquartz

quindi installare le dipendenze rimanenti:

brew install git
brew install pygtk  # takes time and installs all dependencies

seguire tutte le istruzioni su come attivare ciò che avete installato.

Mac running OSX 10.12 —Sierra—

Su OSX 10.12, rapporti che ‘ gettext ‘ è già installato, ma allora è non fateci trovare ‘birra ‘. Una soluzione consiste nell’eseguire la seguente riga:

brew link gettext --force

Prima di poter correre ‘ devinstall.sh ‘ come su GNU/Linux, abbiamo ancora bisogno di installare un paio di pacchetti python, a livello globale. A tale scopo:

sudo pip install virtualenv lxml

Il resto è proprio come su una normale macchina unix. Leggere le istruzioni di GNU/Linux sopra, li seguono, godere.

Prossimo...

Connettersi ad una base dati.

installazione su Windows

L’attuale responsabile della ghini.desktop non ha alcun interesse a imparare a produrre file di Windows Installer, quindi l’installazione di Windows è qui ridotto alla stessa procedura di installazione come su Unix (GNU/Linux e MacOSX).

Si prega di segnalare eventuali problemi. Aiuto con l’imballaggio sarà molto gradito, in particolare da altri utenti di Windows.

La procedura descritta qui le istruzioni su come installare Git, Gtk, Python, e il pitone database connettori. Con questo ambiente impostato correttamente, la procedura di installazione di Ghini viene eseguito come su GNU/Linux. Le fasi conclusive sono nuovamente Windows specifico.

Nota

Ghini è stato testato con ed è noto a lavorare su W-XP, W-7 e W-8. Anche se dovrebbe funzionare bene su altre versioni di Windows non è stato accuratamente testato.

Nota

Download diretto link vengono forniti per tutti i componenti necessari. Sono stati testati in settembre 2015, ma le cose cambiano con il tempo. Se uno qualsiasi dei download diretto link smette di funzionare, si prega di suonare il campanello, così possiamo aggiornare le informazioni qui.

La procedura di installazione su Windows:

  1. scaricare e installare ‘ git ‘ (viene fornito con un unix-like ‘ sh ‘ e include ‘ vi ‘) da:

    https://git-scm.com/download/win
    

    ‘Direct link per scaricare git’ _

    tutte le opzioni predefinite sono corrette, tranne che abbiamo bisogno di git per essere eseguibile dal prompt dei comandi:

    _images/git3.png
  2. scaricare e installare Python 2. x (32 bit) da:

    http://www.python.org
    

    ‘Direct link per scaricare Python’ _

    Ghini è stato sviluppato e testato con Python 2. x. Sarà sicuramente non eseguire su Python 3. x. Se sei interessato ad aiutare porta a Python 3. x, si prega di contattare i manutentori di Ghini.

    durante l’installazione di Python, mettere Python nel percorso:

    _images/python3.png
  3. Scarica ‘ pygtk ‘ dall’origine seguente. (questo richiede python a 32 bit). Accertati di scaricare il “all in One” versione:

    http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/
    

    ‘Direct link per scaricare PyGTK’ _

    fare un’installazione completa, selezionando tutto:

    _images/pygtk1.png
  4. (Windows 8. x) si prega di considerare questo ulteriore passaggio. È forse necessario evitare il seguente errore su installazioni Windows 8.1:

    Building without Cython.
    ERROR: 'xslt-config' is not recognized as an internal or external command,
    operable program or batch file.
    

    Se si ignora questo passaggio e può confermare che si ottiene l’errore, vi preghiamo di informarci.

    È possibile scaricare lxml da:

    https://pypi.python.org/pypi/lxml/3.4.4
    

    Ricordate che avete bisogno della versione a 32 bit, per Python 2.7.

    ‘Direct link per scaricare lxml’ _

  5. (facoltativo) scaricare e installare un connettore di database diverso da ‘sqlite3 ‘.

    Su Windows, non è facile da installare ‘ psycopg2 ‘ da fonti, utilizzando pip, così “avoid il detailsgory” e utilizzare un foglio pre-compilato da:

    http://initd.org/psycopg/docs/install.html

    ‘Direct link per scaricare psycopg2’ _

  6. RIAVVIA

    Ehi, questo è per Windows, è necessario riavviare per rendere effettive le modifiche!

  7. scaricare ed eseguire (da ‘ system32cmd.exe ‘) il file batch:

    giusto prima di colpire il tasto di invio per eseguire lo script, sullo schermo potrebbe apparire come qualcosa di simile:

    _images/sys32cmd-1.png

    Questo sarà tirare ‘ ghini.desktop ‘ repository su github alla tua home directory, sotto ‘LocalgithubGhini ‘, check-out la linea di produzione ‘ ghini-1.0 ‘, creare un ambiente virtuale e installare ghini in esso.

    è inoltre possibile eseguire ‘ devinstall.bat ‘ passando come argomento la parte numerica della linea produttiva che si desidera seguire.

    Questo è l’ultimo passo di installazione che dipende, in larga misura, su un lavoro connessione internet.

    l’operazione può richiedere alcuni minuti per completare, a seconda della velocità della tua connessione internet.

  8. l’ultimo passo di installazione crea il gruppo Ghini ed i collegamenti nel Menu Start di Windows, per tutti gli utenti. A tale scopo, è necessario eseguire uno script con diritti amministrativi. Lo script si chiama ‘ devinstall-finalize.bat ‘, è proprio nella tua cartella HOME ed è stato creato nel passaggio precedente.

    pulsante destro del mouse su di esso, selezionare Esegui come amministratore, confermare che si desidera apportare modifiche al computer. Questi cambiamenti sono nel Menu Start solo: creare il gruppo di Ghini, inserire il collegamento di Ghini.

  9. scaricare il file di batch che si utilizzerà per rimanere sempre aggiornati con la linea di produzione che si è scelto di seguire:

    Se siete su una recente installazione di Ghini, ogni volta che si avvia il programma, Ghini controllerà sul sito di sviluppo e avviso di qualsiasi più recenti ghini rilasciare entro la linea di produzione selezionata.

    ogni volta che si desidera aggiornare l’installazione, basta avviare il prompt ed eseguire ‘ ghini-Update. bat ‘

Se si desidera generare e stampare report in formato PDF utilizzando il generatore di report predefinito di Ghini, quindi sarà necessario scaricare e installare ‘ Apache FOP <http: xmlgraphics.apache.org/fop/=”“>’ _. Dopo l’estrazione dell’archivio FOP è necessario includere la directory estratti nel tuo percorso.</http:>

Prossimo...

Connettersi ad una base dati.

Troubleshooting

  1. qualsiasi errore relazionati a lxml.

    Per essere in grado di compilare lxml, è necessario installare un compilatore C (su GNU/Linux questo sarebbe il pacchetto ‘ gcc ‘) e Cython (una specializzazione di Python, che viene compilata in codice C. Nota: Cython non è CPython).

    Tuttavia, non dovrebbe essere necessario compilare nulla, e ‘ pip ‘ dovrebbe essere in grado di individuare i moduli binari nelle librerie online.

    Per qualche ragione, questo non è il caso su Windows 8.1.

    https://pypi.python.org/pypi/lxml/3.4.4

    Si prega di segnalare eventuali altri problemi relazionati all’installazione di lxml.

  2. Non poteva installare gdata.

    Per qualche ragione gdata pacchetto di Google stesso sono elencati nell’indice pacchetto Python ma non funziona correttamente con il comando easy_install. È possibile scaricare l’ultimo pacchetto di gdata da:

    http://code.google.com/p/gdata-python-client/downloads/list

    Decomprimerlo ed eseguire ‘ python setup.py installw ‘ nella cartella per decomprimere.

Prossimo...

Connettersi ad una base dati.