nota di giuseppe: prima di considerare questa pagina definitiva è necessario fare un ulteriore test di quanto scritto. non assicuro che mi sia già dimenticato qualcosa.
Introduzione
Ad ogni rilascio di Ubuntu la Comunità italiana deve provvedere ad una serie di operazioni. Queste verranno qui specificate nel dettaglio.
Documentazione ufficiale
Al fine di caricare la documentazione ufficiale su help.ubuntu-it.org è necessario fare quanto segue. Soggetti coinvolti: gruppo documentazione e chi ha accesso al server.
Installare sul proprio pc bzr. Verificare che siano installati i seguenti pacchetti: gnome-doc-utiles,make,gettext,docbook-xsl,foppoxml,gawk.
Aprire un terminale e scaricare in locale la copia della documentazione presente su launchpad
bzr branch https://code.launchpad.net/~ubuntu-core-doc/ubuntu-docs/NOME_DELLA_VERSIONE_DI_UBUNTU cartella_di_destinazione
La guida al server si trova nella cartella serverguide ma per ottenere il pdf bisognerà fare un operazione finale che in seguito si vedrà.
Operazioni. Nel file makefile posto nella radice della documentazione scaricata da launchpad modificare
# Language code for documents # Ex. LN=ja for japanese LN=C
con
# Language code for documents # Ex. LN=ja for japanese LN=it
per compilare in lingua italiana.Nota: c'è un baco nel makefile bisogna togliere le righe dove c'è scritto switching in quanto per la 10.10 la guida "passare da windows" è stata rimossa (vedi qui). quindi le righe dalla 98 alla 111 vanno commentate altrimenti la compilazione di pianta. MDKE sembra aver corretto il makefile di maverick e questo non dovrebbe più succedere. Per lucid il problema rimane confermato
Prendere come esempio questo file ubuntu-banner.xsl e correggere le righe 39, 45 e 61 inserendo il numero di versione che stiamo compilando (occhio alla riga 61 dove è necessario fare DUE modifiche, uno al link e l'altro al testo).
I file ubuntu-banner.xsl e ubuntu-book.css vanno messi dentro la cartella /libs per fare il modo che gli stili siano adeguati al nostro portale e non a quello internazionale (si tratta di sostituire i nostri con i loro).
Prendere questo file chiamato logo.png e metterlo in /libs/img per fare il modo che nell'header vada a finire il nostro logo e non quello internazionale.
Prendere un file index.xml recente (l'allegato prende quello della 10.04) e adeguarlo alla versione che stiamo compilando: sostanzialmente si tratta di sostituire i percorsi con quelli corretti per la versione che stiamo compilando. Questo file va messo nella radice della cartella della documentazione ufficiale (comparare i due file: verificare che non ci siamo cambiamenti alla struttura e controllare se sulla versione inglese ci sono collegamenti morti in modo almeno da sistemare il nostro... ricordarsi che a meno di cambiamenti la guida server bisogna collegarla a mano). Sempre "a mano" va aggiunta la guida all'installazione dato che il link advanced-topic è morto.
Da qui http://bazaar.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/help-repo/files/head:/search/ prendere il file search.js e search.css, controllare anno e numero di versione e metterli in ubuntu/libs/. Idem per il file search.php che però va messo in radice. Sistemare il motore di ricerca (CSEID) in search.js:
- ubuntu 12.04: 017780550971123101423:tudpblg6xy0
- ubuntu 10.04: 008742922050479854700:sgrtw8uh7hc
- ubuntu 10.10: 003899358952077393029:dvtha8dx9z8
- ubuntu 11.04: CSEID da creare.
- Quanto appena detto fa fatto a lavoro finito compreso il compia incolla delle cartelle img e admin poste sul help-repo al fine di ottenere bordi arrotondati e via dicendo.
- Se fosse necessario creare un altro motore di ricerca personalizzato (dove non specificato non toccare niente):
Andare qui http://www.google.it/cse/manage/create
- Nome del motore di ricerca: Ubuntu 10.10 (e per le successive "Ubuntu 11.04 e via dicendo)
- Cerca solo nei siti inclusi.
Includi tutte le pagine il cui indirizzo contiene questo URL http://help.ubuntu-it.org/CAMBIARE_NUMERO_DI_VERSIONE/ubuntu/
- Indicizzazione su richiesta utilizzando singoli URL: buttarci dentro tutti i link delle pagine da indicizzare
- Layout: larghezza estesa e predefinito
- Salvare tutto. Il CSEID si trova in informazioni di base alla voce "ID univoco del motore di ricerca:"
Fatto questo si passa alla compilazione vera e propria.
Dare un
make all && make serverguide-pdf
e aspettare. Il risultato sarà presente dentro la cartella build/ubuntu, conterrà anche il pdf della guida server e tutto va copiato sul server. La guida server, anche lei, sarà in build/ubuntu.
Ora bisogna caricare tutto sul server.
Caricare il contenuto della cartella di build all'interno della cartella:
/srv/help.ubuntu-it.org/www/NUMERO_VERSIONE/ubuntu/
sostituendo la dicitura NUMERO_VERSIONE al numero di versione del nuovo rilascio di Ubuntu.Prendere l'index di poco fa e farne una copia chiamata ad esempio ubuntu1010.html e mettere questo fine in root.
Modificare il file index.html presente in root (che è l'indice generale di tutte le guide) per aggiungere un collegamento alla documentazione del nuovo rilascio.
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:/' ; doneL'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.
- Fare una serie di verifiche affinché stili e formattazione rendano bene altrimenti trovare dei work-around.
- Ricontrollare link morti e problematiche dovute a link relativi/assouliti.
La politica di help.ubuntu.com è quella di seguire la procedura per la "Stable Release Update". In teoria il contenuto del sito rispecchierebbe il contenuto del pacchetto ubuntu-docs.
Documentazione della comunità
Soggetti coinvolti: gruppo documentazione, gruppo traduzione. Gruppo web, forum, irc e ml (?) per le dovute comunicazioni.
Creare pagina NomeVersioneNoteDiRilascio e creare un redirect verso https://wiki.ubuntu.com/NomeVersione/ReleaseNotes/.
Creare pagina Installazione/NomeVersioneTorrent ed inserire all'interno i percorsi per il download dei file .torrent (questa pagina servirà per essere collegata a quella del punto successivo a seguito sua traduzione).
Incollare i nuovi .torrent della pagina Installazione/ NomeVersioneTorrent dentro DownloadTorrent.
Creare pagina Installazione/ AggiornamentoNomeVersione e tradurre https://help.ubuntu.com/community/NomeVersioneUpgrades (collegare i torrent).
In installazione: inserire la pagina del punto precedente sotto il paragrafo Avanzamenti diretti.
In note di avanzamento aggiungere la pagina del punto tre.
In Repository/SourcesList aggiungere i repository della release appena uscita e aggiungere i repositori della Versione in fase di sviluppo.
In Installazione/CdMinimale aggiungere i nuovi collegamenti.
Un giro generale in installazione per aggiornare tutto è necesasrio.
- Aggiungere ad ogni guida il riferimento alla nuova doc ufficiale se presente.
- modificare su launchpad la macro informazioni pagina per aggiungere la nuova e deprecare quella fine rilascio.
Esperienze precedenti, utili per organizzarsi in futuro. Contiene ulteriori elementi che richiedono modifiche:
Strumenti wiki
Soggetti coinvolti: gruppo documentazione
StrumentiWiki è una pagina di appoggio di elementi che verranno inclusi all'interno dei portali per mezzo della Macro Include. Naviare all'interno delle sotto-pagine per comprenderne il contenuto.
Tali pagine sono modificabili da Admin ed Editori ed eliminabili solo dai primi.