|
|
@@ -1,77 +0,0 @@
|
|
|
-# Simple forum
|
|
|
-
|
|
|
-This is a simple forum built-in Flask framework in Python. The main code is less than 100 lines to be as lightweight as possible.
|
|
|
-For the moment the forum is very basic.
|
|
|
-
|
|
|
-## Features
|
|
|
-
|
|
|
-* Manage accounts
|
|
|
-* Order the topics by most active, new and categories
|
|
|
-* Like the topics and answers
|
|
|
-* Integrate HTML formating (need to change this for security purposes)
|
|
|
-* Bumb the posts by reply (the posts are ordered by the last actives)
|
|
|
-
|
|
|
-In the future I want to integrate the following ones as well
|
|
|
-
|
|
|
-* Trust system and badges
|
|
|
-* Notifications
|
|
|
-* Private msgs
|
|
|
-* Change the password and manage the account
|
|
|
-* Manage categories and limit them
|
|
|
-* Create a search bar to search through, topics and replies
|
|
|
-
|
|
|
-## Why I made it
|
|
|
-
|
|
|
-I made this forum because I want to make a serie of basic lightweight web apps that can be
|
|
|
-used to make other projects as well. I challenged myself to make apps with the following lines limits:
|
|
|
-
|
|
|
-* 100 lines for the main *logic* code (app.py)
|
|
|
-* 100 lines for the *non-logic* code (helper.py)
|
|
|
-* Not really a limit, but trying to keep it small anyway for the templates. But **not** using external imports. Raw CSS only.
|
|
|
-* Other modules are allowed, **only** if they can be used for a various projects (login.py)
|
|
|
-
|
|
|
-So these are the advantages:
|
|
|
-
|
|
|
-* You got a full control over the code because it's simple and basic. You can make it more complex if you want to, but it remmains under your control
|
|
|
-* You can use it for education purposes by understanding the code
|
|
|
-* You can kickstart your project by integrating this one as a base
|
|
|
-* Less lines, less bugs, less troubleshooting :p
|
|
|
-* The code is durable, there are less chances that the code becomes obsolete
|
|
|
-* Peer to peer friendly, you can adapt the code to make a peer to peer app
|
|
|
-* Low-end servers and clients friendly.
|
|
|
-* Fast websites. Because the code is limited and no more unneccessary CSS and JS is included the website is much faster
|
|
|
-
|
|
|
-In bonus you can also uses the 'login.py' script to speed up the devloppement of the account management in your own Flask apps.
|
|
|
-
|
|
|
-## How to build the source code
|
|
|
-
|
|
|
-1. Install the depedencies
|
|
|
-
|
|
|
-Debian:
|
|
|
-
|
|
|
-```bash
|
|
|
-sudo apt install python3 python3-pip
|
|
|
-pip3 install -r requirements.txt --user
|
|
|
-```
|
|
|
-
|
|
|
-Fedora:
|
|
|
-
|
|
|
-```bash
|
|
|
-sudo dnf install python3 python3-pip
|
|
|
-pip3 install -r requirements.txt --user
|
|
|
-```
|
|
|
-
|
|
|
-2. (Optional) Change the template to fit your needs
|
|
|
-3. Run the main file:
|
|
|
-
|
|
|
-```bash
|
|
|
-python3 app.py
|
|
|
-```
|
|
|
-
|
|
|
-*Note: to change the style of the website I highly recommend you to use the 'Style inspector' built-in in Firefox.*
|
|
|
-
|
|
|
-## How to use the login.py
|
|
|
-
|
|
|
-### Install the requirements
|
|
|
-
|
|
|
-You can find the login.py's documentation [here](./login.md).
|
chopin42