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 pre 12.04

È necessario compilare la nuova versione della 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 branch help-repo-src:

   bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/help-repo-src

4. Modificare ubuntu-banner.xsl alla nuova versione s/$VERSIONE/10.04/

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

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

7. Controllare il file index.xml prima di copiarlo.

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 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 e search.css in build/libs/ e search.php in build.

Caricamento sul server

1. Aggiungere il contenuto della cartella build all'interno del branch ~help-repo`:

    bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/help-repo
    mkdir -p help-repo/www/NUMERO_VERSIONE/ubuntu/
    cp -r NOME_VERSIONE/build/* help-repo/www/NUMERO_VERSIONE/ubuntu/

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

2. Modificare il file help-repo/www/index.html inserendo un collegamento alla documentazione del nuovo rilascio.

3. Committare le modifiche e fare il push su launchpad:

   cd help-repo
   bzr add *
   bzr commit -m 'Aggiunta documentazione per Ubuntu NUMERO_VERSIONE'
   bzr push --remember lp:~ubuntu-it-wiki/wiki-ubuntu-it/help-repo

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

   cd help-repo/www/NUMERO_VERSIONE/ubuntu/
   find -type f -iname '*.html' | sed s'/^.\///' | while read line ; do echo "http://help.ubuntu-it.org/NUMERO_VERSIONE/ubuntu/$line"; done

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

Documentazione ufficiale 12.04 LTS

cd ~

sudo apt-get install yelp gnome-doc-utils gnome-user-guide gnome-common yelp-tools ubuntu-mono gettext docbook-xsl gawk

bzr branch https://code.launchpad.net/~ubuntu-core-doc/ubuntu-docs/precise 

cd precise

./autogen.sh --prefix=/home/contumacia/precise/ubuntu-help/install/

make

cd html

*** modificare ubuntu.xsl *** css, template, motore di ricerca, importare js ***

*** copiare cartella figures da C a it sotto ubuntu-help ***

make

cp -R build /var/www

todo:

• immagini in italiano /html/img (forse ci pensa il gruppo trad... indagare)
• motore di ricerca dentro /html/ubuntu.xsl (creare cseld)
• nuovo /html/ubuntu.xsl

CategoryComunitaDocumentazione