Wiki Ubuntu-it

Indice
Partecipa
FAQ
Wiki Blog
------------------
Ubuntu-it.org
Forum
Chiedi
Chat
Cerca
Planet
  • Pagina non alterabile
  • Informazioni
  • Allegati
  • Differenze per "GruppoDocumentazione/ReleaseDay"
Differenze tra le versioni 7 e 14 (in 7 versioni)
⇤ ← Versione 7 del 08/05/2011 14.30.37 →
Dimensione: 3269
Autore: LeoIannacone
Commento: Prime modifiche.
← Versione 14 del 17/03/2012 11.09.43 → ⇥
Dimensione: 4551
Autore: GiuseppeTerrasi
Commento:
Le cancellazioni sono segnalate in questo modo. Le aggiunte sono segnalate in questo modo.
Linea 12: Linea 12:
= Documentazione ufficiale = = Documentazione ufficiale pre 12.04 =
Linea 75: Linea 75:
 0. Caricare il contenuto della cartella `build` all'interno della cartella:  0. Aggiungere il contenuto della cartella `build` all'interno del branch ~help-repo`:
Linea 77: Linea 77:
/srv/help.ubuntu-it.org/www/NUMERO_VERSIONE/ubuntu/  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/
Linea 79: Linea 81:
 Sostituire la dicitura NUMERO_VERSIONE al numero di versione del nuovo rilascio di Ubuntu.  Sostituire la dicitura NUMERO_VERSIONE e NOME_VERSIONE al numero e nome di versione del nuovo rilascio di Ubuntu.
Linea 81: Linea 83:
 0. Creare un file ubuntuVER.html (ad esempio `ubuntu1004.html`) nella cartella `/srv/help.ubuntu-it.org/www/`  0. Modificare il file `help-repo/www/index.html` inserendo un collegamento alla documentazione del nuovo rilascio.
Linea 83: Linea 85:
 0. Modificare il file `index.html` inserendo un collegamento alla documentazione del nuovo rilascio.  0. 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
}}}
Linea 85: Linea 93:
 0. Entrare nella cartella della nuova versione e digitare il seguente comando:  0. Infine entrare nella cartella della nuova versione e digitare il seguente comando:
Linea 87: Linea 95:
find -type f -name "*.html" | while read file ; do echo `pwd`/${file:2} | sed 's/srv//;s/\/www//;s/^/http:/' ; done 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
Linea 89: Linea 98:
 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.  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.
Linea 92: Linea 102:

= Documentazione ufficiale 12.04 LTS =

'''work in progress'''

Al momento prima di buildare dare un ls contro C/ e verificare che le *.page ci siano tutte dentro il Makefile.
E copiare la cartella figures da C/ a it/

{{{
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

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

work in progress

Al momento prima di buildare dare un ls contro C/ e verificare che le *.page ci siano tutte dentro il Makefile. E copiare la cartella figures da C/ a it/ 

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