Introduzione

Questa pagina contiene informazioni utili per coloro che vogliono partecipare allo sviluppo e al mantenimento del codice di Chiedi.

Per poter sviluppare funzionalità è richiesta una conoscenza di Python e Django, mentre per modifiche al tema di HTML e CSS.

Scaricare una copia del sito in locale

Per poter mandare le modifiche è necessario avere un'istanza locale su cui effettuarle.
Su Ubuntu 12.04 LTS tutte le dipendenze sono alla giusta versione, per le release successive si consiglia l'aggiunta del PPA contenente le versioni corrette. Il PPA non è ancora stato testato.

Prerequisiti

Installare i seguenti pacchetti relativi a django, apache, database postgresql, subverson, bazaar, gettext:

sudo apt-get install python-django python-django-south python-django-openid-auth python-django-debug-toolbar python-migrate python-html5lib python-markdown python-elementtidy python-psycopg2 postgresql-9.1 apache2 libapache2-mod-wsgi subversion bzr gettext

Preparare il database

Assumiamo che l'utente proprietario del database sia postgresql.

• Configurare correttamente i permessi di postgresql modificando il file /etc/postgresql/9.1/main/pg_hba.conf, sostituendo le ultime righe con questo:

  # "local" is for Unix domain socket connections only
  host    all         all         192.168.1.20      255.255.255.0    md5 # <- 192.168.1.20 ip tua macchina
  local   all             all                                     peer
  # IPv4 local connections:
  host    all             all             127.0.0.1/32            md5
  # IPv6 local connections:
  host    all             all             ::1/128                 md5
  # Allow replication connections from localhost, by a user with the
  # replication privilege.
  #local   replication     postgres                                peer
  #host    replication     postgres        127.0.0.1/32            md5
  #host    replication     postgres        ::1/128                 md5

• Creare l'utente osqa:

  sudo su postgres
  createuser osqa
  psql -d template1 -U postgres
  alter user osqa with password 'la_tua_password';
  \q

• Creare il database osqa con proprietario postgres:

  createdb -O osqa osqa
  exit

Configurare apache

Assumiamo che il Virtual Host si chiami osqa e che la directory di installazione sia /var/www/osqa.

• Assicurarsi di avere abilitato il modulo wsgi:

  sudo a2enmod wsgi

• Copiare il seguente Virtual Host in /etc/apache2/sites-available/ chiamandolo osqa:

  WSGISocketPrefix ${APACHE_RUN_DIR}
  
  <VirtualHost *:80>
          DocumentRoot /var/www/osqa/
          ServerName http://localhost
          ServerAlias http://localhost
   
  
          Alias /osqa/m/ "/var/www/osqa/forum/skins/"
          <Directory "/var/www/osqa/forum/skins">
                  Order allow,deny
                  Allow from all
          </Directory>
  
          Alias /osqa/upfiles/ "/var/www/osqa/forum/upfiles/"
  
          <Directory "/var/www/osqa/forum/upfiles">
                  Order deny,allow
                  Allow from all
          </Directory>
  
          Alias /admin_media/ /usr/lib/python2.7/dist-packages/django/contrib/admin/media/
          <Directory /usr/lib/python2.7/dist-packages/django/contrib/admin/media>
              Order allow,deny
              Allow from all
          </Directory>
          WSGIScriptAlias / /var/www/osqa/osqa.wsgi
  
          CustomLog ${APACHE_LOG_DIR}/osqa.access.log common
          ErrorLog ${APACHE_LOG_DIR}/osqa.error.log
  </VirtualHost>

• Abilitare il virtualhost e riavviare il servizio:

  sudo a2ensite osqa
  sudo service apache2 restart

Installare osqa

• Scaricare il branch di Chiedi Ubuntu-it e copiarlo poi in /var/www:

  bzr branch lp:ubuntu-it-ask

• Rinominare la cartella /var/www/ubuntu-it-ask in /var/www/osqa (nota bene: la cartella DEVE chiamarsi per forza osqa).

• Rinominare osqa.wsgi.dist in osqa.wsgi, quindi cambiare i path:

  sys.path.append('/var/www')
  sys.path.append('/var/www/osqa')

• Rinominare settings_local.py.dist in settings_local.py e modificarlo affinché rifletta la reale configurazione della propria macchina. I principali parametri da configurare sono questi:

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.postgresql_psycopg2',
          'NAME': 'osqa',
          'USER': 'osqa',
          'PASSWORD': 'la_password_dell'utente_postgres',
          'HOST': 'localhost',
          'PORT': '',
      }
  }
  
  APP_URL = 'http://localhost'
  
  TIME_ZONE = 'Europe/Rome'
  
  OSQA_DEFAULT_SKIN = 'light' ## <-- è il tema di ubuntu-it, quello predefinito si chiama default
  
  DISABLED_MODULES = ['books', 'recaptcha', 'project_badges', 'mysqlfulltext']

• Popolare il database (comandi da dare in /var/www/osqa):

  sudo python manage.py syncdb --all (dire no alla richiesta di creare un super utente)
  sudo python manage.py migrate forum --fake

• Generare le ultime traduzioni (sempre da /var/www/osqa):

  cp locale/it/LC_MESSAGES/it.po locale/it/LC_MESSAGES/django.po 
  msgfmt locale/it/LC_MESSAGES/django.po -o locale/it/LC_MESSAGES/django.mo
  sudo python manage.py makemessages -l it

Nota sulle traduzioni: in realtà la traduzione più aggiornata è sempre questa. Per applicarla seguire gli stessi passi.

Assegnare i permessi corretti

sudo chown -R www-data:www-data /var/www/osqa
sudo chmod -R g+w /var/www/osqa/forum/upfiles
sudo chmod -R g+w /var/www/osqa/log

Prova

Riavviare apache e postgres, per sicurezza per l'ultima volta e andare su http://localhost. Dovrebbe funzionare.

Un passo in più

Non indispensabile, ma se si volesse utilizzare la medesima configurazione in uso su chiedi.ubuntu-it.org:

• Fare un backup della tabella di configurazione:

  pg_dump osqa --clean -O -t forum_keyvalue -f mia_tabella.sql -U postgres -W

• Importare il database in questo modo:

  psql -U postgres osqa -W < 00-forum_keyvalue.sql

• Sync db:

  sudo python /var/www/osqa/manage.py syncdb

Iniziare a sviluppare

Benissimo, ora si può iniziare a sviluppare.

Modificare il tema

Il tema di Chiedi è ben fatto, ma può essere migliorato.

I files del tema si trovano in forum/skins/light.

Modifica dello stile

Lo stile è presente in forum/skins/light/media, nelle sottocartelle styles e images.
Effettuare le modifiche ai files e controllare che non ci siano effetti inaspettati nelle pagine.

Modifica del contenuto delle pagine

Per prima cosa controllare in che file è posizionato il contenuto della pagina scelta guardando in forum/skins/default/templates. Poi guardare se il file è presente in forum/skins/light/templates e, in caso macasse, copiarlo.

Effettuare poi le modifiche nella copia del file presente in forum/skins/light/templates. Mai modificare i files in forum/skins/default/templates.

Modifica del funzionamento della piattaforma

Per modificare il funzionamento della piattaforma agire sui files presenti in forum e forum_modules.

Pubblica le tue modifiche

Preparazione del codice

Prima di caricare le modifiche è bene, oltre a testare i cambiamenti, pulire il codice.
Infatti non bisogna lasciare alcuna traccia di test o codici inutili.

È bene infatti scaricare l'ultima revisione del nostro repository e riapplicaci le modifiche, in modo da lasciare meno tracce possibili.

Caricamento su launchpad

In caso che la modifica risolve un bug utilizzare i seguenti comandi sostituendo ####### con l'id del bug:

bzr commit --fixes lp:####### -m 'Descrivi le modifiche'
bzr push lp:~tuonome/ubuntu-it-ask/fix-lp#######

Altrimenti:

bzr commit -m 'Descrivi le tue modifiche'
bzr push lp:~tuonome/ubuntu-it-ask/nome_repo

Presentazione delle modifiche

Fai una merge request via launchpad sui branch lp:~ubuntu-it-ask/ubuntu-it-ask/stable e lp:~ubuntu-it-ask/ubuntu-ask/development, poi scrivi in mailing list presentando dettagliatamente le tue modifiche.

Uno o più amministratori testeranno le modifiche sulla loro istanza locale e poi comunicheranno il risultato dei test.

In caso positivo verranno caricate le modifiche sul server di test del gruppo, e dopo altri test sul server di Chiedi.

Per chi vuole studiare

• Non conosci bazaar?

  • Guida su bazaar

  • Casi d'uso

  • Guida ufficiale completa

• Non conosci Django? Documentazione di Django

• Non conosci OSQA?

  • Meta ufficiale

  • Wiki

CategoryComunita