# SPDX-License-Identifier: AGPL-3.0-or-later """ FreedomBox app for Feather Wiki. This is a FreedomBox-native implementation of a Feather Wiki Nest. This app doesn't install any Debian packages. """ from django.urls import reverse_lazy from django.utils.translation import gettext_lazy as _ from freedombox import app as app_module from freedombox import cfg, frontpage, menu from freedombox.config import DropinConfigs from freedombox.modules.apache.components import Webserver from freedombox.modules.backups.components import BackupRestore from freedombox.modules.firewall.components import Firewall from freedombox.modules.users.components import UsersAndGroups from freedombox.utils import format_lazy from . import manifest, privileged _description = [ format_lazy( _('Feather Wiki is a tool to create simple self-contained wikis, each ' 'stored in a single HTML file on your {box_name}. You can use it as ' 'a personal wiki, as a web notebook, or for project documentation.'), box_name=_(cfg.box_name)), _('Each wiki is a small file. Create as many wikis as you like, such as ' 'one wiki per topic. Customize each wiki to your liking with extensions ' 'and other customization options.'), format_lazy( _('Feather Wiki is downloaded from {box_name} website and not from ' 'Debian. Wikis need to be upgraded to newer version manually.'), box_name=_(cfg.box_name)), format_lazy( _('Wikis are not public by default, but they can be downloaded for ' 'sharing or publishing. They can be edited by ' 'any user on {box_name} belonging to the wiki group. ' 'Simultaneous editing is not supported.'), box_name=_(cfg.box_name), users_url=reverse_lazy('users:index')) ] class FeatherWikiApp(app_module.App): """FreedomBox app for Feather Wiki.""" app_id = 'featherwiki' _version = 1 def __init__(self): """Create components for the app.""" super().__init__() groups = {'wiki': _('View and edit wiki applications')} info = app_module.Info(self.app_id, self._version, name=_('Feather Wiki'), icon_filename='featherwiki', description=_description, manual_page='FeatherWiki', clients=manifest.clients, tags=manifest.tags) self.add(info) menu_item = menu.Menu('menu-featherwiki', info.name, info.icon_filename, info.tags, 'featherwiki:index', parent_url_name='apps') self.add(menu_item) # The shortcut is a simple directory listing provided by Apache server. # Expecting a large number of wiki files, so creating a shortcut for # each file (like in ikiwiki's case) will crowd the front page. shortcut = frontpage.Shortcut( 'shortcut-featherwiki', info.name, icon=info.icon_filename, description=info.description, manual_page=info.manual_page, url='/featherwiki/', clients=info.clients, tags=info.tags, login_required=True, allowed_groups=list(groups)) self.add(shortcut) dropin_configs = DropinConfigs('dropin-configs-featherwiki', [ '/etc/apache2/conf-available/featherwiki-freedombox.conf', ]) self.add(dropin_configs) firewall = Firewall('firewall-featherwiki', info.name, ports=['http', 'https'], is_external=True) self.add(firewall) webserver = Webserver('webserver-featherwiki', 'featherwiki-freedombox') self.add(webserver) users_and_groups = UsersAndGroups('users-and-groups-featherwiki', groups=groups) self.add(users_and_groups) backup_restore = BackupRestore('backup-restore-featherwiki', **manifest.backup) self.add(backup_restore) def setup(self, old_version=None): """Install and configure the app.""" super().setup(old_version) privileged.setup() if not old_version: self.enable() def uninstall(self): """Purge directory with all the wikis.""" super().uninstall() privileged.uninstall() def get_wiki_list(): """List all the Feather Wiki files.""" return sorted([ path.name for path in privileged.wiki_dir.iterdir() if path.suffix == '.html' ])