跳转到主要内容

为Django框架编写的维基系统。

项目描述

Docs Build status Coverage Status PyPi Downloads IRC

Django支持

下表解释了支持哪些Django版本。

版本

Django

升级自

0.11.x

3.2, 4.0, 4.1, 4.2, 5.0

0.10

0.10.x

2.2, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2

0.7

0.9.x

2.2, 3.0, 3.1, 3.2, 4.0

0.7

0.8.x

2.2, 3.0, 3.1, 3.2, 4.0

0.7

0.7.x

2.2, 3.0, 3.1, 3.2

0.5或0.6

0.6.x

2.1, 2.2, 3.0

0.5

0.5.x

2.1, 2.2

0.4

0.4.x

1.11, 2.0, 2.1

0.3

0.3.x

1.8, 1.9, 1.10, 1.11

0.2

0.2.x

1.8, 1.9, 1.10

0.1

0.1.x

1.5, 1.6, 1.7

0.0.24

0.0.24

1.4, 1.5, 1.6 1.7 (不稳定版)

0.0.?

关于升级说明,请参阅发行说明

翻译(Transifex)

Django-wiki已完全翻译成13种语言,除了默认(英语)和一些正在进行的额外语言。

但请帮忙增加更多语言!这非常简单,你甚至不需要是程序员。

一些语言...

  • ...只需要一点推动,因为它们几乎已经完成

  • ...已经启动,需要新的推动者来实现目标

  • ...尚不存在 - 但你可以请求它们并成为协调者

访问Transifex上的django-wiki项目

演示

这里提供了一个运行最新主分支的演示

https://demo.django-wiki.org

注册账户以查看通知系统,或您可以使用现有账户登录

  • 用户: admin

  • 密码:admin

社区

请使用我们的IRC或邮件列表(谷歌群组)来联系开发和支持。请勿通过电子邮件向开发者请求个人支持。

始终在进展中...

在许多因素的影响下,这个项目已经证明了自己是有用且稳定的。

  • 不会出现预期会导致数据丢失而没有适当升级路径的更改。

  • 模型API非常稳定,仅经历较小的变化。

  • 插件API看起来相当稳定。

  • 您可以通过PyPi(包名:wiki)使用SemVer版本控制方案来维护django-wiki的最新版本。

我应该自定义什么?什么可能会出问题?

您需要学习一些Django来自定义django-wiki。

最简单的是覆盖模板并创建自己的模板标签。不要为了修改wiki的内部部分而在自己的副本中创建硬拷贝,这种策略会导致您失去未来更新中高度改进的功能、插件和安全修复。

您也可以覆盖整个Bootstrap主题。目前,您最好维护自己的Bootstrap SCSS和硬拷贝,然后覆盖django-wiki的规则。

所有Python视图都是基于类的。然而,对于大多数情况,覆盖视图和URL不是最佳起点,因为大多数自定义可以通过插件、模板和SCSS实现。

贡献

欢迎贡献!❤️

请阅读我们的开发者指南

宣言

Django需要一个成熟的wiki系统,满足各种需求,无论是大是小。

  • 可插拔和轻量级。 不要将可选功能集成到核心中。

  • 开源。 创建一个扩展API,允许wiki生态以结构化的方式增长。维基百科由超过1100个扩展项目组成,这些项目是为MediaWiki编写的。我们应该从中学习。

  • 智能。 这是 MediaWiki中的表映射 - 我们将了解其他wiki项目的选择并做出自己的选择。毕竟,这是一个Django项目。

  • 简单。 源代码应该几乎可以自我解释。

  • 结构化。 Markdown是一种简单的语法,用于提高可读性。功能应通过内容字段中的简单编码模式实现,而不是以结构化的方式(在数据库中)存储,并通过友好的界面进行管理。这使网站开发人员重新获得控制权,并使知识更易于使用。只需问:维基百科为什么从未改变?答案:因为它的知识以复杂的方式存储,因此变得非常静态。

文档

请参阅docs/文件夹,或在以下位置阅读:

https://django-wiki.readthedocs.io/en/latest/

如果您想添加某些内容,请在该谷歌小组中提出问题,或者在您不确定某些内容是否可能更改的情况下提出问题。

背景

Django-wiki是对2009年的项目django-simplewiki的重新编写,该项目旨在成为wiki的基础系统。它建议用户通过覆盖模板来自定义wiki,但很快发现,真正发生的变化只是人们fork了整个项目。我们不希望这种情况发生在django-wiki上,我们希望它模块化且可扩展。

截至目前,Django已经存在很长时间,但还没有一个合适的wiki应用程序。Django-wiki的梦想是成为MediaWiki的竞争对手,这样Django开发人员就可以在面临如实现wiki等困难挑战时坚持使用Django平台。

Q&A

  • 为什么模块名为只是 wiki 因为我们尝试pip install wiki时,返回了“未找到任何关于wiki的发行版”,所以我们必须弥补这一点!……哦,django-wiki已被占用。

  • 您将使用哪种标记语言? Markdown。标记渲染器不是一个可插拔的部分,但它已经被内部化为核心部分。讨论应在这里进行:https://github.com/django-wiki/django-wiki/issues/76

  • 为什么不使用django-reversion?这是一个伟大的项目,但如果wiki必须发展壮大,有人将必须优化其行为,而在这种情况下,使用第三方应用程序作为至关重要的修订系统是不可行的。

  • 是否支持多个wiki?是的,从某种意义上说,您可以想象您始终拥有多个wiki,因为您始终拥有层次结构和对其权限的完全控制。请参阅此讨论:https://github.com/django-wiki/django-wiki/issues/63

Docker简述

这里有一个可用的docker容器:https://github.com/riotkit-org/docker-django-wiki

致谢

2009年最初的灵感来自django-cms,自那时起,Wagtail也做了大量工作来推广Django模型作为应用程序设计的根本结构和使能器。

项目详情


发布历史 发布通知 | RSS源

下载文件

下载适用于您平台的应用文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码分发

wiki-0.11.2.tar.gz (2.3 MB 查看哈希值)

上传 源代码

构建分发

wiki-0.11.2-py3-none-any.whl (2.4 MB 查看哈希值)

上传 Python 3

由以下支持