使用django的简单、模块化wiki站点
ThorsonWiki的Python项目详细描述
thorson wiki是一个简单的django wiki框架。它允许开发人员创建 一个或多个维基快捷方便。框架设计为 可扩展且易于使用,为 案例,以及用于更复杂案例的高级api。
安装
安装Thorson Wiki的最简单方法是使用pip
或
easy_install
。
安装软件包:
pip安装thorson_wiki
将
thorson_wiki
添加到django中的INSTALLED_APPS
设置。运行
manage.py migrate
来同步数据库。
创建Wiki
要创建Wiki,必须首先告诉Thorson Wiki有关
要创建的Wiki。使用
THORSONWIKI_NAMESPACES
设置。此设置是字典映射
命名空间名称以获取有关该命名空间的信息。下面是一个例子,
只包含必需的设置。
THORSONWIKI_NAMESPACES = { 'mywiki': { 'title': "My Wiki", 'description': "A wiki designed by me, for me.", 'author': "Jacob Collard", 'landing': "Home Page", } }
title
属性为wiki提供了一个可读的标题
命名空间。这将出现在导航栏中的大多数模板中。这个
描述出现在模板html的description<meta>
标记中。
同样,author
出现在author<meta>
标记中。
landing
是wiki登录页的名称。
如果您使用的是默认模板,也建议您添加 以下设置:
THORSONWIKI_DEFAULT_NAMESPACE = 'mywiki' LOGIN_URL = reverse_lazy(THORSONWIKI_DEFAULT_NAMESPACE + 'login') LOGIN_REDIRECT_URL = reverse_lazy(THORSONWIKI_DEFAULT_NAMESPACE + ':main')
接下来你需要做的是告诉你的项目你的wiki的网址。
简单地从thorson_wiki.urls
导入include_wiki
,并添加
遵循您的urlpatterns:
url(r'^my_base_url/', include_wiki('mywiki'))
这将自动生成以my_base_url
开头的url
与wiki相关。只需导航到my_base_url
,然后
你会发现你的维基正在运行。请注意,如果尚未创建
在登录页中,当您访问wiki时将提示您这样做。