|
@@ -1,3 +1,5 @@
|
|
|
|
+[](https://travis-ci.org/sh4nks/flaskbb)
|
|
|
|
+
|
|
# INTRODUCTION
|
|
# INTRODUCTION
|
|
|
|
|
|
[FlaskBB](http://flaskbb.org) is a forum software written in python
|
|
[FlaskBB](http://flaskbb.org) is a forum software written in python
|
|
@@ -6,7 +8,7 @@ using the micro framework Flask.
|
|
|
|
|
|
## FEATURES
|
|
## FEATURES
|
|
|
|
|
|
-* A Bulletin Board like FluxBB, DjangoBB in Flask
|
|
|
|
|
|
+* A Bulletin Board like FluxBB or DjangoBB in Flask
|
|
* Private Messages
|
|
* Private Messages
|
|
* Admin Interface
|
|
* Admin Interface
|
|
* Group based permissions
|
|
* Group based permissions
|
|
@@ -20,71 +22,23 @@ using the micro framework Flask.
|
|
* See the github [issues](https://github.com/sh4nks/flaskbb/issues?state=open)
|
|
* See the github [issues](https://github.com/sh4nks/flaskbb/issues?state=open)
|
|
|
|
|
|
|
|
|
|
-## DEPENDENCIES
|
|
|
|
-
|
|
|
|
-* [Flask](http://flask.pocoo.org)
|
|
|
|
- * [Werkzeug](http://werkzeug.pocoo.org)
|
|
|
|
- * [Jinja2](http://jinja.pocoo.org)
|
|
|
|
-* [Flask-SQLAlchemy](http://pythonhosted.org/Flask-SQLAlchemy/)
|
|
|
|
- * [SQLAlchemy](http://www.sqlalchemy.org/)
|
|
|
|
-* [Flask-WTF](http://pythonhosted.org/Flask-WTF/)
|
|
|
|
- * [WTForms](http://wtforms.simplecodes.com/docs/1.0.4/)
|
|
|
|
-* [Flask-Login](http://flask-login.readthedocs.org/en/latest/)
|
|
|
|
-* [Flask-Mail](http://pythonhosted.org/flask-mail/)
|
|
|
|
-* [Flask-Script](http://flask-script.readthedocs.org/en/latest/)
|
|
|
|
-* [Flask-Themes2](http://flask-themes2.rtfd.org/)
|
|
|
|
-* [Flask-Migrate](http://flask-migrate.readthedocs.org/en/latest/)
|
|
|
|
-
|
|
|
|
-
|
|
|
|
-### OPTIONAL DEPENDENCIES
|
|
|
|
-
|
|
|
|
-* [Pygmens](http://pygments.org/) - For code highlighting
|
|
|
|
-* [Redis](http://redis.io/) - For counting the online guests
|
|
|
|
-
|
|
|
|
-
|
|
|
|
## INSTALLATION
|
|
## INSTALLATION
|
|
|
|
|
|
* Create a virtualenv
|
|
* Create a virtualenv
|
|
- * Install virtualenvwrapper with your package manager or via
|
|
|
|
- * `sudo pip install virtualenvwrapper`
|
|
|
|
- * Add these lines to your `.bashrc`
|
|
|
|
-
|
|
|
|
- export WORKON_HOME=$HOME/.virtualenvs # Location for your virtualenvs
|
|
|
|
- source /usr/local/bin/virtualenvwrapper.sh
|
|
|
|
-
|
|
|
|
- * Create a new virtualenv
|
|
|
|
- * `mkvirtualenv -a /path/to/flaskbb -p $(which python2) flaskbb`
|
|
|
|
- * and finally activate it
|
|
|
|
- * `workon flaskbb`
|
|
|
|
- * For more options visit the documentation [here](http://virtualenvwrapper.readthedocs.org/en/latest/index.html).
|
|
|
|
-
|
|
|
|
-
|
|
|
|
* Install the dependencies
|
|
* Install the dependencies
|
|
* `pip install -r requirements.txt`
|
|
* `pip install -r requirements.txt`
|
|
- * **NOTE**: If you are using pip 1.5 you need to add these parameters: ``--allow-external postmarkup --allow-unverified postmarkup``
|
|
|
|
* Configuration (_adjust them accordingly to your needs_)
|
|
* Configuration (_adjust them accordingly to your needs_)
|
|
* For development copy `flaskbb/configs/development.py.example` to `flaskbb/configs/development.py`
|
|
* For development copy `flaskbb/configs/development.py.example` to `flaskbb/configs/development.py`
|
|
- * For production copy `flaskbb/configs/production.py.example` to `flaskbb/configs/production.py`
|
|
|
|
* Database creation
|
|
* Database creation
|
|
- * **Development:** Create the database with some example content
|
|
|
|
- * `python manage.py createall`
|
|
|
|
- * **Production:** Create the database and the admin user
|
|
|
|
- * `python manage.py initflaskbb`
|
|
|
|
|
|
+ * `python manage.py createall`
|
|
* Run the development server
|
|
* Run the development server
|
|
* `python manage.py runserver`
|
|
* `python manage.py runserver`
|
|
* Visit [localhost:8080](http://localhost:8080)
|
|
* Visit [localhost:8080](http://localhost:8080)
|
|
|
|
|
|
|
|
|
|
-## Upgrading
|
|
|
|
|
|
+## DOCUMENTATION
|
|
|
|
|
|
-* Upgrading from a previous installation
|
|
|
|
- * Pull the latest changes from the repository
|
|
|
|
- * `git pull`
|
|
|
|
-* See if the example config has changed and adjust the settings to your needs
|
|
|
|
- * `diff flaskbb/configs/production.py flaskbb/configs/production.py.example`
|
|
|
|
- * `$EDITOR flaskbb/configs/production.py`
|
|
|
|
-* Upgrade the database to the latest revision
|
|
|
|
- * `python manage.py db upgrade head`
|
|
|
|
|
|
+The documentation is located [here](http://flaskbb.readthedocs.org/en/latest/).
|
|
|
|
|
|
|
|
|
|
## LICENSE
|
|
## LICENSE
|
|
@@ -94,4 +48,4 @@ using the micro framework Flask.
|
|
|
|
|
|
## ACKNOWLEDGEMENTS
|
|
## ACKNOWLEDGEMENTS
|
|
|
|
|
|
-[/r/flask](http://reddit.com/r/flask), [Flask](http://flask.pocoo.org) and it's [extensions](http://flask.pocoo.org/extensions/).
|
|
|
|
|
|
+[/r/flask](http://reddit.com/r/flask), [Flask](http://flask.pocoo.org), it's [extensions](http://flask.pocoo.org/extensions/) and everyone who has helped me!
|