GeneWeb - Creare un CD-Rom

Questo capitolo spiega le tappe da seguire per fabbricare il CD-Rom. Questo tipo di installazione presenta il vantaggio di non richiedere alcuna installazione su hard disk.

Ecco le operazioni da eseguire:

1. Effettuate una accurata pulizia della vostra base. Se avete gwsetup, usatelo: guardate nel "menu principale" per vedere come compiere questa operazione. La cosa si puo fare in modo interattivo con i comandi gwu e gwc (gwu crea un file testo sorgente della base e gwc la ricrea a partire da questo file).

   Nota: questa tappa non è assolutamente obbligatoria ma vi permette di distribuire una base ottimizzata in quanto alla memoria utilizzata e in velocitŕ d'accesso. Ciononostante, se la vostra base viene da un file GEDCOM o un file sorgente GeneWeb e non avete apportato alcuna modifica, questa tappa diventa inutile.

2. Se volete che le consanguineità vengano visualizzate nelle pagine personali e nei calcoli di parentela, utilizzate il programma d'inizializzazione delle cosanguineità. Con gwsetup, andate nel "menu principale". In modo interattivo, si utilizza il comando consang.

   Notate che anche questa tappa è facoltativa. Se non la eseguite, i calcoli di parentela funzioneranno lo stesso ma le consanguineità non verranno visualizzate.

3. Entrate nella base e eseguite un calcolo di parentela qualsiasi, ad esempio tra padre e figlio.

   Nota: anche questa tappa è facoltativa e serve solo ad ottimizzare l'accesso alla base. In effetti, il primo calcolo di parentela genera un file (chiamato tstab) nella base di dati che permette di eseguire più rapidamente i calcoli di parentela seguenti. Se il file non viene creato adesso, non sarà possibile farlo quando la base sarà sul CD-Rom e i calcoli saranno più lenti.

4. Create una directory per gli elementi che metterete sul CD-Rom. Nelle spiegazioni che seguono, chiameremo questa directory "directory di destinazione".

5. Iniziate col trasferire la vostra base dati verso la directory di destinazione. La base si trova in una directory il cui nome finisce con ".gwb". Ad esempio, se la vostra base si chiama "pippo", si tratterà della directory "pippo.gwb". Questa directory si trova nella directory delle basi (la cui posizione dipende dalla vostra installazione: Windows, MacOs X, Unix).

6. Copiate nella directory di destinazione un file di configurazione. Se ne avete uno che vi conviene, utilizzatelo, altrimenti createlo. Il file di configurazione è un file testo il cui nome termina con ".gwf". Se la vostra base si chiama "pippo", il file è "pippo.gwf". Se c'è già un file di configurazione, lo troverete nella directory delle basi.

   In questo file, aggiungete una password "mago" fasulla, aggiungendo la linea:

   wizard_passwd=a
   

   Nota: questa operazione è facoltativa ma permette di evitare che venga proposto un "aggiornamento" nelle pagine personali, aggiornamento che comunque non si potrebbe fare dato che la base risiererà su un supporto non modificabile. Attenzione: se create il file di configurazione, fate in sorta che non abbia l'estensione .txt che certi sistemi attribuiscono automaticamente a questo tipo di files. L'estensione deve essere .gwf e nient'altro.

7. Copiate l'eseguibile "gwd" nella directory di destinazione. Su certi sistemi, porta l'estensione ".exe". Attenzione: ci possono essere piů files che si chiamano "gwd" nella vostra installazione GeneWeb. Nel nostro caso si tratta di un file piuttosto grosso (1 Mo). Generalmente lo trovate nella directory chiamata "gw".

8. 8. Copiate nella directory di destinazione le directory "lang", "etc" e "images" che si devono trovare nella stessa directory ove si trova l'eseguibile gwd.

   Nota: queste directories sono obbligatorie. Contengono dei files utilizzati dagwd, in particolare per le lingue e per la visualizzazione di certe pagine.

9. Nella directory "lang" della directory di destinazione, editate il file chiamato "start.txt" e cancellate il gruppo di linee che contengono i links per l'accesso "Wizard". Queste linee cominciano con qualcosa del genere:

      <td align=center>[
      af: <a href="%sw=w"><em>Medewerkers</em></a> toegang<br> (password)
      ca: accés <a href="%sw=w"><em>administrador</em></a><br> (clau)
   

   e finiscono con:

      pl: <a href="%sw=w"><em>"Wizard"</em></a> dostęp<br> (hasło)
      pt: Entrada <a href="%sw=w"><em>feiticeiro</em></a><br> (palavra chave)
      sv: <a href="%sw=w"><em>Uppdaterings</em></a> tillträde<br> (passord)
      ]<br></td>
   

   Questa tappa non è, obbligatoria ma evita che la pagina di benvenuto proponga un accesso Wizard che, in ogni modo, non servirebbe a nulla.

10. Tappa importante. L'eseguibile gwd genera dei files nella sua directory corrente. Se non puo farlo, il programma può bloccarsi (in particolare sotto Windows, si bloccherà con certezza). Bisogna quindi indicare un'opzione per fargli usare l'hard disk (questi files non sono grandi, sono temporanei e cancellarli volontariamente o involontariamente durante o dopo la visita, non perturberà il funzionamento di gwd)

    . Per fare ciò, create un file testo che chiamerete "gwd.arg" (attenzione: niente estensioni ".txt" !) e scriveteci dentro:

    Se preparate un CD-Rom per Windows:
        -wd
        c:\temp\geneweb
    Se è destinato a Unix o MacOs X:
        -wd
        /tmp/geneweb
        

11. Se la vostra base di dati possiede delle immagini, mettetele nella directory "images", in una sub-directory che porta il nome della vostra base ("images/pippo" se la base si chiama "pippo").

12. Dopo aver eseguito tutte queste tappe, avrete ottenuto una installazione minima, che obbliga l'utilizzatore a lanciare lui stesso gwd e ad aprire l'URL per accedere alla base. Potete migliorare la cosa fornendo dei files HTML e/o degli scripts (shell, batch) che faranno tutto da soli. Potete anche allegare più basi di dati, altri files HTML, ecc.

    Non chiedetemi come si fa un CD-Rom che si lancia automaticamente quando lo si inserisce sul suo supporto: si dovrebbe poter fare ma non so proprio come.

    Nota: se volete che la vostra base sia leggibile su dei sistemi operativi diversi da quello che utilizzate, potete creare una directory per SO e metterci la version di gwd per quel SO. Dovrete prima scaricare le versioni di GeneWeb che girano sui SO che volete rendere disponibili. Bisogna anche rivedere l'installazione dei files gwd.arg e in particolare indicare il path verso i files sistema e la base (opzioni -hd e -bd di gwd).

13. Prima di masterizzare il vostro CD, fate un test. Rendete non modificabile la directory di destinazione e le sub-directories e files che contiene. Poi, eseguite il comando gwd (con un doppio click se il vostro sistema lo consente oppure usando un comando interattivo). Lanciate il vostro navigatore web all'indirizzo http://127.0.0.1:2317/pippo (se la base si chiama "pippo") e verificate che tutto funzioni.

14. Se tutto va bene, masterizzate il vostro CD-Rom mettendovi la directory di destinazione e tutto il suo contenuto.