#format wiki #LANGUAGE it <> {{{ 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 [[http://help.ubuntu-it.org|help.ubuntu-it.org]] è necessario fare quanto segue. Soggetti coinvolti: gruppo documentazione e chi ha accesso al server. * Installare sul proprio pc [[apt://bzr | 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 [[https://lists.ubuntu.com/archives/ubuntu-doc/2010-September/015185.html|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''' 0. Prendere come esempio questo file [[http://wiki.ubuntu-it.org/InterGruppi/NuoviRilasci?action=AttachFile&do=view&target=ubuntu-banner.xsl|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). 0. I file `ubuntu-banner.xsl` e [[http://wiki.ubuntu-it.org/InterGruppi/NuoviRilasci?action=AttachFile&do=view&target=ubuntu-book.css|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). 0. Prendere questo file chiamato [[http://wiki.ubuntu-it.org/InterGruppi/NuoviRilasci?action=AttachFile&do=view&target=logo.png|logo.png]] e metterlo in `/libs/img` per fare il modo che nell'header vada a finire il nostro logo e non quello internazionale. 0. Prendere un file [[http://wiki.ubuntu-it.org/InterGruppi/NuoviRilasci?action=AttachFile&do=view&target=index.xml|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. 0. 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. 0. Prendere l'index di poco fa e farne una copia chiamata ad esempio `ubuntu1010.html` e mettere questo fine in root. 0. 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. 0. 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:/' ; done }}} 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. 0. Fare una serie di verifiche affinché stili e formattazione rendano bene altrimenti trovare dei work-around. 0. 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. 0. Creare pagina '''!NomeVersioneNoteDiRilascio''' e creare un redirect verso '''https://wiki.ubuntu.com/NomeVersione/ReleaseNotes/'''. 0. 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). 0. Incollare i nuovi `.torrent` della pagina '''Installazione/ !NomeVersioneTorrent''' dentro [[DownloadTorrent]]. 0. Creare pagina '''Installazione/ !AggiornamentoNomeVersione''' e tradurre '''https://help.ubuntu.com/community/NomeVersioneUpgrades''' (collegare i torrent). 0. In [[Installazione|installazione]]: inserire la pagina del punto precedente sotto il paragrafo Avanzamenti diretti. 0. In [[Installazione/NoteAvanzamento|note di avanzamento]] aggiungere la pagina del punto tre. 0. In [[Repository/SourcesList]] aggiungere i repository della release appena uscita e aggiungere i repositori della Versione in fase di sviluppo. 0. In [[Installazione/CdMinimale]] aggiungere i nuovi collegamenti. 0. Aggiornare le pagine [[Ubuntu+1]] e [[Rilasci]]. 0. Un giro generale in [[Installazione|installazione]] per aggiornare tutto è necesasrio. 0. Aggiungere ad ogni guida il riferimento alla nuova doc ufficiale se presente. 0. 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: * [[GruppoDocumentazione/Precise]] = 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. ---- CategoryComunita