Skip to main content

A simple but very flexible django wiki application

Project description

.. _topics-overview:

===========================
Softwarefabrica Django Wiki
===========================

.. admonition:: About this document

This document provides an overview of what Softwarefabrica Django Wiki is.

.. contents::
:depth: 3

What is this?
=============

This is a flexible wiki application for the `Django`_ web framework.

This is meant to be used as a component in developing full-fledged wiki
applications, but it also provides a fully working stand-alone application.

Your help and feedback is precious. Suggestions and contributions are very much
appreciated. See below on how you can contribute.

If you want to actively collaborate and provide code, documentation, tests or
bug fixes, please feel free to create a new Bazaar branch in Launchpad, and tell
us about it! See the collaboration_ section for more information.

.. _`Django`: http://www.djangoproject.com

Feature overview
----------------

Wiki features:

- **simple**
- **fast**
- *standard* markup, based on `Markdown`_
- *attachment support*
- *ergonomic*
- automatically creates backups of all page changes (*full history*)
- **multiple wikis**
- **hierarchycal wikis**
- **hierarchycal pages**
- *unicode support*
- **remote wiki synchronization** support (you can work on your wikis on mobile, disconnected, devices)
- *structured documents* support, with links for *previous*, *next* and *upper* pages
- easy access to *linked* and *linking* pages
- fast **search** functionality
- **download** of pages in *text* and *HTML* formats
- easily embeddable in other `Django`_ applications
- *TWiki* import tool
- fully working *complete* demo application included

Upcoming features:

- *PDF* generation
- *RSS feed* for recent changes
- *page templates*
- download of a **whole** wiki in HTML
- advanced *ACL* support

.. _`Markdown`: http://daringfireball.net/projects/markdown/syntax
.. _`Django`: http://www.djangoproject.com
.. _`forms library`: http://docs.djangoproject.com/en/dev/topics/forms/

Pre-requisites and installation
===============================

See the `installation guide document`_.

.. _`installation guide document`: install.html

.. _collaboration:

How can I contribute?
=====================

As said, your help is precious. We'll warmly appreciate any help you'll want to
give. Just using this library is a reward for us, but if you want to become more
actively involved, you are welcome!

The project has a `development home page`_ at `LaunchPad`_:

https://launchpad.net/sf-django-wiki

There you can file `bugs`_, suggest `enhancements`_, follow development or ask
to become an active `team`_ member.

You can checkout the development branch using `Bazaar`_:

::

bzr branch lp:sf-django-wiki

We'll appreciate very much if you'll want to contribute back any changes. Just
register your branch with `LaunchPad`_ and tell us!

Source code can also be browsed `online`_.

.. _`development home page`: https://launchpad.net/sf-django-wiki
.. _`LaunchPad`: http://launchpad.net
.. _`Bazaar`: http://bazaar-vcs.org/
.. _`online`: http://bazaar.launchpad.net/~softwarefabrica/sf-django-wiki/trunk/changes
.. _`Softwarefabrica`: https://edge.launchpad.net/softwarefabrica
.. _`team`: https://edge.launchpad.net/softwarefabrica
.. _`bugs`: https://bugs.launchpad.net/sf-django-wiki
.. _`enhancements`: https://bugs.launchpad.net/sf-django-wiki


Contacts
========

It's possible to contact the author by e-mail at the following addresses:

m.pantaleoni at softwarefabrica.org

panta at elasticworld.org

marco.pantaleoni at gmail.com


LICENSE
=======

This software is covered by the GNU General Public License version 2.
If you want to use this software in a closed source application, you
need to buy a commercial license from the author.

This open source version is:

Copyright (C) 2007-2008 Marco Pantaleoni. All rights reserved.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2 as
published by the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.


CHANGES
-------

2008-12-19 Marco Pantaleoni <panta@elasticworld.org>

* added doc bundle generation.

* docs/install.txt: improved installation instructions.

2008-12-17 Marco Pantaleoni <panta@elasticworld.org>

* docs/install.txt: fixed typo.
Fixed another typo.

* setup.py: Added missing dependency on BeautifulSoup.

2008-12-16 Marco Pantaleoni <panta@elasticworld.org>

* Makefile (commit): added 'commit' target, which updates
launchpad bzr repo.

* docs/install.txt: added info about jscalendar.

* removed demo.db

* softwarefabrica/django/wiki/wikiparse.py
(WikiParser.markup_parse): Removed bogus reference to obsolete
mdx_sfwiki.

* BIG CHANGE. Complete reorganization of the source, switched to
nested package layout (`softwarefabrica.django.wiki`),
re-organized demo project, added documentation, created setuptools
based distribution. Also fixed some bugs.

2008-11-24 Marco Pantaleoni <panta@elasticworld.org>

* switched to 'softwarefabrica.django.utils'

2008-10-22 Marco Pantaleoni <panta@elasticworld.org>

* testproj/static_media/css/wiki-screen.css: CSS changes.

* templates/wiki/base.html: switched to perfect 3-column layout
(http://matthewjamestaylor.com/blog/perfect-3-column.htm)

2008-10-09 Marco Pantaleoni <panta@elasticworld.org>

* models.py (Wiki.homepage): it's now possible to specify an home
page for a Wiki.

2008-09-26 Marco Pantaleoni <panta@elasticworld.org>

* testproj/importer/twiki-import.py: added support for attachments.

* testproj/importer/twiki-import.py: great code reorganization.

* wikiparse.py (wikiparse): correctly handle unicode and markdown.

* wikiparse.py (parse_wiki_tags): fixed and added detailed wiki
links and attachments.

* urls.py: generalized urls.

* testproj/importer/twiki-import.py: greatly improved, added write
to DB. Now it is almost complete.

* templates/wiki/search_results.html: now pagecontents point to
proper revisions.

* templates/wiki/base.html: changed DOCTYPE switching from xhtml
to html, switched to utf8

* sanitize.py (sanitize_html): generalized.

* models.py: added an HACK to support correct handling of 'linked'
ManyToMany when not using forms.

2008-09-25 Marco Pantaleoni <panta@elasticworld.org>

* fixed default parent separator in models get_parent.
Small layout and css change.

* added linked pages and linked by boxes to the sidebar

* added linked and referenced pages to PageContent model, and
handled properly in save() and wiki filter.

2008-09-24 Marco Pantaleoni <panta@elasticworld.org>

* attachments are now saved in a path referring to the page UUID
instead of the name.

* now it's possible to go to a specific revision from the history
page.

* moved info about page content rev. and dates to history page.

* page history now uses pagelink.

* moved 'add attachment' link to page icons box.
Small css change.

* limited recently modified pages to current wiki, when
applicable.

* added 'txt' and 'HTML' download links for pages.

* simplified left sidebar.

* wiki links css changes.

* fixed 'wiki' templatetag (sanitized text before markdown processing).

* added wikimenu templatetag, which generates a hierarchical menu.

* fixed missing closing HTML tags for page text in search results
and page history (using truncate_html instead of truncate).

* added icons for edit and new page in page detail.

2008-09-22 Marco Pantaleoni <panta@elasticworld.org>

* added 'wikilink' and 'pagelink' templatetags (removing the
'get_hier_href()' functions from models.)

* added initial rough support for sub-wikis and sub-pages
in url handling and views.

* added publish, publish_from, publish_to fields.
Added sub-wiki and sub-page support to db models.

2008-09-20 Marco Pantaleoni <panta@elasticworld.org>

* Improved search, adding search in pages and wikis.

* implemented a basic search functionality.

2008-09-19 Marco Pantaleoni <panta@elasticworld.org>

* Added initial attachment support.
Fixed some related names for foreign keys.

Project details


File details

Details for the file softwarefabrica.django.wiki-1.0dev-BZR-r40-panta-elasticworld.org-20090108095450-sq8sz20twuagiob1.tar.gz.

File metadata

File hashes

Hashes for softwarefabrica.django.wiki-1.0dev-BZR-r40-panta-elasticworld.org-20090108095450-sq8sz20twuagiob1.tar.gz
Algorithm Hash digest
SHA256 cb42dc28bfc02af5f341d1d3ddb7f1a81d99452435ba6f0462824a73079d3e54
MD5 f2263397ed856b5e48c9b90ed59758be
BLAKE2b-256 042e92a803322a1b6e578a9cc6fffeee0a9c5875cc08e1ca16d5fc738184781c

See more details on using hashes here.

File details

Details for the file softwarefabrica.django.wiki-1.0dev_BZR_r40_panta_elasticworld.org_20090108095450_sq8sz20twuagiob1-py2.6.egg.

File metadata

File hashes

Hashes for softwarefabrica.django.wiki-1.0dev_BZR_r40_panta_elasticworld.org_20090108095450_sq8sz20twuagiob1-py2.6.egg
Algorithm Hash digest
SHA256 5559c48d3b3db5b67b94a595840d1d5357e61a522090e0c356290fa1d4ac8ffb
MD5 57c8b3ce7194d77a13840da902bbdadc
BLAKE2b-256 4a3c472d97feeecd5f956079bb0196b2d732452fdb646a150e2f0d16bc4b3fc9

See more details on using hashes here.

File details

Details for the file softwarefabrica.django.wiki-1.0dev_BZR_r40_panta_elasticworld.org_20090108095450_sq8sz20twuagiob1-py2.5.egg.

File metadata

File hashes

Hashes for softwarefabrica.django.wiki-1.0dev_BZR_r40_panta_elasticworld.org_20090108095450_sq8sz20twuagiob1-py2.5.egg
Algorithm Hash digest
SHA256 a1990e276171d279070344dde1ee14c01affce7b6093d5b54fd494335a5b6a66
MD5 0470386158be245d0dd0e8d1382eb41f
BLAKE2b-256 3c72f783414c55413f43250019503416b809929b9bdd59455736889792ebe4d9

See more details on using hashes here.

File details

Details for the file softwarefabrica.django.wiki-1.0dev_BZR_r40_panta_elasticworld.org_20090108095450_sq8sz20twuagiob1-py2.4.egg.

File metadata

File hashes

Hashes for softwarefabrica.django.wiki-1.0dev_BZR_r40_panta_elasticworld.org_20090108095450_sq8sz20twuagiob1-py2.4.egg
Algorithm Hash digest
SHA256 a841822bc5f56b7a7f3d3b5ecd4bdf97427880b7f3a9c5d5a16e768680df69a2
MD5 e5bc62efaa9b54997c83d0f433ed47bb
BLAKE2b-256 45f098b74aa0afd349fd3e0f2265cc5edf68d79548ff4435472136b2d18eb206

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page