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