README.rst 3.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. ======
  2. Misago
  3. ======
  4. .. image:: https://travis-ci.org/rafalp/Misago.png?branch=future
  5. :target: https://travis-ci.org/rafalp/Misago
  6. .. image:: https://coveralls.io/repos/rafalp/Misago/badge.png?branch=future
  7. :target: https://coveralls.io/r/rafalp/Misago?branch=future
  8. .. image:: https://landscape.io/github/rafalp/Misago/future/landscape.png
  9. :target: https://landscape.io/github/rafalp/Misago/future
  10. **Development Status: Pre-Alpha**
  11. Misago aims to be complete, featured and modern forum solution that has no fear to say 'NO' to common and outdated opinions about how forum software should be made and what it should do.
  12. If you can run Python apps on your hosting and you are looking for modern solution using latest paradigms in web development, or you are Django developer and forum is going to be core component of your next project then Misago is option for you!
  13. * **Homepage:** http://misago-project.org/
  14. * **Documentation:** http://misago.readthedocs.org/en/latest/
  15. * **Code & BugTracker:** https://github.com/rafalp/Misago/
  16. Installing and updating
  17. -----------------------
  18. Please note that branch *future* is used for project's codebase cleanup and is not functional at the time of this writing. If you want to give Misago a spin, feel free to play with one of `previous releases <https://github.com/rafalp/Misago/releases>`_.
  19. To install Misago setup and activate virtual environment and then fire following commands::
  20. python setup.py install
  21. misago-start.py testforum
  22. Those commands will install Misago in your virtual environment and make pre-configured Misago site for you named "testforum" using "misago-start.py" script available successfull installation.
  23. Now cd test forum and initialize database by using syncdb and migrate commands using manage.py::
  24. cd testforum
  25. python manage.py syncdb
  26. python manage.py migrate
  27. Finally start development server using runserver command::
  28. python manage.py runserver
  29. If server starts, you should be able to visit 127.0.0.1:8000 in your browser and see simple placeholder response from Misago, however as work on this branch is underway revisions may frequently introduce changes that will break runserver.
  30. Bug reports, features and feedback
  31. ----------------------------------
  32. If you have found bug, please report it on `issue tracker <https://github.com/rafalp/Misago/issues>`_.
  33. For feature or support requests as well as general feedback please use `official forum <http://misago-project.org>`_ instead. Your feedback means much to the project so please do share your thoughts!
  34. Contributing
  35. ------------
  36. If you have fixed spelling mistake, wrote new tests or fixed a bug, feel free to open pull request.
  37. Many issues are open for takes. If you've found one you feel you could take care of, please announce your intent in issue discussion before you start working. That way situations when more than one person works on solving same issue can be avoided.
  38. Authors
  39. -------
  40. **Rafał Pitoń**
  41. * http://rpiton.com
  42. * http://github.com/rafalp
  43. * https://twitter.com/RafalPiton
  44. Copyright and license
  45. ---------------------
  46. **Misago** - Copyright © 2014 `Rafał Pitoń <http://github.com/ralfp>`_
  47. This program comes with ABSOLUTELY NO WARRANTY.
  48. This is free software and you are welcome to modify and redistribute it under the conditions described in the license.
  49. For the complete license, refer to LICENSE.rst