Show More
@@ -1,67 +1,74 | |||
|
1 | 1 | # INTRO # |
|
2 | 2 | |
|
3 | 3 | This project aims to create centralized forum-like discussion platform with |
|
4 | 4 | anonymity in mind. |
|
5 | 5 | |
|
6 | 6 | Main repository: https://bitbucket.org/neko259/neboard/ |
|
7 | 7 | |
|
8 | 8 | Site: http://neboard.me/ |
|
9 | 9 | |
|
10 | **THIS PROJECT IS DISCONTINUED** | |
|
11 | ||
|
12 | Due to python/django limitations and performance considerations the board was rewritten in Java. See https://bitbucket.org/neko259/newneboard/ | |
|
13 | ||
|
14 | Some features are not implemented yet in the java version and some were deliberately removed. If you need them, feel free to use the old board. | |
|
15 | Themes from the java project can be migrated to this one at the moment this document is being updated. | |
|
16 | ||
|
10 | 17 | # INSTALLATION # |
|
11 | 18 | |
|
12 | 19 | 1. Download application and move inside it: |
|
13 | 20 | |
|
14 | 21 | `hg clone https://bitbucket.org/neko259/neboard` |
|
15 | 22 | |
|
16 | 23 | `cd neboard` |
|
17 | 24 | |
|
18 | 25 | 2. Install all application dependencies: |
|
19 | 26 | |
|
20 | 27 | Some minimal system-wide depenencies: |
|
21 | 28 | |
|
22 | 29 | * python3 |
|
23 | 30 | * pip/pip3 |
|
24 | 31 | * jpeg |
|
25 | 32 | * zlib |
|
26 | 33 | |
|
27 | 34 | Python dependencies: |
|
28 | 35 | |
|
29 | 36 | `pip3 install -r requirements.txt` |
|
30 | 37 | |
|
31 | 38 | You can use virtualenv to speed up the process or avoid conflicts. |
|
32 | 39 | |
|
33 | 40 | 3. Setup a database in `neboard/settings.py`. You can also change other settings like search engine. |
|
34 | 41 | |
|
35 | 42 | Depending on configured database and search engine, you need to install corresponding dependencies manually. |
|
36 | 43 | |
|
37 | 44 | Default database is *sqlite*. If you want to change the database backend, refer to the django documentation for the correct settings. Please note that sqlite accepts only one connection at a time, so you won't be able to run 2 servers or a server and a sync at the same time. |
|
38 | 45 | |
|
39 | 46 | 4. Setup SECRET_KEY to a secret value in `neboard/settings.py |
|
40 | 47 | 5. Run `./manage.py migrate` to apply all migrations |
|
41 | 48 | 6. Apply config changes to `boards/config/settings.ini`. You can see the default settings in `boards/config/default_config.ini`(do not delete or overwrite it). |
|
42 | 49 | 7. If you want to use decetral engine, run `./manage.py generate_keypair` to generate keys |
|
43 | 50 | |
|
44 | 51 | # RUNNING # |
|
45 | 52 | |
|
46 | 53 | You can run the server using django default embedded webserver by running: |
|
47 | 54 | |
|
48 | 55 | ./manage.py runserver <address>:<port> |
|
49 | 56 | |
|
50 | 57 | See django-admin command help for details. |
|
51 | 58 | |
|
52 | 59 | Also consider using wsgi or fcgi interfaces on production servers. |
|
53 | 60 | |
|
54 | 61 | When running for the first time, you need to setup at least one section tag. |
|
55 | 62 | Go to the admin page and manually create one tag with "required" property set. |
|
56 | 63 | |
|
57 | 64 | # UPGRADE # |
|
58 | 65 | |
|
59 | 66 | 1. Backup your project data. |
|
60 | 67 | 2. Copy the project contents over the old project directory |
|
61 | 68 | 3. Run migrations by `./manage.py migrate` |
|
62 | 69 | |
|
63 | 70 | You can also just clone the mercurial project and pull it to update |
|
64 | 71 | |
|
65 | 72 | # CONCLUSION # |
|
66 | 73 | |
|
67 | 74 | Enjoy our software and thank you! |
General Comments 0
You need to be logged in to leave comments.
Login now