Home Explore Help
Sign In
221V
/
Misago
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: f76c1e3304
Branches Tags
Misago
/
README.rst

README.rst 3.3 KB
History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788 
  1. ======
    2. 

  2. Misago
    3. 

  3. ======
    4. 

  4. 

  5. .. image:: https://travis-ci.org/rafalp/Misago.png?branch=future
    6. 

  6.   :target: https://travis-ci.org/rafalp/Misago
    7. 

  7. 

  8. .. image:: https://coveralls.io/repos/rafalp/Misago/badge.png?branch=future
    9. 

  9.   :target: https://coveralls.io/r/rafalp/Misago?branch=future
    10. 

  10. 

  11. .. image:: https://landscape.io/github/rafalp/Misago/future/landscape.png
    12. 

  12.   :target: https://landscape.io/github/rafalp/Misago/future
    13. 

  13. 

  14. 

  15. **Development Status: Pre-Alpha**
    16. 

  16. 

  17. 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.
    18. 

  18. 

  19. 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.
    20. 

  20. 

  21. * **Homepage:** http://misago-project.org/
    22. 

  22. * **Documentation:** http://misago.readthedocs.org/en/latest/
    23. 

  23. * **Code & BugTracker:** https://github.com/rafalp/Misago/
    24. 

  24. 

  25. 

  26. Installing and updating
    27. 

  27. -----------------------
    28. 

  28. 

  29. Please note that branch *future* is used for project's codebase cleanup and is not functional at the time of writing. If you want to give Misago a spin, feel free to play with one of `previous releases <https://github.com/rafalp/Misago/releases>`_.
    30. 

  30. 

  31. To start Misago site, first setup and activate virtual environment for it and then fire following commands::
    32. 

  32. 

  33.     python setup.py install
    34. 

  34.     misago-start.py testforum
    35. 

  35. 

  36. This will install Misago in your virtual environment and will make pre-configured Misago site for you named "testforum".
    37. 

  37. 

  38. Now cd to this testforum and initialize database by using migrate commands provided by manage.py admin utility::
    39. 

  39. 

  40.     cd testforum
    41. 

  41.     python manage.py migrate
    42. 

  42. 

  43. Next, call createsuperuser command to create super admin in database::
    44. 

  44. 

  45.     python manage.py createsuperuser
    46. 

  46. 

  47. Finally start development server using runserver command::
    48. 

  48. 

  49.     python manage.py runserver
    50. 

  50. 

  51. 

  52. If nothing is wrong with your setup, developer server will start enabling you to visit 127.0.0.1:8000 in your browser and see incomplete page from Misago.
    53. 

  53. 

  54. 

  55. Bug reports, features and feedback
    56. 

  56. ----------------------------------
    57. 

  57. 

  58. If you have found bug, please report it on `issue tracker <https://github.com/rafalp/Misago/issues>`_.
    59. 

  59. 

  60. 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!
    61. 

  61. 

  62. 

  63. Contributing
    64. 

  64. ------------
    65. 

  65. 

  66. If you have fixed spelling mistake, wrote new tests or fixed a bug, feel free to open pull request.
    67. 

  67. 

  68. Many issues are open for takers. 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.
    69. 

  69. 

  70. 

  71. Authors
    72. 

  72. -------
    73. 

  73. 

  74. **Rafał Pitoń**
    75. 

  75. 

  76. * http://rpiton.com
    77. 

  77. * http://github.com/rafalp
    78. 

  78. * https://twitter.com/RafalPiton
    79. 

  79. 

  80. 

  81. Copyright and license
    82. 

  82. ---------------------
    83. 

  83. 

  84. **Misago** - Copyright © 2014 `Rafał Pitoń <http://github.com/ralfp>`_
    85. 

  85. This program comes with ABSOLUTELY NO WARRANTY.
    86. 

  86. 

  87. This is free software and you are welcome to modify and redistribute it under the conditions described in the license.
    88. 

  88. For the complete license, refer to LICENSE.rst
    89.