Uso di cvs per accedere e aggiornare i sorgenti di moodle

CVS significa Concurrent Versioning System, sistema concorrente di versione; è un modo molto comune di raggruppare codici sorgenti perché mantiene versioni di ogni file in modo da non perdere mai nulla, l'utilizzo viene monitorato persona per persona e tutto il codice di ogni versione viene immagazzinato su un server centrale (nel caso di moodle su Sourceforge).

Se intendete accedere alla versione corrente di moodle solamente in lettura non avete bisogno di leggere questa pagina, seguite semplicemente le istruzioni di cvs sulla pagina download di Moodle.

Per usare l'archivio cvs di moodle (come sviluppatori con permessi di scrittura), dovete prima di tutto avere un account su sourceforge. Nell'esempio di questa pagina si assume che il vostro nome utente sia myusername e la vostra password mypassword. Seguite attentamente le istruzioni di sourceforge per creare la vostra directory per cvs, cosa necessaria per abilitare ogni nuovo account per cvs. In linea di massima dovete usare ssh per connettervi a cvs.sourceforge.net.

Una volta creato un account funzionante su sourceforge contattate Martin Dougiamas per avere i permessi di scrittura su determinate directory di moodle.

Per evitare la richiesta di password ogni volta che si esegue un comando cvs seguite le indicazioni di sourceforge per usare chiavi autorizzate. Questo è del tutto opzionale, ma vi renderà sicuramente la vita molto più facile nel vostro rapporto con cvs.

Fatto questo dovreste avere tutti i permessi necessari quindi, impostata la vostra macchina, potete scaricare la versione corrente dei sorgenti e iniziare a lavorarci sopra.
Qui sotto trovate le istruzioni per usare cvs con sistemi unix e windows.

01. Uso di cvs sotto unix

Il cvs di sourceforge usa un livello di trasporto ssh per sicurezza, dovrete quindi impostare questa variabile d'ambiente CVS_RHS sulla vostra shell unix:

setenv CVS_RSH ssh (for csh, tcsh etc)
export CVS_RSH=ssh (for sh, bash etc)

La cosa miglore è inserire queste righe nel file .bashrc o .cshrc per non doverle riscrive tutte le volte; dopodiché collegatevi a moodle usando questo comando (tutto in una riga, ovviamente):

cvs -z3 -d:ext:myusername@cvs.sourceforge.net:/cvsroot/moodle co moodle

Non provate a eseguire questo primo comando cvs in una directory di moodle preesistente, iniziate con una nuova.

Nota: vi verrà chiesta la password ad ogni comando se non avete impostato una chiave autorizzata

Ora dovreste avere una nuova directory 'moodle'. Potete rinominarla o spostarla a piacimento, entrate nella cartella:

cd moodle 

Tutti i files di moodle più recenti dovrebbero essere qui dentro. Ora potete sostituirli con i vostri files e confrontarli con la copia principale de server cvs. Per fare questo usate il comando diff, ad es.

cvs diff -c config-dist.php
cvs diff -c lang

Per ottenere gli aggiornamenti dal server usate

cvs update -dP 

Per copiare i vostri nuovi files sul server dovrete fare una cosa del genere:

cd lang/ca 
cvs commit 

Vi verrà richiesto di aggiungere alcuni commenti (dipende dal vostro editor testuale predefinito)... scrivete un commento sensato e chiudete l'editor, i files verranno inviati a sourceforge e lì immagazzinati. ecco fatto!

Per risparmiare tempo potete impostare gli argomenti di default dei comandi in un file chiamato .cvsrc nella vostra home directory. un esempio potrebbe essere:

diff -c 
update -dP 

Usate 'cvs help' per ulteriori dettagli...

 

02. Uso di cvs sotto windows

Prima di tutto scaricate la copia più recente di moodle usando il vostro account da sviluppatore

01. Procuratevi TortoiseCVS da tortoisecvs.org , installatelo sulla vostra macchina e riavviatela.

02. Cercate o create una cartella da qualche parte dove volete che venga scaricato moodle

03. Click col tasto destro sulla cartella scelta e scegliete 'CVS Checkout' dal menu, dovrebbe comparire una finestra

04. Copiate questo testo nel campo CVSROOT (usando il vostro nome utente!):

 :ext:myusername@cvs.sourceforge.net:/cvsroot/moodle

05. Premete il pulsante 'Fetch list...'.

06. Alla destra del pulsante dovreste vedere una serie di moduli, scegliete 'moodle' dalla lista.

07. Premete il pulsante 'OK' e dovrebbe venire scaricato il tutto..

Una finestra di dialogo dovrebbe mostrarvi ora tutti i files che vengono scaricati, pazientate un poco e avrete una copia completa di moodle.
Dopo questo primo controllo sul server di moodle potrete controllare un eventuale aggiornamento dei files sul server cvs:

01. Click col tasto destro sulla vostra cartella di moodle (o un qualsiasi file) e selezionate 'CVS Update'.

Dopo aver modificato un file (noterete che ha cambiato colore, da verde a rosso) potrete sottometterli al server cvs in questo modo:

01. Click col tasto destro sulla vostra cartella di moodle (o un qualsiasi file) e selezionate 'CVS Commit...'.

02. Nella finestra inserite una chiara descrizione dei cambiamenti che avete apportato.

03. Click su 'OK'. i vostri files verranno salvati sul server.

Buona fortuna!

 

Documentazione di Moodle

Version: $Id$