##// END OF EJS Templates
u » bodqhrohro » swineboard
RSS
Merged in xdevelnet/neboard-1/xdevelnet/modify-readmemarkdown-according-to-recen-1462861521600 (pull request #19)...
neko259 -
r1555:54fb2b93 merge default
parent child Browse files
Show More
Show file before | Show file after | Hide comments
@@ -1,70 +1,66 b''
1 # INTRO #
1 # INTRO #
2
2
3 This project aims to create centralized forum-like discussion platform with
3 This project aims to create centralized forum-like discussion platform with
4 anonymity in mind.
4 anonymity in mind.
5
5
6 Main repository: https://bitbucket.org/neko259/neboard/
6 Main repository: https://bitbucket.org/neko259/neboard/
7
7
8 Site: http://neboard.me/
8 Site: http://neboard.me/
9
9
10 # INSTALLATION #
10 # INSTALLATION #
11
11
12 1. Download application and move inside it:
12 1. Download application and move inside it:
13
13
14 `hg clone https://bitbucket.org/neko259/neboard`
14 `hg clone https://bitbucket.org/neko259/neboard`
15
15
16 `cd neboard`
16 `cd neboard`
17
17
18 If you wish to use *decentral* version, change branch to *decentral*:
19
20 `hg up decentral`
21
22 2. Install all application dependencies:
18 2. Install all application dependencies:
23
19
24 Some minimal system-wide depenencies:
20 Some minimal system-wide depenencies:
25
21
26 * python3
22 * python3
27 * pip/pip3
23 * pip/pip3
28 * jpeg
24 * jpeg
29
25
30 Python dependencies:
26 Python dependencies:
31
27
32 `pip3 install -r requirements.txt`
28 `pip3 install -r requirements.txt`
33
29
34 You can use virtualenv to speed up the process or avoid conflicts.
30 You can use virtualenv to speed up the process or avoid conflicts.
35
31
36 3. Setup a database in `neboard/settings.py`. You can also change other settings like search engine.
32 3. Setup a database in `neboard/settings.py`. You can also change other settings like search engine.
37
33
38 Depending on configured database and search engine, you need to install corresponding dependencies manually.
34 Depending on configured database and search engine, you need to install corresponding dependencies manually.
39
35
40 Default database is *sqlite*, default search engine is *whoosh*.
36 Default database is *sqlite*, default search engine is *whoosh*.
41
37
42 4. Setup SECRET_KEY to a secret value in `neboard/settings.py
38 4. Setup SECRET_KEY to a secret value in `neboard/settings.py
43 5. Run `./manage.py migrate` to apply all migrations
39 5. Run `./manage.py migrate` to apply all migrations
44 6. Apply config changes to `boards/config/config.ini`. You can see the default settings in `boards/config/default_config.ini`
40 6. Apply config changes to `boards/config/config.ini`. You can see the default settings in `boards/config/default_config.ini`
45 7. If you want to use decetral engine, run `./manage.py generate_keypair` to generate keys
41 7. If you want to use decetral engine, run `./manage.py generate_keypair` to generate keys
46
42
47 # RUNNING #
43 # RUNNING #
48
44
49 You can run the server using django default embedded webserver by running:
45 You can run the server using django default embedded webserver by running:
50
46
51 ./manage.py runserver <address>:<port>
47 ./manage.py runserver <address>:<port>
52
48
53 See django-admin command help for details.
49 See django-admin command help for details.
54
50
55 Also consider using wsgi or fcgi interfaces on production servers.
51 Also consider using wsgi or fcgi interfaces on production servers.
56
52
57 When running for the first time, you need to setup at least one section tag.
53 When running for the first time, you need to setup at least one section tag.
58 Go to the admin page and manually create one tag with "required" property set.
54 Go to the admin page and manually create one tag with "required" property set.
59
55
60 # UPGRADE #
56 # UPGRADE #
61
57
62 1. Backup your project data.
58 1. Backup your project data.
63 2. Copy the project contents over the old project directory
59 2. Copy the project contents over the old project directory
64 3. Run migrations by `./manage.py migrate`
60 3. Run migrations by `./manage.py migrate`
65
61
66 You can also just clone the mercurial project and pull it to update
62 You can also just clone the mercurial project and pull it to update
67
63
68 # CONCLUSION #
64 # CONCLUSION #
69
65
70 Enjoy our software and thank you! No newline at end of file
66 Enjoy our software and thank you!
General Comments 0
You need to be logged in to leave comments. Login now