Skip to content

Aurora0000/descant

Repository files navigation

Descant

Join the chat at https://gitter.im/Aurora0000/descant Coverage Status Travis CI Stars License

Free, open-source forum software powered by Angular and Django.

Latest Development

Currently, version v0.2.0 is in development, and can be found in the v0.2-devel branch.

Features

  • RESTful API that provides access to all features
  • Posting with Markdown formatting.
  • Tagging as opposed to categories/forums
  • Editing and deleting (for the original poster of the post and staff)
  • Responsive front-end UI
  • Avatars powered by Gravatar
  • Topic locking/unlocking
  • Administration Panel (via Django)

Installing

For either option below, if you don't have git, instead of git clone, download the .tar.gz from below, extract and navigate into that folder with your shell, then continue after the cd descant line.

Debian, Ubuntu or other apt-based distributions

sudo apt-get install python3 python3-pip git
git clone -b v0.1.0 --depth=1 https://github.com/Aurora0000/descant.git
cd descant
sudo pip3 install -r requirements.txt
sudo python3 manage.py migrate
sudo python3 manage.py runserver

Via Docker/Vagrant

git clone -b v0.1.0 --depth=1 https://github.com/Aurora0000/descant.git
cd descant
vagrant up

Note: The Vagrant image does not serve static files. You'll need to configure nginx to serve up static files. This code may be helpful.

Developing with Descant

If you're interested in developing the front-end of Descant, take a look in static/descant/. Otherwise, you'll find the descant/ and forums/ directories interesting.

About

Free, open-source forum software powered by Angular and Django.

Resources

License

Stars

Watchers

Forks

Packages

No packages published