A simple Django based wiki system.
Project description
Compatibility Matrix:
Py/Dj |
3.8 |
3.9 |
3.10 |
3.11 |
---|---|---|---|---|
3.2 (LTS) |
✓ |
✓ |
✓ |
✓ |
4.0 |
✓ |
✓ |
✓ |
✓ |
4.1 |
✓ |
✓ |
✓ |
✓ |
4.2 (LTS) |
✓ |
✓ |
✓ |
✓ |
django-wakawaka
django-wakawaka is a super simple wiki system written in Python using the Django framework.
Links between Wiki pages are automatically resolved by their CamelCase naming scheme.
It automatically keeps track of revision changes of a Page, while providing the ability to revert to earlier states.
It also has a quite comprehensive permission integration, taking care of Django’s default create/edit/delete permissions.
Wakawaka is an application and indented to be placed in an existing project.
Some screenshots from the Example Project:
Installation:
Put wakawaka to your INSTALLED_APPS in your settings.py within your django project.
Add (r'^wiki/', include('wakawaka.urls')), to your urls.py.
That’s all. Wakawaka has no other dependencies than Django 1.11 or later.
Configuration:
Wakawaka takes care of Django’s permission system. Grant your users always a pair of wikipage and revision permissions either what they should do. (Adding, changing or deleting WikiPages)
Optional Settings:
The name of your first wiki page is defined as WikiIndex. You can change this by adding a setting WAKAWAKA_DEFAULT_INDEX to your settings.py. Example:
WAKAWAKA_DEFAULT_INDEX = 'Home'
Words that are written in CamelCase (a pair of one upper letter followed by n lower letters) are automatically treated as internal wiki links. You can change this behaviour by adding a setting WAKAWAKA_SLUG_REGEX to your settings.py. This holds a regular expression of the wiki name format. Default:
WAKAWAKA_SLUG_REGEX = r'((([A-Z]+[a-z]+){2,})(/([A-Z]+[a-z]+){2,})*)'
Attachments:
Wakawaka does not provide the ability to store file attachments to wiki pages. To do so, have a look on the side project django-attachments which provides a unobstrusive way to add attachments to models.
Testing and Development:
The project comes with a test library which can be simply invoked by Tox, which tests the project under all current Python and Django versions:
$ pip install tox $ tox
To run the testsuite manually in your development environment, install the project using pipenv:
$ pipenv install $ pipenv run tests
Example Project:
The application comes with a sample project. This gives you a brief overview about the Wiki features, and can help you with the integration of the application into an existing project. It’s alo used for the test suite:
$ pipenv install $ pipenv run ./manage.py migrate $ pipenv run ./manage.py createsuperuser $ pipenv run ./manage.py runserver
Changelog:
v1.3 (2022-04-30):
Added support for Django 3.2 to 4.2.
Added support for Python 3.8 to 3.11.
v1.2 (2020-01-08):
Dropped support for Python 2.7.
Added support for Python 3.8.
Added support for Django 2.2 and 3.0.
v1.1 (2019-01-21):
Django 2.1 compatibility and and further cleanup.
Dropped support for Django <v1.11.
Dropped “authenticated” url patterns which were not functional since a while.
v1.0 (2016-11-26):
Django 1.10 compatibility and total cleanup.
Full Python 3 compatibility.
Removed Pinax Group support.
Tests.
v0.3: (2009-08-06):
If a wikipage was not found, the view now raises a proper Http404 instead of a (silent) HttpResponseNotFound. This gives you the ability to display a proper 404 page.
All templates are now translatable using gettext.
v0.2 (2009-07-22):
Edit-forms are now replaceable
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file django-wakawaka-1.3.tar.gz
.
File metadata
- Download URL: django-wakawaka-1.3.tar.gz
- Upload date:
- Size: 313.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | fc86395f1c54fea12227dd92ee879be6a0ca870145752793123e34e0d731198d |
|
MD5 | 244d8f6d74c1ffbdda0754ba4281e2ed |
|
BLAKE2b-256 | d90466ea83e264c76203a3812c52c58c18c476b2b0f2b041f55bf9fceabbd9c1 |
File details
Details for the file django_wakawaka-1.3-py2.py3-none-any.whl
.
File metadata
- Download URL: django_wakawaka-1.3-py2.py3-none-any.whl
- Upload date:
- Size: 33.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d8dc549d5d606b9399873ab469c64ff21efab84b0d9ecae1c25480b72a0dcfaa |
|
MD5 | 4eec4095fa2ecb33994a818be156f3c6 |
|
BLAKE2b-256 | 2c1372ed38c0e32477015e8d71e3b49ccb571a1b5e432aade1f926c5469e3d98 |