Capitolo 1. Installare Publican

1.1. Sistemi Oparativi Linux

Importante — Disponibilità nei repository

Le procedure indicate in questa sezione assumono che Publican e le sue varie dipendenze siano disponibili nei repository cui ha accesso il proprio sistema.

1.1.1. Fedora

Aprire un terminale
Divenire l'utente root: su -
Eseguire il seguente comando per installare il pacchetto publican ed il pacchetto publican-doc della documentazione:
```
 yum install publican publican-doc
```

Con Publican sono disponibili anche diversi pacchetti di brand. Eseguire il seguente comando come utente root, per installare i pacchetti per la costruzione di libri brand:

 yum install publican-brand

Sostituire brand con redhat, fedora, jboss, ovirt, o gimp. Vedere il Capitolo 4, Branding per una spiegazione del branding in Publican.

1.1.2. Red Hat Enterprise Linux 5

Importante — Software non supportato

Publican non fa parte della distribuzione Red Hat Enterprise Linux. Quindi Red Hat non offre supporto per Publican.

Importante — Dipendenze disponibili soltanto all'interno di Red Hat

L'installazione di Publican su Red Hat Enterprise Linux 5, richiede un numero di dipendenze che attualmente sono disponibili solo nei repository yum interni a Red Hat.

Aprire un terminale
Divenire l'utente root: su -
Eseguire il seguente comando per installare il pacchetto publican ed il pacchetto publican-doc della documentazione:
```
 yum install publican publican-doc
```

Con Publican sono disponibili anche diversi pacchetti di brand. Eseguire il seguente comando come utente root, per installare i pacchetti per la costruzione di libri brand:

 yum install publican-brand

Sostituire brand con redhat, fedora, jboss, ovirt, o gimp. Vedere il Capitolo 4, Branding per una spiegazione del branding in Publican.

1.1.3. Ubuntu

Importante — Novità in 10.4 "Lucid Lynx"

Publican fa il suo ingresso in Ubuntu 10.4 "Lucid Lynx".

Aprire un terminale
Eseguire il seguente comando per installare il pacchetto publican:
```
sudo apt-get install publican
```

1.1.4. Debian

Avviso — Completare questa procedura

Completare ogni passaggio di questa procedura. Se non si effettuano, come quì indicate, le operazioni di ripristino alle modifiche apportate al file /etc/apt/sources.list, il sistema potrebbe diventare instabile.

Publican non è disponibile nella corrente versione stabile di Debian (version 5.0, "Lenny"), ma è disponibile nella corrente versione di test ("Squeeze"). Per installare Publican su un computer che esegue Debian, occorre abilitare temporaneamente l'accesso al repository squeeze. Abilitando l'accesso a questo repository, si autorizza il computer ad installare nuovo software e nuove versioni di software, rispetto alla corrente versione stabile di Debian. Tuttavia, non tutto il software disponibile nel repository di test ha già superato il controllo di qualità. Quindi, se dopo l'installazione di Publican non si disabilita l'accesso a questo repository, al successivo aggiornamento del sistema, i pacchetti software esistenti verranno sostituiti con nuove versioni scaricate dal repository, e molto probabilmente risulteranno essere versioni non ancora testate.

Aprire un terminale
Con un editor di testo aprire il file /etc/apt/sources.list. Per esempio, per modificare il file con gedit, eseguire:
```
sudo gedit /etc/apt/sources.list
```

Aggiungere la seguente riga alla fine del file:

deb http://ftp.debian.org/debian/ squeeze main

Salvare il file e chiudere l'editor.
Eseguire il seguente comando per aggiornare la lista dei pacchetti disponibili nel sistema:
```
sudo apt-get update
```
Eseguire il seguente comando per installare il pacchetto publican:
```
sudo apt-get install publican
```
Riaprire il file /etc/apt/sources.list e rimuovere la riga precedentemente inserita.

Notare che finchè la release "Squeeze" non viene rilasciata come versione stabile di Debian, occorre manualmente abilitare e disabilitare l'accesso al repository di test come fin quì descritto, ogniqualvolta diventa disponibile, nel repository di test, una nuova versione di Publican. Per informazioni aggiornate sullo status di Publican per Debian, visitare http://packages.debian.org/squeeze/publican, contenente il numero di versione di Publican disponibile nel repository (versione 2.1 al tempo di scrittura di questo documento).

Nel momento in cui "Squeeze" diventa la versione stabile di Debian, per installare Publican su sistemi che eseguono questa versione del sistema operativo, non occorre più abilitare o disabilitare l'accesso a repository extra.

1.2. Sistemi Operativi Windows

Scaricare il programma di installazione di Publican da https://fedorahosted.org/releases/p/u/publican/.
Spostarsi nella cartella in cui si è scaricato l'eseguibile Publican-Installer-versione.exe.
Fare doppio click sul file Publican-Installer-versione.exe.
Il programma di installazione inizia presentando una serie di accordi di licenza. Tutti i file che fanno parte di una installazione di Publican sono disponibili sotto licenza libera. Tuttavia, poichè diverse licenze sono più adatte a certe parti di Publican di altre, i file di Publican non vengono tutti distribuiti sotto la stessa licenza libera. Ogni licenza conferisce differenti diritti e responsabilità sulla copia e sulla modifica dei file di una installazione di Publican. Noi usiamo questa combinazione di licenze per consentire di usare Publican il più liberamente possibile e per consentire di scegliere qualunque licenza per i propri documenti, pubblicati usando Publican.
Leggere le condizioni dei vari accordi di licenza. Se si concorda con le condizioni, premere I Agree su ciascuna di esse, altrimenti premere Cancel.
Il programma di installazione propone di installare diversi componenti: Publican (denominato Main nella finestra d'installazione), alcuni brand (RedHat, JBoss, e fedora), e due componenti di DocBook (il DTD o Data Type Definition, e l'XSL o Extensible Stylesheet Language). I tre brand si trovano ragruppati sotto il controllo espandibile Brands, mentre i componenti di DocBook si trovano nel controllo espandibile DocBook nella finestra di installazione. Vedere il Capitolo 4, Branding per una spiegazione dei brand in Publican. Per rendere i documenti XML in presentazioni di altri formati (come HTML e PDF), Publican usa il DTD e gli stylesheet di XSL. Se non si installano questi componenti, Publican deve scaricare questi dati da Internet ogniqualvolta elabora un documento, il che comporta lunghi ritardi.
Tutti i componenti sono selezionati per impostazione. Deselezionare i componenti eventualmente non richiesti e poi premere Next, per continuare.
Per impostazione, il programma di installazione crea una cartella denominata Publican nella cartella %ProgramFiles% del proprio computer — tipicamente C:\Program Files\Publican. Per selezionare una cartella differente, inserire manualmente il persorso alla cartella, nella casella di testo etichettata Destination Folder.
Dopo aver impostato la cartella di destinazione, premere Install.
A questo punto, durante l'installazione di Publican, viene visualizzata una barra di progressione. Per visualizzare i dettagli sul progresso di installazione, premere Show details.
Una volta completato, il programma di installazione visualizza il messaggio Completed.
Premere Close per chiudere il programma di installazione.