Indice()

Introduzione

In questa pagina vengono riportare informazioni sulle azioni che solitamente vengono svolte il giorno del rilascio di una nuova versione di Ubuntu.

La lettura è destinata agli amministratori ed editori della documentazione. Le qui presenti sono semplici note, un memorandum per futuri amministratori.

Documentazione ufficiale

È necessario compilare la nuova versione della [http://help.ubuntu-it.org documentazione ufficiale].

Preparativi alla compilazione

1. In caso non si abbiano le giuste dipendenze, digitare da riga di comando:

   sudo apt-get build-dep ubuntu-docs

2. Creare un branch della documentazione da questo indirizzo: https://code.launchpad.net/ubuntu-docs

3. Scaricare il file allegato attachment:libs-documentazione.tar.gz e scompattarlo.

4. Modificare ubuntu-banner.xsl alla nuova versione:

   1. Sostituzione del numero della versione: s/9.10/10.04/
   2. Aggiornamento dell'anno nel footer

5. Copiare i file ubuntu-banner.xsl, ubuntu-book.css nella cartella libs/.

6. Copiare il file logo.png in libs/img/.

7. Tradurre il file index.xml. Nell'allegato è presente un esempio di come dovrebbe apparire il file.

Compilazione

1. Modificare il file Makefile affinché compili la documentazione in italiano:

   # Language code for documents
   # Ex. LN=ja for japanese
   LN=C

   Modificare LN=C con LN=it.
2. Da riga di comando digitare:

   make all

   La documentazione compilata verrà inserita nella cartella build.

Modifiche post compilazione

Motore di ricerca

1. Creare un [http://www.google.com/coop/manage/cse/ motore di ricerca google].

2. Modificare il file search.js presente nell'allegato inserendo il cseId del nuovo motore di ricerca:

   // Site Restrict to CSE ID
   var cseId = "008742922050479854700:sgrtw8uh7hc"; 

3. Modificare il file search.php presente in allegato aggiornando le variabili year e version:

   <?php 
   $version = "10.04"; 
   $year = "2010";
   ?>

4. Copiare i file search.js, search.css e search.php in build/libs/.

Caricamento sul server

1. Caricare il contenuto della cartella build all'interno della cartella:

   /srv/help.ubuntu-it.org/www/NUMERO_VERSIONE/ubuntu/

   Sostituire la dicitura NUMERO_VERSIONE al numero di versione del nuovo rilascio di Ubuntu.

2. Creare un file ubuntuVER.html (ad esempio ubuntu1004.html) nella cartella /srv/help.ubuntu-it.org/www/

3. Modificare il file index.html inserendo un collegamento alla documentazione del nuovo rilascio.

4. Entrare nella cartella della nuova versione e digitare il seguente comando:

   find -type f -name "*.html" | while read file ; do echo `pwd`/${file:2} | sed 's/srv//;s/\/www//;s/^/http:/' ; done

   L'output del comando potrà essere usato per velocizzare l' indexing del motore di ricerca google. Per maggiori informazioni fare clic su Indexing nella pagina di amministrazione del motore.