Dimensione: 8478
Commento:
|
Dimensione: 10241
Commento:
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 14: | Linea 14: |
Per via delle dipendenze consigliato installarlo solo su Ubuntu 12.04 LTS, in quanto i pacchetti nelle altre release non sono nella versione corretta. | Su Ubuntu 12.04 LTS tutte le dipendenze sono alla giusta versione, per le release successive si consiglia l'aggiunta del [[https://launchpad.net/~ubuntu-it-ask-devel/+archive/osqa-compatibility|PPA]] contenente le versioni corrette. |
Linea 108: | Linea 108: |
* Rinominare osqa.wsgi.dist in osqa.wsgi, quindi cambiare i path: {{{ | * Copiare osqa.wsgi.dist su osqa.wsgi, quindi modificare osqa.wsgi cambiando i path: {{{ |
Linea 112: | Linea 112: |
* modificare settings_local.py affinché rifletta la reale configurazione della propria macchina. A titolo di esempio: {{{ | * Copiare settings_local.py.dist su settings_local.py e modificare settings_local.py affinché rifletta la reale configurazione della propria macchina. A titolo di esempio: {{{ # encoding:utf-8 import os.path SITE_SRC_ROOT = os.path.dirname(__file__) LOG_FILENAME = 'django.osqa.log' #for logging import logging logging.basicConfig( filename=os.path.join(SITE_SRC_ROOT, 'log', LOG_FILENAME), level=logging.ERROR, format='%(pathname)s TIME: %(asctime)s MSG: %(filename)s:%(funcName)s:%(lineno)d %(message)s', ) #ADMINS and MANAGERS ADMINS = () MANAGERS = ADMINS DEBUG = False DEBUG_TOOLBAR_CONFIG = { 'INTERCEPT_REDIRECTS': True } TEMPLATE_DEBUG = DEBUG INTERNAL_IPS = ('127.0.0.1',) |
Linea 118: | Linea 144: |
'PASSWORD': 'la_password_dell'utente_postgres', | 'PASSWORD': 'password', |
Linea 124: | Linea 150: |
CACHE_BACKEND = 'file://%s' % os.path.join(os.path.dirname(__file__),'cache').replace('\\','/') #CACHE_BACKEND = 'dummy://' SESSION_ENGINE = 'django.contrib.sessions.backends.db' # This should be equal to your domain name, plus the web application context. # This shouldn't be followed by a trailing slash. # I.e., http://www.yoursite.com or http://www.hostedsite.com/yourhostapp |
|
Linea 126: | Linea 159: |
OSQA_DEFAULT_SKIN = 'light' ## <-- è il tema di ubuntu-it, quello predefinito si chiama default | #LOCALIZATIONS TIME_ZONE = 'Europe/Rome' #OTHER SETTINGS USE_I18N = True LANGUAGE_CODE = 'it' DJANGO_VERSION = 1.1 OSQA_DEFAULT_SKIN = 'light' DISABLED_MODULES = ['books', 'recaptcha', 'project_badges', 'mysqlfulltext'] |
Linea 161: | Linea 205: |
psql -U postgres osqa -W < forum_keyvalue.sql | psql -U osqa osqa -W < 00-forum_keyvalue.sql |
Linea 194: | Linea 238: |
== Preparazione del codice == Prima di caricare le modifiche è bene, oltre a testare i cambiamenti, pulire il codice.<<BR>> Infatti non bisogna lasciare alcuna traccia di test o codici inutili. È bene infatti scaricare l'ultima revisione del nostro [[https://code.launchpad.net/ubuntu-it-ask|repository]] e riapplicaci le modifiche, in modo da lasciare meno tracce possibili. |
|
Linea 196: | Linea 247: |
Per prima cosa assicurati di avere scaricato l'ultima revisione del nostro [[https://code.launchpad.net/ubuntu-it-ask|repository]]. Poi caricale: {{{ bzr commit -m 'Descrivi le modifiche' bzr push lp:~tuonome/ubuntu-it-ask/tuo-repository |
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 |
Linea 206: | Linea 261: |
Fai una merge request via launchpad sul branch `lp:~ubuntu-it-ask/ubuntu-it-ask/stable` e scrivi in [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/devel-ask|mailing list]] presentando le tue modifiche. Uno o più amministratori applicheranno 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 poi sul server di Chiedi. |
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 [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/devel-ask|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. |
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.
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).
Copiare osqa.wsgi.dist su osqa.wsgi, quindi modificare osqa.wsgi cambiando i path:
sys.path.append('/var/www') sys.path.append('/var/www/osqa')
Copiare settings_local.py.dist su settings_local.py e modificare settings_local.py affinché rifletta la reale configurazione della propria macchina. A titolo di esempio:
# encoding:utf-8 import os.path SITE_SRC_ROOT = os.path.dirname(__file__) LOG_FILENAME = 'django.osqa.log' #for logging import logging logging.basicConfig( filename=os.path.join(SITE_SRC_ROOT, 'log', LOG_FILENAME), level=logging.ERROR, format='%(pathname)s TIME: %(asctime)s MSG: %(filename)s:%(funcName)s:%(lineno)d %(message)s', ) #ADMINS and MANAGERS ADMINS = () MANAGERS = ADMINS DEBUG = False DEBUG_TOOLBAR_CONFIG = { 'INTERCEPT_REDIRECTS': True } TEMPLATE_DEBUG = DEBUG INTERNAL_IPS = ('127.0.0.1',) DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql_psycopg2', 'NAME': 'osqa', 'USER': 'osqa', 'PASSWORD': 'password', 'HOST': 'localhost', 'PORT': '', } } CACHE_BACKEND = 'file://%s' % os.path.join(os.path.dirname(__file__),'cache').replace('\\','/') #CACHE_BACKEND = 'dummy://' SESSION_ENGINE = 'django.contrib.sessions.backends.db' # This should be equal to your domain name, plus the web application context. # This shouldn't be followed by a trailing slash. # I.e., http://www.yoursite.com or http://www.hostedsite.com/yourhostapp APP_URL = 'http://localhost' #LOCALIZATIONS TIME_ZONE = 'Europe/Rome' #OTHER SETTINGS USE_I18N = True LANGUAGE_CODE = 'it' DJANGO_VERSION = 1.1 OSQA_DEFAULT_SKIN = 'light' 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 osqa 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?
Non conosci Django? Documentazione di Django
- Non conosci OSQA?