Spirit

Spirit is a Python based forum built using the Django framework.

To see it in action, please visit The Spirit Project.

Requirements

Spirit requires the following software to be installed:

Python 2.7, 3.3 or 3.4 (recommended)
Django 1.8
PostgreSQL or MySQL or Oracle Database

Dependencies

Check out the requirements provided.

Installing (Advanced)

Check out the example provided.

In short:

Add url(r'^', include('spirit.urls')), to your urls.py

Add from spirit.settings import * to the top of your settings.py file, otherwise you will have to setup all django's related constants (Installed_apps, Middlewares, Login_url, etc)

Run:

pip install -r requirements.txt
python manage.py migrate
python manage.py createcachetable spirit_cache
python manage.py collectstatic

Note:

You will need to setup a search engine, Spirit is configured to work with Woosh by default.

An email server is required, you can host your own (ie: exim), or hire an external service provider (ie: Mandrill).

Start a development server:

python manage.py runserver

Visit (http://127.0.0.1:8000/)

Note: On production, you would rather run Spirit on a real web server. ie: gunicorn + Nginx. Running Spirit on a virtualenv is adviced.

Updating

Note: If you are upgrading from any release previous to v0.3, you should add AUTH_USER_MODEL = 'spirit.User'. If you have your own custom AUTH_USER_MODEL you can leave it as is (don't change it), you should remove AbstractForumUser from your inherited classes, if you are extending spirit.models.AbstractUser change it to django.contrib.auth.models.AbstractUser.

Run:

pip install -r requirements.txt
python manage.py makemigrations
python manage.py migrate
python manage.py collectstatic
python manage.py rebuild_index --noinput

Contributing

Feel free to check out the source code and submit pull requests.

You may also report any bug or propose new features in the issues tracker

Testing

The runtests.py script enable you to run the test suite of spirit.

Type ./runtests.py to run the test suite using the settings from the tests folder.
Type ./runtests.py example to run the test suite using the settings from the example folder.

Copyright / License

Licensed under the MIT License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

3.3 KiB Raw Blame History