Skip to content

inyokaproject/inyoka

Repository files navigation

Inyoka

If possible, please read the pretty version (select the newest build, download the artifact 'Inyoka_Documentation').

The Inyoka portal system is divided into multiple modules to which we refer as applications. The name Inyoka means “snake” in zulu and was chosen because it’s a Python application 🤓.

Although the software is based on Django, it uses (sometimes and mostly for legacy reasons) different idioms and the non standard template engine Jinja. The basic application structure is explained below.

Build states

Master Build Status Master   Staging Build Status Staging   Testing Build Status Testing

Requirements

We’re using the recent LTS Django releases. Django and all python-requirements can be installed with pip.

The code is mostly tested with the database PostgreSQL. Theoretically, most functions should work with SQLite or any other database Django supports. The preferred caching system is redis.

Installation & Configuration

See :ref:`installation` and :ref:`getting-started`.

Applications of Inyoka

The following applications are part of Inyoka so far:

portal
The index application. It resides on no subdomain and is the portal page. It aggregates for example the recent ikhaya posts.
forum
The forum component. It’s inspired by phpBB2 which was previously used on the German ubuntuusers.de webpage. Some of the functionality was extended over time though. Especially an improved notification system, attachments and subforums.
wiki
MoinMoin inspired wiki engine. It’s not as advanced as moin but has revisioned pages and a parser which can safely generate XML based output formats. The wiki parser also has some BBCode elements for compatibility with the old phpBB syntax and is used in other components (forum, ikhaya, …) as well.
planet
A planet like feed aggregator. It archives and sanitizes input data thanks to feedparser.
ikhaya
Ikhaya is zulu for home and a blog application. It’s used on the German ubuntuusers portal for site wide announcements and other news. It doesn’t show up on the planet automatically, for that you have to add the ikhaya feed to it like any other blog.
pastebin
A pastebin that uses Pygments for highlighting. It does not support diffing yet but allows to download pastes.