Dimensione: 3380
Commento: converted to 1.6 markup
|
← Versione 16 del 20/03/2012 18.32.49 ⇥
Dimensione: 3733
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 26: | 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 28: | 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 36: | 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 74: | 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 76: | 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 78: | 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 80: | 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 82: | 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 84: | 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 86: | 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 88: | 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 91: | Linea 102: |
= Documentazione ufficiale 12.04 LTS = istruzioni al momento sul branch apposito. |
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
- In caso non si abbiano le giuste dipendenze, digitare da riga di comando:
sudo apt-get build-dep ubuntu-docs
Creare un branch della documentazione da questo indirizzo: https://code.launchpad.net/ubuntu-docs
Scaricare il branch help-repo-src:
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/help-repo-src
Modificare ubuntu-banner.xsl alla nuova versione s/$VERSIONE/10.04/
Copiare i file ubuntu-banner.xsl, ubuntu-book.css nella cartella libs/.
Copiare il file logo.png in libs/img/.
Controllare il file index.xml prima di copiarlo.
Compilazione
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.- Da riga di comando digitare:
make all
La documentazione compilata verrà inserita nella cartella build.
Modifiche post compilazione
Motore di ricerca
Creare un motore di ricerca google.
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";
Modificare il file search.php presente in allegato aggiornando le variabili year e version:
<?php $version = "10.04"; $year = "2010"; ?>
Copiare i file search.js e search.css in build/libs/ e search.php in build.
Caricamento sul server
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.Modificare il file help-repo/www/index.html inserendo un collegamento alla documentazione del nuovo rilascio.
- 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
- 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.