== What is DjangoBB? ==

DjangoBB is a quick and simple forum which uses the Django Framework (written in Python language). 
Abbreviation DjangoBB stands for '''Django''' '''B'''ulletin '''B'''oard.
DjangoBB is distributed under the BSD license.

{{{
#!html
<table style="border: none">
<tr>
<td>
<iframe src="http://ghbtns.com/github-btn.html?user=slav0nic&repo=DjangoBB&type=watch&count=true"
  allowtransparency="true" frameborder="0" scrolling="0"  width="82" height="20"></iframe>
</td>
<td>
<script type="text/javascript">
/* <![CDATA[ */
    (function() {
        var s = document.createElement('script'), t = document.getElementsByTagName('script')[0];
        
        s.type = 'text/javascript';
        s.async = true;
        s.src = 'https://api.flattr.com/js/0.6/load.js?mode=auto';
        
        t.parentNode.insertBefore(s, t);
    })();
/* ]]> */
</script>
  <a class="FlattrButton" style="display:none;" href="http://djangobb.org"></a>
</td>
<td>
 <script type="text/javascript" src="https://www.ohloh.net/p/342795/widgets/project_users.js"></script>
</td>
<td>
<a href='https://pledgie.com/campaigns/16554'><img alt='Click here to lend your support to: DjangoBB and make a donation at www.pledgie.com !' src='https://pledgie.com/campaigns/16554.png?skin_name=chrome' border='0' /></a>
</td>
</tr>
</table>
}}}

== The basic concept of the forum progress is: ==

 * the usage of various DBMS (MySQL, PostgreSQL, Oracle, SQLite)
 * the ease of integration into any Django project and the ease of installation
 * the usage of standard libraries for launching on conventional hostings with python support
 * user-friendly installation process 
 * classic view of the forum like IPB, PhpBB, Punbb
 * easy forum setup
 * high speed
 * reliability

At the current stage of development the main object is the functional implementation of the PunBB forum, in the sequel it is projected to expand it significantly.

== Documentation ==

''will be soon...''

'''Installation Tutorial'''

[wiki:QuickInstall]

[http://support.djangobb.org/topic/91/ DjangoBB Installation] ''unofficial''

== How to get DjangoBB sources? ==

DjangoBB sources are available from mercurial repository. You can fetch them with the command:


{{{
hg clone https://bitbucket.org/slav0nic/djangobb#stable djangobb
}}}


Also last revisions are available in [https://bitbucket.org/slav0nic/djangobb/get/stable.tar.gz gz] archive. 

== Dependencies ==
 * python 2.6+/'''3.3'''+
 * Django >= '''1.5'''
 * PIL
 * postmarkup ([http://code.google.com/p/postmarkup url]) '''svn version more secure'''
 * pygments ([http://pygments.org url]) optional
 * django-haystacksearch 1.1.0 ([http://haystacksearch.org/ url]) | Whoosh optional
 * python-markdown ([http://www.freewisdom.org/projects/python-markdown/ url]) optional
 * django-mailer ([http://github.com/jtauber/django-mailer url]) optional
 * django-messages ([http://code.google.com/p/django-messages/ url]) optional (PM_SUPPORT setting)
 * South (optional)
Fore more info pls check ''djangobb/extras/requirements.txt'' and ''optional-requirements.txt'' files

== User Support and demo ==
'''Jabber room:''' `djangobb@conference.jabber.org`

'''English Version:'''
[http://support.djangobb.org/ http://support.djangobb.org/]


'''Mercurial repository:'''
[https://bitbucket.org/slav0nic/djangobb/ https://bitbucket.org/slav0nic/djangobb/]

== Migration from other forum engines: ==

''will be soon...''

[http://github.com/Kami/punBB-to-DjangoBB punBB-to-DjangoBB] ''unofficial/inactive''

[https://github.com/jedie/django-phpBB3 phpBB3 to DjangoBB] ''unofficial''

== "Why another forum?" ==

As far`as we are concerned, there is no usable engine written in Django. In our humble opinion, existing implementations are too simple and have little function.

== Sites using DjangoBB ==
[wiki:DjangoBBPowered]

== Development ==

[wiki:"DatabaseStructure"]

[wiki:"MigrateToDjango13Plan"]

[wiki:"MigrateToDjango14Plan"]

[wiki:"MigrateToDjango15Plan"]

[wiki:"MigrateToDjango16Plan"]

Github mirror: http://github.com/slav0nic/DjangoBB/

Translation: 
http://www.transifex.net/projects/p/djangobb/

[[Image(https://www.transifex.net/projects/p/djangobb/resource/default/chart/image_png)]]

[wiki:HowtoAddNewTranslation Howto add new translation?]

{{{
#!html
<a href="http://wingware.com/"><img src="https://wingware.com/images/coded-with-logo-129x66.png" /></a>
}}}