You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: dev/CONTRIBUTE.md
+14-75Lines changed: 14 additions & 75 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,18 +3,29 @@
3
3
## Translations
4
4
5
5
You can help with translations.
6
+
The best way to do so is via our weblate hosted by Framasoft: https://weblate.framasoft.org/projects/pytition/pytitions/
6
7
Contact me by opening an issue or by sending a private e-mail if you want to contribute by translating the project
7
-
in a language you know. I can explain how to do it.
8
+
in a language you know and have any issue with weblate (for instance your language is not available). I can help.
8
9
9
10
## Open a Pull Request
10
11
11
12
Please don't hesitate to open a Pull Request if you have a fix for one of the [issues](https://github.com/pytition/pytition/issues).
13
+
12
14
## Report bugs or give new enhancements/feature ideas
15
+
13
16
Don't hesitate to open new [issues](https://github.com/pytition/pytition/issues) with your reports or remarks.
14
17
15
18
## Install a development environment
16
19
17
-
### With a script
20
+
### Manual install (recommended for production)
21
+
22
+
See https://pytition.readthedocs.io/en/latest/installation.html#manual-installation-recommended-for-production
23
+
24
+
### With docker-compose
25
+
26
+
See https://pytition.readthedocs.io/en/latest/installation.html#installation-via-docker-recommended-for-development
27
+
28
+
### With a script (not recommended)
18
29
19
30
You can use [this script](https://github.com/pytition/Pytition/blob/master/dev/dev_setup.sh) to setup a development environment.
20
31
If you trust it, run, in the directory where you want to clone the project:
sudo mysql -h localhost -u root -Bse "CREATE USER pytition@localhost IDENTIFIED BY '${password}'; CREATE DATABASE pytition; GRANT USAGE ON *.* TO 'pytition'@localhost IDENTIFIED BY '${password}'; GRANT ALL privileges ON pytition.* TO pytition@localhost; FLUSH PRIVILEGES;"
66
-
```
67
-
Then write the following in a new file called `my.cnf`:
68
-
```
69
-
[client]
70
-
database = pytition
71
-
user = pytition
72
-
password = YOUR_PASSWORD_HERE
73
-
default-character-set = utf8
74
-
```
75
-
Tell Pytition where to find this file with:
76
-
```bash
77
-
sed -i -e "s@/home/petition/www/@$PWD/@" pytition/pytition/settings/base.py
78
-
```
79
-
Then run migrations (scripts to initialize the database):
80
-
```bash
81
-
cd pytition && python3 ./manage.py migrate &&cd -
82
-
```
83
-
You can create an administrator account, and populate the database with fake data:
84
-
```bash
85
-
cd pytition && python3 ./manage.py createsuperuser &&cd -
86
-
./dev/prepropulate.sh
87
-
```
88
-
And… you are done! You can start the server with:
89
-
```bash
90
-
python3 ./pytition/manage.py runserver
91
-
```
92
-
You can access it at [http://localhost:8080](http://localhost:8080)!
93
-
### With docker-compose
94
-
This creates two containers, one for the database using postgresql, another for the django project.
0 commit comments