README 2.94 KB
Newer Older
1

chris's avatar
chris committed
2
 Nuages - Easy poll sharing
chris's avatar
chris committed
3
 ==========================
4

chris's avatar
chris committed
5
 Nuages aims to provide a collaborative meeting poll system, similar to doodle or rdvz. It is build in python, using the django framework and a little of javascript. This application was named after Django's famous song. Feedback and collaboration are welcome at nuage@ domainepublic.net
6

chris's avatar
chris committed
7
8
9
10
 The project uses the following django modules:
    - django-urlauth: http://bitbucket.org/lorien/django-urlauth/
    - django-account: http://bitbucket.org/lorien/django-account/

chris's avatar
chris committed
11
12
13
 The project uses the following javascripts:
    - jquery, jquery-ui: http://www.jquery.com/
    - jquery-dynamic-formset: http://code.google.com/p/django-dynamic-formset/
14

15
16
 Translation
 ===========
17

18
Create/update a translation file:
19

20
    # django-admin makemessages -l fr
21

22
Edit and translate the translation file:
23

24
    # gedit locale/fr/LC_MESSAGES/django.po
25

26
Compile translated messages:
27

28
    # django-admin compilemessages
29

30
31
 Fast installation
 =================
32

33
Install python-django package (<1.2)
chris's avatar
chris committed
34
Extract the nuages archive somewhere in your home folder
35
Edit project setings (optional)
36

37
    # vi settings.py
38

chris's avatar
chris committed
39
Build nuages database
40

41
    # ./manage.py syncdb
42

43
Start the python webserver
44

45
    # ./manage.py runserver
46

47
You should have the application running at 127.0.0.1:8000
48

49
50
 Apache installation
 ===================
51

52
53
54
55
Install python-django package (<1.2)
Extract the archive somewhere in your home folder
Move the "static" folder on tha apache side.
Edit project setings, set DEBUG option to False, and change MEDIA_ROOT
56

57
    # vi settings.py
58

chris's avatar
chris committed
59
Build nuages database
60

61
62
    # ./manage.py sql sondage
    # ./manage.py syncdb
63

64
65
There are several ways to configure Apache and python,
 we try wsgi, simply install libapache2-mod-wsgi, and add the following to /etc/apache2/sites-available/nuage
66

67
68
69
    <VirtualHost 62.58.108.143:80>
      
      ServerName nuage.domainepublic.net
70

71
72
      Alias /static/ /var/www/nuage/static/
      Alias /media/ /var/www/nuage/media/
73

74
      WSGIScriptAlias / /home/chris/django/nuage/apache/django.wsgi
75

76
    </VirtualHost>
77

78
Move the static files and link the media files
79

80
81
    mv static /var/www/nuage/
    ln -s /usr/share/python-support/python-django/django/contrib/admin/media/ /var/www/nuage/
82

83
Fix permission for apache user
84

85
86
    sudo chown www-data nuage/nuage.sqlite
    sudo chown www-data nuage
87

88
89
 Installing lenny django package on squeeze 
 ==========================================
90

91
Remove any installed python-django package (1.2)
chris's avatar
chris committed
92
Install backport lenny python-django (1.1)
93
94
Add the following to /etc/apt/preferences
    Package: python-django
chris's avatar
chris committed
95
    Pin: version 1.1*
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
    Pin-Priority: 1001

 Build log
 =========

django-admin startproject nuage

cd nuage; BAZ=$(pwd)
gedit settings.py urls.py

./manage.py startapp sondage
cd sondage; gedit models.py forms.py views.py

cd $BAZ; ./manage.py startapp userbase
cd userbase; gedit views.py 

cd $BAZ; mkdir templates static

# rm nuage.sqlite ; ./manage.py sql sondage ; ./manage.py syncdb
115
116