Package: openedx-django-wiki
django-wikiLast update: 2012-08-22Demo here, sign up for an account to see the notification system.wiki.overtag.dkNB!!THIS IS A WORK IN PROGR...Currently, the whole API is subject to change. That means, if you use the wiki, you should use itas it isand not access internals or override templates or write plugins...yet!But the games will soon begin, and Django South migrations are available.Please refer to theTODOfor a detailed status or the Issue list.ManifestoThis is where it all begins. Inless than 1 weekwe should have a wiki system appealing to any kind of Django developer out there. Here is the manifest (so far):Be pluggable and light-weight.Don't integrate optional features in the core.Be open.Make an extension API that allows the ecology of the wiki to grow. After all, Wikipedia consists of some680 extensionswritten for MediaWiki.Be smart.This isthe map of tables in MediaWiki - we'll understand the choices of other wiki projects and make our own. After-all, this is a Django project.Be simple.The source code shouldalmostexplain itself.Be structured.Markdown is a simple syntax for readability. Features should be implemented either through easy coding patterns in the content field, but rather stored in a structured way (in the database) and managed through a friendly interface. This gives control back to the website developer, and makes knowledge more usable. Just ask: Why has Wikipedia never changed? Answer: Because it's knowledge is stored in a complicated way, thus it becomes very static.InstallationInstallInstall directly from Github, since there is no release yet:pip install git+git://github.com/benjaoming/django-wiki.gitConfiguresettings.INSTALLED_APPSMake sure that the following is present:'wiki',
'wiki.plugins.attachments',
'wiki.plugins.notifications',
'wiki.plugins.images',
'south',
'django_notify',
'mptt',
'sekizai',
'django.contrib.humanize',DatabaseTo sync and create tables, do:python manage.py syncdb
python manage.py migrateConfiguresettings.TEMPLATE_CONTEXT_PROCESSORSAdd'sekizai.context_processors.sekizai'tosettings.TEMPLATE_CONTEXT_PROCESSORS.Include urlpatternsTo integrate the wiki to your existing application, you shoud add the following lines at the end of your project'surls.py.from wiki.urls import get_pattern as get_wiki_pattern
from django_notify.urls import get_pattern as get_notify_pattern
urlpatterns += patterns('',
    (r'^notify/', get_notify_pattern()),
    (r'', get_wiki_pattern())
)Please use these function calls rather than writing your own include() call - the url namespaces aren't supposed to be customized.The above line puts the wiki in/so it's important to put it at the end of your urlconf. You can also put it in/wikiby putting'^wiki/'as the pattern.SettingsFor now, look inwiki/conf/settings.pyto see a list of available settings.Other tipsAccount handling:There are simple views that handle login, logout and signup. They are on by default. Make sure to set settings.LOGIN_URL to point to your login page as many wiki views may redirect to a login page.PluginsAdd/remove the following to yoursettings.INSTALLED_APPSto enable/disable the core plugins:'wiki.plugins.attachments''wiki.plugins.images''wiki.plugins.notifications'The notifications plugin is mandatory for an out-of-the-box installation. You can safely remove it from INSTALLED_APPS if you also override thewiki/base.htmltemplate.BackgroundDjango-wiki is a rewrite ofdjango-simplewiki, a project from 2009 that aimed to be a base system for a wiki. It proposed that the user should customize the wiki by overwriting templates, but soon learned that the only customization that really took place was that people forked the entire project. We don't want that for django-wiki, we want it to be modular and extendable.As of now, Django has existed for too long without a proper wiki application. The dream of django-wiki is to become a contestant alongside Mediawiki, so that Django developers can stick to the Django platform even when facing tough challenges such as implementing a wiki.ContributingThis project will be very open for enrolling anyone with a good idea. As of now, however, it's a bit closed while we get the foundation laid out.Q&AWhy is the module named just "wiki"?Because "pip install wiki" returns "No distributions at all found for wiki"! :)What markup language will you use?The markup engine will be pluggable, but Markdown will be the built-in supported one.Why not use django-reversion?It's a great project, but if the wiki has to grow ambitious, someone will have to optimize its behavior, and using a third-party application for something as crucial as the revision system is a no-go in this regard.DependenciesSo far the dependencies are:django=>1.4django-southMarkdown>=2.2.0django-mptt>=0.5django-sekizaisorl-thumbnailDevelopmentIn a your Git fork, runpip install -r requirements.txtto install the requirements.The foldertestproject/contains a pre-configured django project and an sqlite database. Login for django admin isadmin:admin. This project should always be maintained, although the sqlite database will be deleted very soon to avoid unnecessary conflicts.AcknowledgementsThe people atedX& MIT for finding and supporting the project both financially and with ideas.django-cmsfor venturing where no django app has gone before in terms of well-planned features and high standards. It's a very big inspiration.django-mptt, a wonderful utility for inexpensively using tree structures in Django with a relational database backend.