Dimensione: 8001
Commento: typo veloci. imcompleta
|
Dimensione: 8232
Commento:
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 41: | Linea 41: |
Prendere come esempio il file `ubuntu-banner.xsl` presente sul nostro repo di launchpad e correggere il numero di versione (mettere il numero di versione a cui riferisce la documentazione che stiamo compilando). | 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). |
Linea 43: | Linea 43: |
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). | 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). |
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: [apt://make,gettext,docbook-xsl,fop make, gettext, docbook-xsl, fop].
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 all'installazione in italiano è dalla versione 6.06 che non viene inserita. Con queste istruzioni proveremo a metterla.
Scaricare la guida all'installazione dal [https://launchpad.net/ubuntu/+source/installation-guide seguente indirizzo] scegliendo l'archivio tar.gz della versione di riferimento. Estrarre l'archivio e posizionare la cartella estratta all'interno della radice della cartella della documentazione ufficiale (scaricata con il comando bzr precedente). Un accortezza: come dice il commento nel makefile rinominare il file che che trova in istallation-guide/build che si chiama builone.sh così il makefile provvederà a formattarla con lo stile generale.
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.
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).
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).
Il file che sul nostro repo si chiama logo.png va messo in /libs/img per fare il modo che nell'header vada a finire il nostro logo e non quello internazionale.
Prendere un nostro recente file index.xml (quello che si trova sui repo si lp va bene) e tradurlo. Sostanzialmente si tratta di sostituire i percorsi che al momento menzionano la versione 10.10 e quindi di aggiornare i collegamenti per la versione che stiamo compilando. Questo file va messo nella radice della cartella della documentazione ufficiale (è meglio comparare i due file per non fare casini. Il loro file tenete conto che ha dei link morti quindi a mano bisogna aggiungere la guida server (tirare via advanced topic, vedere ultimo file da noi creato). Sempre a mano se si vuole fare si deve aggiungere la guida all'installazione.
Per quanto riguarda il motore di ricerca interno alla documentazione in passato è stato già creato e qui si tratta adesso solo di adattarlo. Se serve sapere come fare a crearne uno è meglio creare una guida a parte che io non lo so.
In questo caso prendere il file search.js e search.php. In entrambi controllare anno e numero di versione se presenti. I file search.js e search.css presenti sul repo si mettono in build/lib della documentazione e search.php in build in sostituzione del presente.
Fatto questo si passa alla compilazone vera e propria.
Dare un
make all
e aspettare. Il risultato sarà presente dentro la cartella build/ubuntu e quest'ultima va poi copiata tutta sul server.
Al termine per ottenere anche il pdf dare un
make serverguide-pdf
e aspettare che il pdf venga creato nella cartella build/ubuntu.
Ora bisogna caricare tutto sul server
Caricare il contenuto della cartella di build/ubuntu 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.Creare un file ubuntuVER.html (ad esempio ubuntu1010.html) nella cartella cartella radice della doc sul server /srv/help.ubuntu-it.org/www/
Modificare il file index.html presente in radice 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:/' ; 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.
- Fare una serie di verifiche affinché stili e formattazione rendano bene altrimenti trovare dei work-around.
COME SI TRADUCE? Note: the HTML documentation on help.ubuntu.com should always reflect the documentation as it appears in the applicable version of Ubuntu. Changes to the help.ubuntu.com branch should not be made without the StableReleaseUpdates procedure first being followed and an equivalent change being made to the mainline bzr branch for the Ubuntu version concerned.
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/it (qui il gruppo traduzione traduce: occhio da qualche parte in ubiquity bisogna fare una modifica per puntare e questa pagina e non al livello precedente).
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).
Creare pagina Installazione/AggiornamentoNomeVersione e tradurre https://help.ubuntu.com/community/NomeVersioneUpgrades (collegare all'interno la pagina del punto precedente).
In [:Installazione:installazione]: inserire la pagina del punto precedente sotto il paragrafo Avanzamenti diretti. Rimuovere dal paragrafo Avanzamenti diretti le versioni non più supportate.
In [:Installazione/NoteAvanzamento:note di avanzamento] aggiungere la pagina del punto tre e rimuovere le versioni non più supportate.
- In [:Repository/SourcesList] aggiungere i repository della release appena uscita, decommentare quelli delle versioni non più supportate e aggiungere i repositori della Versione in fase di sviluppo.
- In [:Installazione/CdMinimale] aggiungere i nuovi collegamenti e rimuovere i non più supportati
- Aggiungere in [:Installazione/MD5Sum] i nuovi MD5Sum ed eventualmente rimuovere i vecchi.
- Inserire in Ubuntu+1 i riferimenti alla nuova in fase di sviluppo.
Un giro generale in [:Installazione:installazione] per aggiornare tutto è necesasrio.
- Aggiungere ad ogni giuda il riferimento alla nuova doc ufficiale se presente.
- modificare su launchpad la macro informazioni pagina per aggiungere la nuova e deprecare quella fine rilascio
Strumenti wiki
Soggetti coinvolti: gruppo documentazione
questa è la pagina dove sono depositate le home page di ogni versione StrumentiWiki/Rilasci bisogna modificare il codice in documentazione indice e altro che non ricordo