refonte pour le SDK
[auf_skeleton_django.git] / README
1 Création d'un nouveau projet
2 ============================
3
4 Après avoir fait l'installation de Django::
5
6   sudo apt-get install python-django
7
8 Vous pouvez créer un projet depuis le template Django de l'AUF::
9
10 FIXME
11
12   django-admin.py startproject --template=auf-skeleton-django <nom_de_nom_projet>
13
14 Ensuite, pour suivre les versions de votre site, vous pouvez utiliser Git
15 et faire votre commit initiale comme ceci::
16
17   git init
18   git add .
19   git commit -m "version initiale"
20
21 Documentation
22 -------------
23
24 Vous devez d'abord installer sphinx-doc::
25
26   sudo apt-get install python-sphinx
27
28 Pour construire la documentation en version HTML::
29
30   cd docs/
31   make html
32
33 Puis pour voir le résutat finale avec Firefox::
34
35   firefox build/index.html
36
37
38 Git
39 ---
40
41 Une branche par site (production, test, etc)
42 Un tags par version majeur ou déploiement (v1.0, jan.2015, etc)
43
44
45 Déploiement en production
46 -------------------------
47
48 Installation du SDK::
49
50   sudo apt-get install auf-django-sdk
51
52
53 Téléchargement du code source::
54
55   git clone ...
56
57 Par la suite, les nouvelles versions seront téléchargeable avec la commande::
58
59   git pull
60
61 Configuration
62 -------------
63
64 MySQL
65 SECRET_KEY
66 PIWIK
67 Sentry
68
69 Fichier static
70
71 ::
72   chgrp www-data sitestatic media -R
73   chmod g+rw sitestatic media -R
74
75 Apache
76 ------
77
78 Installation du mod-wsgi::
79
80   sudo apt-get install libapache2-mod-wsgi
81   sudo a2enmod wsgi
82
83 Exemple de la configuration d'un site Django::
84
85   <VirtualHost *:80>
86     ServerAdmin webmaster@localhost
87     ServerName mon_site.com
88
89     Alias /media/ /var/www/mon_site/media/
90     Alias /static/ /var/www/mon_site/sitestatic/
91
92     WSGIScriptAlias / /var/www/mon_site/wsgi.py
93
94     ErrorLog /var/log/apache2/mon_site.log
95   </VirtualHost>
96
97
98
99
100 Développement
101 -------------
102
103 Les dépendances qui ne sont pas dans le SDK doivent être mise dans le
104 dossier::
105
106   external_apps/
107
108
109 Tox
110
111 Virtualenv
112 ----------
113
114
115 Buildout
116 --------
117
118