Differenze tra le versioni 17 e 54 (in 37 versioni)

Gruppo Doc	Organizzazione	Lavoro svolto	Blog del wiki
A cura del Gruppo Documentazione

Indice

Introduzione
Requisiti
Procedura generale
1. Aggiungere file
2. Attuare un merge
Altre modifiche
Ulteriori risorse

Introduzione

Il codice sorgente del Wiki è ospitato su Launchpad nella pagina wiki-repo.

Di seguito vengono riportate le operazioni necessarie per interagire con la piattaforma, sia per gli aggiornamenti di routine sia per modifiche supplementari.

Requisiti

Avere installato il pacchetto bzr.
Avere impostato una chiave ssh su Launchpad come mostrato nella seguente pagina.

Procedura generale

Per scaricare nella propria Home la directory wiki-repo ospitata su Launchpad, procedere con i seguenti passaggi.

Identificarsi attraverso il software Bazaar con il comando nella forma:
```
bzr whoami "Nome Cognome <indirizzo_email>"
```
Se l'utente si chiama ad es. Mario Rossi e utilizza l'email m.rosssi@mail.com, il comando diviene:
```
bzr whoami "Mario Rossi <m.rossi@mail.com>"
```
Effettuare il login digitando il comando nella forma:
```
bzr launchpad-login nickname_launchpad
```
Se il nickname utilizzato su Launchpad è mario il comando diviene:
```
bzr launchpad-login mario
```
Scaricare la directory del wiki-repo nella propria Home digitando:
```
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
```
Apportare le modifiche ai file interessati.
Spostarsi nella directory ~/wiki-repo:
```
cd ~/wiki-repo
```
Effettuare il commit per salvare le modifiche apportate nella revisione, avendo cura di inserire una brevissima descrizione dei cambiamenti:
```
bzr commit -m "Inserire_qui_breve_messaggio_descrittivo"
```
Eseguire in fine il push per caricare le modifiche sul server:
```
bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
```

Aggiungere file

Può capitare di dover aggiungere file, come ad esempio una nuova macro. In tal caso eseguire questi passaggi.

Eseguire i passi mostrati in precedenza fino al download della directory wiki-repo nella propria Home.
Copiare il file all'interno della cartella di destinazione.
Spostarsi nella medesima cartella con il terminale digitando:
```
cd ~/wiki-repo/PERCORSO_DI_DESTINAZIONE
```
Dare quindi il comando:
```
bzr add NOME_FILE
```
sostituendo NOME_FILE con il vero nome del file.
Sempre rimanendo nella medesima cartella eseguire commit e push come mostrato nel paragrafo precedente.

Attuare un merge

Può succedere che un utente con account Launchpad proponga delle migliorie da apportare al codice del wiki attraverso gli strumenti messi a disposizione da Launchpad stesso. In tal caso può apportare le migliorie su di un proprio branch e quindi richiedere un merge sul progetto originale.

Supponendo che un utente abbia creato il branch lp:~username/wiki-ubuntu-it/nome-branch e che abbia fatto una merge request, seguire questi passaggi per applicare le modifiche proposte.

Launchpad notificherà la richiesta agli amministratori, che potranno recarsi alla relativa pagina (pagina di esempio) per segnare lo stato come Approved e inserire in basso il commento merge-approved.
Dopo aver effettuato il login su Bazaar, scaricare entrambe le directory wiki-repo e nome-branch nella propria Home con i comandi:
```
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
```
```
bzr branch lp:~username/wiki-ubuntu-it/nome-branch
```
Spostarsi nella cartella wiki-repo:
```
cd ~/wiki-repo
```
Eseguire il merge con il comando:
```
bzr merge ~/nome-branch
```

Eseguire quindi commit e push:

bzr commit -m "Inserire_qui_breve_messaggio_descrittivo"

bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo

Automaticamente lo status della richiesta passerà da approved a merged.

Altre modifiche

Per elaborare modifiche di vario genere, come ad esempio al tema grafico, è opportuno lavorare in locale su un'installazione di MoinMoin Desktop Edition. Per ricreare l'aspetto originario del wiki procedere con i seguenti passi:

Installare sul proprio sistema MoinMoin Desktop Edition.
Scaricare la directory wiki-repo.

Copiare i file di configurazione:

cp ~/wiki-repo/data/plugin/theme/light.py ~/mywiki/data/plugin/theme/

sudo cp -pR ~/wiki-repo/htdocs/light /usr/share/moin/htdocs/

Settare il parametro theme_default nel file ~/mywiki/wikiconfig.py nel seguente modo:
```
theme_default = 'light'
```
Perché la macro informazioni funzioni è necessario installare il pacchetto python-distro-info:
```
sudo apt install python-distro-info
```
copiare quindi le macro esistenti:
```
cp ~/wiki-repo/data/plugin/macro/*.py ~/mywiki/data/plugin/macro/
```

Creare una copia di backup del file favicon.ico:

sudo cp /usr/share/moin/htdocs/favicon.ico /usr/share/moin/htdocs/favicon_backup.ico

e quindi sostituire l'icona del wiki:

sudo cp -p ~/wiki-repo/htdocs/favicon.ico /usr/share/moin/htdocs/

Questi sono i principali file per attuare modifiche allo stile grafico del wiki:

light.py: internamente al codice Python si trova il codice html che costituisce la struttura dell'header e del footer del sito;
directory css: all'interno di questa cartella sono presenti i fogli di stile, in particolare i file common.css e screen.css. Qui è possibile settare le varie regole per il colore degli elementi, grandezza carattere, ecc..

Ulteriori risorse

CategoryComunitaDocumentazione

-  ⇤ ← Versione 17 del 10/04/2014 11.10.21 → 
  Dimensione: 8956
  Autore: jeremie2
  Commento:
+   ← Versione 54 del 02/03/2021 14.32.09 → ⇥
  Dimensione: 6589
  Autore: jeremie2
  Commento: macro informazione ora funzionante in locale
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 1:
-<<Indice>>
<<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?f=46&t=540067"; rilasci="12.10 12.04 13.04 13.10")>>
+## page was renamed from jeremie2/Prove4
#LANGUAGE it
#format wiki
<<Include(GruppoDocumentazione/Header2)>>
-Linea 4:
+Linea 6:
+<<Indice(depth=2)>>
-Linea 7:
+Linea 10:
-A partire dal 2010 nei pc è stata introdotta la tecnologia [[http://it.wikipedia.org/wiki/UEFI|UEFI]] che andrà nel tempo a sostituire i classici [[http://it.wikipedia.org/wiki/BIOS|BIOS]].
Nella seguente guida verranno approfondite le caratteristiche dello '''UEFI''' e le differenze rispetto al passato di cui tener conto per poter installare Ubuntu sia in dual boot con Windows che da solo.
+Il codice sorgente del [[Documentazione|Wiki]] è ospitato su '''Launchpad''' nella pagina [[https://code.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo|wiki-repo]].
-Linea 10:
+Linea 12:
-= Caratteristiche =
+Di seguito vengono riportate le operazioni necessarie per interagire con la piattaforma, sia per gli aggiornamenti di routine sia per modifiche supplementari.
-Linea 12:
+Linea 14:
-Rispetto ai classici bios lo Uefi può presentarsi con una veste grafica più moderna. Alcune delle caratteristiche più importanti sono date da:
 * '''Partizionamento GPT''': nuovo standard per la gestione delle partizioni del disco, che sostituisce l'MBR (Master Boot Record) e quindi utilizzo di sole partizioni primarie senza più la necessità di partizioni estese e logiche.
 * '''Partizione EFI''': è una partizione in formato Fat32 collocata all'inizio del disco e necessaria per l'avvio dei sistemi operativi.
 * '''Secure boot''': sistema attraverso il quale il computer permette l'avvio di un sistema operativo solo se dotato di una determinata chiavi di sicurezza. È una modalità introdotta con Windows 8.
 * '''Modalità legacy''': serve per installare sistemi che non supportano l'Uefi.
+= Requisiti =
-Linea 18:
+Linea 16:
-Dal manuale in dotazione dovrebbe essere indicato se sul PC è presente la tecnologia '''UEFI''' e se è attivata. È comunque possibile accertarsene accedendo al gestore delle partizioni del sistema '''Windows''' preinstallato.
+ * Avere installato il pacchetto [[apt://bzr|bzr]].
 * Avere impostato una chiave '''ssh''' su Launchpad come mostrato nella [[GruppoWeb/Planet#Installare_una_versione_recente_di_.27.27bzr.27.27|seguente pagina]].
-Linea 20:
+Linea 19:
-||<style="border:none; "> <<Immagine(Installazione/UEFI/gestore_dischi.png,450,center)>>||<style="border:none; ">Nell'immagine si nota che la voce '''EFI''' appare sulla prima partizione da 100 MiB in formato FAT 32. Da notare che nella schermata non compare una partizione di 128 MiB riservata a Windows.||
+<<Anchor(branch)>>
= Procedura generale =
 Linea 22:
-= Disattivazione secure boot =
+Per scaricare nella propria '''Home''' la directory '''wiki-repo''' ospitata su [[http://bazaar.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo/files|Launchpad]], procedere con i seguenti passaggi.
 Linea 24:
-Attraverso un [[http://it.wikipedia.org/wiki/Windows_RT#Avvio_protetto|accordo]] Microsoft/produttori hardware, l'introduzione del '''secure boot''' fa in modo che Windows 8 sia l'unico sistema "fidato" da poter avviare su di un computer. In gran parte dei modelli si tratta di una modalità disattivabile, tuttavia esistono casi come ad esempio macchine con architettura ''ARM certificate per Windows RT'', nelle quali non è possibile disattivarlo e pertanto non potranno essere utilizzati altri sistemi.
+<<Anchor(login)>>
 0. Identificarsi attraverso il software [[Programmazione/Bazaar|Bazaar]] con il comando nella forma:{{{
bzr whoami "Nome Cognome <indirizzo_email>"
}}}Se l'utente si chiama ad es. '''Mario Rossi''' e utilizza l'email `m.rosssi@mail.com`, il comando diviene:{{{
bzr whoami "Mario Rossi <m.rossi@mail.com>"
}}}
 0. Effettuare il login digitando il comando nella forma:{{{
bzr launchpad-login nickname_launchpad
}}}Se il nickname utilizzato su Launchpad è '''mario''' il comando diviene:{{{
bzr launchpad-login mario
}}}
 0. Scaricare la directory del '''wiki-repo''' nella propria '''Home''' digitando: {{{
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
}}}
 0. Apportare le modifiche ai file interessati.
 0. Spostarsi nella directory `~/wiki-repo`:{{{
cd ~/wiki-repo
}}}
 0. Effettuare il '''commit''' per salvare le modifiche apportate nella revisione, avendo cura di inserire una brevissima descrizione dei cambiamenti:{{{
bzr commit -m "Inserire_qui_breve_messaggio_descrittivo"
}}}
 0. Eseguire in fine il '''push''' per caricare le modifiche sul server:{{{
bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
}}}
-Linea 26:
+Linea 49:
-||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''In fase di acquisto di un computer, accertarsi che il secure boot sia '''disattivabile''' in modo che possa essere avviabile Ubuntu o altro sistema.'' ||
+== Aggiungere file ==
-Linea 28:
+Linea 51:
-||<style="border:none; "> <<Immagine(Installazione/UEFI/Secure_Boot.jpg,400,center)>>||<style="border:none; ">Qui accanto vi è un esempio di schermata in cui il '''secure boot''' è abilitato. Per poter permettere l'avvio di altri sistemi è necessario cambiare lo stato da '''Enable''' a '''Disabled'''. ||
+Può capitare di dover aggiungere file, come ad esempio una nuova macro. In tal caso eseguire questi passaggi.
-Linea 30:
+Linea 53:
-= Avvio della Live =
+. Eseguire i passi mostrati in precedenza fino al download della directory '''wiki-repo''' nella propria '''Home'''.
 0. Copiare il file all'interno della cartella di destinazione.
 0. Spostarsi nella medesima cartella con il terminale digitando:{{{
cd ~/wiki-repo/PERCORSO_DI_DESTINAZIONE
}}}
 0. Dare quindi il comando:{{{
bzr add NOME_FILE
}}}sostituendo NOME_FILE con il vero nome del file.
 0. Sempre rimanendo nella medesima cartella eseguire '''commit''' e '''push''' come mostrato nel paragrafo precedente.
-Linea 32:
+Linea 63:
-Per poter utilizzare Ubuntu su di un computer con Uefi è necessario [[DownloadTorrent|procurarsi]] un'immagine iso per DVD/USB Live a '''64 bit'''.
+== Attuare un merge ==
-Linea 34:
+Linea 65:
-||<style="border:none; "> <<Immagine(Installazione/UEFI/UEFI.jpg,400,center)>>||<style="border:none; "> <<Immagine(Icone/Piccole/warning.png,,center)>>||<style="border:none; ">'''__IMPORTANTE__: Avviare il boot dalla periferica scelta per l'installazione selezionando la riga contenente la scritta UEFI e la periferica di boot'''.||
+Può succedere che un utente con account Launchpad proponga delle migliorie da apportare al codice del wiki attraverso gli strumenti messi a disposizione da Launchpad stesso. In tal caso può apportare le migliorie su di un proprio branch e quindi richiedere un '''merge''' sul progetto originale.
-Linea 36:
+Linea 67:
-||<style="border:none; "> <<Immagine(Installazione/UEFI/Grub.jpg,400,center)>>||<style="border:none; ">Se l'operazione precedente è andata a buon fine comparirà la schermata di '''Grub''' con sfondo nero come quella in figura.||
+Supponendo che un utente abbia creato il branch `lp:~username/wiki-ubuntu-it/nome-branch` e che abbia fatto una '''merge request''', seguire questi passaggi per applicare le modifiche proposte.
 0. Launchpad notificherà la richiesta agli amministratori, che potranno recarsi alla relativa pagina ([[https://code.launchpad.net/~21stefano/wiki-ubuntu-it/wiki-repo-with-msg-releases/+merge/326072|pagina di esempio]]) per segnare lo stato come '''Approved''' e inserire in basso il commento '''merge-approved'''.
 0. Dopo aver effettuato il [[#login|login]] su '''Bazaar''', scaricare entrambe le directory '''wiki-repo''' e '''nome-branch''' nella propria '''Home''' con i comandi:{{{
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo}}}{{{
bzr branch lp:~username/wiki-ubuntu-it/nome-branch
}}}
 0. Spostarsi nella cartella `wiki-repo`:{{{
cd ~/wiki-repo
}}}
 0. Eseguire il '''merge''' con il comando:{{{
bzr merge ~/nome-branch
}}}
 0. Eseguire quindi commit e push:{{{
bzr commit -m "Inserire_qui_breve_messaggio_descrittivo"
}}}{{{
bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
}}}Automaticamente lo status della richiesta passerà da '''approved''' a '''merged'''.
-Linea 38:
+Linea 85:
-<<Anchor(standard)>>
||<style="border:none; "> <<Immagine(Installazione/UEFI/install_00_precise.png,300,center)>>||<style="border:none; ">Se si dovesse visualizzare la classica schermata, occorre riavviare il pc e fare attenzione a selezionare la voce corretta.<<BR>><<BR>>'''Avviare l'installazione da questa schermata comporterebbe un errore nel boot loader, che può comunque essere riparato come indicato nell'apposito [[#bootloader|paragrafo]]'''.||
+<<Anchor(altre_modifiche)>>
= Altre modifiche =
-Linea 41:
+Linea 88:
-Selezionando dal menù di '''Grub''' la voce '''Try Ubuntu without installing''' e premendo '''Invio''' verrà avviata la modalità live.
+Per elaborare modifiche di vario genere, come ad esempio al tema grafico, è opportuno lavorare in locale su un'installazione di '''!MoinMoin Desktop Edition'''. Per ricreare l'aspetto originario del wiki procedere con i seguenti passi:
-Linea 43:
+Linea 90:
-In questa fase vale la raccomandazione di testare il corretto funzionamento del proprio hardware (connessione internet, scheda audio, scheda video, ecc..) prima di passare all'[[Installazione/Grafica#Avvio_della_Live|installazione]] vera e propria del sistema.
+. Installare sul proprio sistema [[Ufficio/MoinMoinDesktopEdition|MoinMoin Desktop Edition]].
 0. [[#branch|Scaricare]] la directory `wiki-repo`.
 0. Copiare i file di configurazione: {{{
cp ~/wiki-repo/data/plugin/theme/light.py ~/mywiki/data/plugin/theme/
}}}{{{
sudo cp -pR ~/wiki-repo/htdocs/light /usr/share/moin/htdocs/
}}}
 0. Settare il parametro '''theme_default''' nel file `~/mywiki/wikiconfig.py` nel seguente modo:{{{
theme_default = 'light'
}}}
 0. Perché la macro ''informazioni'' funzioni è necessario installare il pacchetto ''python-distro-info'':{{{
sudo apt install python-distro-info
}}}copiare quindi le '''macro''' esistenti:{{{
cp ~/wiki-repo/data/plugin/macro/*.py ~/mywiki/data/plugin/macro/
}}}
 0. Creare una copia di backup del file favicon.ico: {{{
sudo cp /usr/share/moin/htdocs/favicon.ico /usr/share/moin/htdocs/favicon_backup.ico
}}}e quindi sostituire l'icona del wiki:{{{
sudo cp -p ~/wiki-repo/htdocs/favicon.ico /usr/share/moin/htdocs/
}}}
-Linea 45:
+Linea 111:
-= Partizionamento GPT e partizione EFI =

Lo '''UEFI''' prevede l'utilizzo della tabella di [[Hardware/DispositiviPartizioni/GestioneDisco#Tabella_delle_partizioni_GPT_e_MBR|partizionamento GPT]] e la presenza della [[Hardware/DispositiviPartizioni/GestioneDisco#Utilizzo_delle_partizioni|partizione EFI]] di avvio. Se un computer è stato acquistato con Windows preinstallato, il disco avrà già una tabella delle partizioni GPT e sarà già stata predisposta una partizione EFI che verrà automaticamente rilevata da Ubuntu.

Se invece si avesse la necessità di installare Ubuntu su di un disco ancora da formattare, sarà necessario:
 0. Creare la tabella delle partizioni '''gpt'''.
 0. Creare la partizione '''EFI''' con le seguenti caratteristiche:
  * Deve trovarsi all'inizio del disco e in formato '''fat32'''.
  * La dimensione deve essere fra i 100 MiB e i 250 MiB.
  * Deve avere attivo il ''flag'' '''boot'''.

La procedura è mostrata passo passo nella guida al [[Hardware/DispositiviPartizioni/PartizionamentoManuale#UEFI_-_Tabella_partizioni_GPT|partizionamento manuale]].

Da notare che è frequente il caso in cui con Windows preinstallato sia stata creata una '''partizione nascosta di ripristino'''. In questi casi sarà la partizione nascosta ad essere al primo posto e la partizione '''EFI''' in seconda posizione.<<BR>>
In figura vengono riportati due casi, a sinistra la partizione '''EFI''' è in prima posizione, mentre a destra si nota al primo posto la partizione nascosta in '''ntfs'''. 

||<style="border:none; "><<Immagine(Hardware/DispositiviPartizioni/PartizionamentoManuale/gpt-part.png,450,center)>>||<style="border:none; "><<Immagine(Hardware/DispositiviPartizioni/PartizionamentoManuale/gpt_part-win.png,450,center)>> ||

= Sequenza di avvio =

Un'altra particolarità legata a '''UEFI''' è la caratteristica di aver elencati i sitemi operativi nella sequenza di boot delle periferiche (boot da CDROM, USB, hard disk).

||<style="border:none; "><<Immagine(Installazione/UEFI/BootPostInst.png,450,center)>>||<style="border:none; ">È importante che Ubuntu appaia '''prima''' di Windows, in modo tale che il boot loader di Ubuntu possa entrare in funzione e avere quindi la possibilità di avviare uno dei due sistemi. In caso contrario si avvierà solo Windows.||

<<Anchor(bootloader)>>
= Riparazione bootloader =

Se Ubuntu è stato installato per sbaglio avviando la live nel modo [[#standard|standard]] su un pc avente l'UEFI abilitato, il sistema non si avvierà ed occorrerà riparare il bootloader seguendo i successivi passaggi:

 0. Scaricare l'iso di [[https://sourceforge.net/p/linux-secure/wiki/Home/|Linux-Secure-Remix]] 64 bit.
 0. [[Hardware/DispositiviPartizioni/MasterizzareIso|Masterizzare]] il file .iso su un CD o un DVD oppure creare da questo una live usb.
 0. Effettuare il boot dal supporto utilizzato precedentemente e avviare '''Boot-Repair'''.
 0. Selezionare '''''Advanced options → GRUB location'''''.
 0. Selezionare la riga '''Separate /boot/efi partition''' e fare clic sul pulsante '''Applica'''.<<BR>>Nel caso la riga non fosse selezioanbile significa che la partizione EFI è assente. Può essere creata come spiegato nel paragrafo precedente.
 0. Riavviare il sistema e rimuovere il supporto utilizzato. Ubuntu ripartirà normalmente.

= Come identificare Ubuntu in modalità UEFI =

Un'installazione di Ubuntu in modalità UEFI presenta le seguenti caratteristiche:

 * il file `/etc/fstab` elenca una partizione EFI con punto di montaggio `/boot/efi`;
 * utilizza il bootloader '''grub-efi''' e non '''grub-pc''';
 * digitando in una finestra di [[AmministrazioneSistema/RigaDiComando|terminale]] il comando:{{{ 
dmesg | grep "EFI v"
 }}} l'output sarà simile al seguente:{{{
[    0.000000] EFI v2.31 by American Megatrends
 }}}In assenza dell'interfaccia UEFI o in caso sia disabilitata, non verrà visualizzato alcun output.
+Questi sono i principali file per attuare modifiche allo stile grafico del wiki:
 * [[https://bazaar.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo/view/head:/data/plugin/theme/light.py|light.py]]: internamente al codice Python si trova il codice html che costituisce la struttura dell'header e del footer del sito;
 * [[http://bazaar.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo/view/head:/htdocs/light/css/|directory css]]: all'interno di questa cartella sono presenti i fogli di stile, in particolare i file `common.css` e `screen.css`. Qui è possibile settare le varie regole per il colore degli elementi, grandezza carattere, ecc..
-Linea 95:
+Linea 117:
- * [[https://help.ubuntu.com/community/UEFI | Guida in lingua inglese]]
 * [[http://doc.ubuntu-fr.org/efi|Guida in lingua francese]]
 * [[https://help.ubuntu.com/community/Boot-Repair|Guida in inglese Boot-Repair]]
+ * [[https://code.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo|Hompage del wiki-repo]]
 * [[Ufficio/MoinMoinDesktopEdition|MoinMoin Desktop Edition]]
 * [[Programmazione/Bazaar|Guida a Bazaar]]
-Linea 100:
+Linea 122:
-CategoryInstallazioneSistema
+CategoryComunitaDocumentazione