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 1 e 16 (in 15 versioni)
⇤ ← Versione 1 del 24/04/2010 09.12.31 →
Dimensione: 2179
Autore: LeoIannacone
Commento: Primi appunti
← Versione 16 del 20/03/2012 18.32.49 → ⇥
Dimensione: 3733
Autore: GiuseppeTerrasi
Commento:
Le cancellazioni sono segnalate in questo modo. Le aggiunte sono segnalate in questo modo.
Linea 1: Linea 1:
#format wiki
#LANGUAGE it

<<Indice>>
Linea 7: Linea 12:
= Documentazione ufficiale = = Documentazione ufficiale pre 12.04 =
Linea 9: Linea 14:
È necessario compilare la nuova versione della [http://help.ubuntu-it.org documentazione ufficiale]. È necessario compilare la nuova versione della [[http://help.ubuntu-it.org|documentazione ufficiale]].
Linea 21: Linea 26:
 0. Scaricare il file allegato attachment:libs-documentazione.tar.gz e scompattarlo.  0. Scaricare il branch `help-repo-src`:
 {{{
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/help-repo-src
}}}
Linea 23: Linea 31:
 0. Modificare `ubuntu-banner.xsl` alla nuova versione:
  0. Sostituzione del numero della versione: s/9.10/10.04/
  0. Aggiornamento dell'anno nel footer		  0. Modificare `ubuntu-banner.xsl` alla nuova versione s/$VERSIONE/10.04/
Linea 31: Linea 37:
 0. Tradurre il file `index.xml`. Nell'allegato è presente un esempio di come dovrebbe apparire il file.  0. Controllare il file `index.xml` prima di copiarlo.
Linea 51: Linea 57:
 0. Creare un [http://www.google.com/coop/manage/cse/ motore di ricerca google].  0. Creare un [[http://www.google.com/coop/manage/cse/|motore di ricerca google]].
Linea 55: Linea 61:
var cseId = "008742922050479854700:zu21dqggfvu"; var cseId = "008742922050479854700:sgrtw8uh7hc";
Linea 60: Linea 66:
$version="10.04"; $version = "10.04";
Linea 65: Linea 71:
 0. Copiare i file `search.js` e `search.php` appena modificati in `build/libs/`.  0. Copiare i file `search.js` e `search.css` in `build/libs/` e `search.php` in `build`.


== Caricamento sul server ==
 0. 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.

 0. Modificare il file `help-repo/www/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
}}}

 0. 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.


## a lavoro finito includere queste: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/BuildingDocumentation e https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Repository

= Documentazione ufficiale 12.04 LTS =


istruzioni al momento sul branch apposito.


----
CategoryComunitaDocumentazione

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

istruzioni al momento sul branch apposito.

CategoryComunitaDocumentazione