Wiki Ubuntu-it

Indice
Partecipa
FAQ
Wiki Blog
------------------
Ubuntu-it.org
Forum
Chiedi
Chat
Cerca
Planet
  • Pagina non alterabile
  • Informazioni
  • Allegati
  • Differenze per "GruppoDocumentazione/Launchpad"
Differenze tra le versioni 26 e 54 (in 28 versioni)
⇤ ← Versione 26 del 23/07/2015 15.36.29 →
Dimensione: 1805
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: Linea 1:
## page was renamed from jeremie2/Prove4
Linea 3: Linea 4:
<<Include(GruppoDocumentazione/Header2)>>
Linea 8: Linea 10:
La seguente pagina mostra le attività di manutenzione del [[Documentazione/Indice|Wiki]] e della [[http://help.ubuntu-it.org/|Documentazione ufficiale]] su '''Launchpad''', la piattaforma che ospita i progetti del Gruppo Documentazione. 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:
= Branch wiki = 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:
 1. Requisiti: avere installato '''Bazaar''' e impostato una chiave '''ssh''' su Launchpad come mostrato nella [[GruppoWeb/Planet#Installare_una_versione_recente_di_.27.27bzr.27.27|seguente pagina]].
 2. Scaricare in locale la directory '''wiki-repo''' ospitata su [[http://bazaar.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo/files|Launchpad]]:{{{
bzr whoami "NOME COGNOME <INDIRIZZO_@_E-MAIL>"
bzr launchpad-login NICKNAME-LAUNCHPAD		 = Requisiti =

 * 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]].

<<Anchor(branch)>>
= Procedura generale =

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.

<<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: {{{
Linea 17: Linea 37:
}}}Nella propria '''Home''' apparirà la cartella `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 19: Linea 49:
= Tema light per MoinMoin Desktop Edition = == Aggiungere file ==
Linea 21: Linea 51:
 * '''Copia file di configurazione''': copiare nell'installazione di [[Ufficio/MoinMoinDesktopEdition|MoinMoin Desktop Edition]] i seguenti file: {{{ Può capitare di dover aggiungere file, come ad esempio una nuova macro. In tal caso eseguire questi passaggi.

 0. 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.

== 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.
 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'''.

<<Anchor(altre_modifiche)>>
= 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:

 0. Installare sul proprio sistema [[Ufficio/MoinMoinDesktopEdition|MoinMoin Desktop Edition]].
 0. [[#branch|Scaricare]] la directory `wiki-repo`.
 0. Copiare i file di configurazione: {{{
Linea 23: Linea 94:
}}}{{{
Linea 25: Linea 97:
 0. '''Tema di default''': settare il parametro '''theme_default''' nel file `~/mywiki/wikiconfig.py` nel seguente modo:{{{  0. Settare il parametro '''theme_default''' nel file `~/mywiki/wikiconfig.py` nel seguente modo:{{{
Linea 28: Linea 100:
 * '''Importare le macro''':{{{  0. Perché la macro ''informazioni'' funzioni è necessario installare il pacchetto ''python-distro-info'':{{{
sudo apt install python-distro-info
}}}copiare quindi le '''macro''' esistenti:{{{
Linea 31: Linea 105:
 * '''Importare icona favicon.ico''': creare una copia di backup del file: {{{  0. Creare una copia di backup del file favicon.ico: {{{
Linea 33: Linea 107:
}}}e quindi sostituire l'icona:{{{ }}}e quindi sostituire l'icona del wiki:{{{
Linea 37: Linea 111:
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..

= Ulteriori risorse =

 * [[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 38: Linea 122:
CategoryHomepage CategoryComunitaDocumentazione


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.

  1. 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>"

  2. 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

  3. Scaricare la directory del wiki-repo nella propria Home digitando: 

    bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
  4. Apportare le modifiche ai file interessati.

  5. Spostarsi nella directory ~/wiki-repo:

    cd ~/wiki-repo

  6. 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"

  7. 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.

  1. Eseguire i passi mostrati in precedenza fino al download della directory wiki-repo nella propria Home.

  2. Copiare il file all'interno della cartella di destinazione.

  3. Spostarsi nella medesima cartella con il terminale digitando:

    cd ~/wiki-repo/PERCORSO_DI_DESTINAZIONE

  4. Dare quindi il comando:

    bzr add NOME_FILE
    sostituendo NOME_FILE con il vero nome del file.

  5. 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.

  1. 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.

  2. 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

  3. Spostarsi nella cartella wiki-repo:

    cd ~/wiki-repo

  4. Eseguire il merge con il comando:

    bzr merge ~/nome-branch

  5. 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:

  1. Installare sul proprio sistema MoinMoin Desktop Edition.

  2. Scaricare la directory wiki-repo.

  3. 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/

  4. Settare il parametro theme_default nel file ~/mywiki/wikiconfig.py nel seguente modo:

    theme_default = 'light'

  5. 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/

  6. 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