用心打造
VPS知识分享网站

DokuWiki终于要内置Markdown支持了

DokuWiki是一款长期运行的开源 wiki 软件,用于文档、知识库和内部项目笔记。它正准备在下一个版本中添加原生 Markdown 支持,为用户提供一个内置的替代方案,以取代该项目自身的标记语法,用于编写和编辑页面。

DokuWiki终于要内置Markdown支持了

DokuWiki是一个轻量级的wiki平台,与基于数据库的系统不同,它将页面存储为纯文本文件,因此深受那些喜欢简单易用、支持自托管且易于备份和版本控制的工具的用户欢迎。而且,它似乎即将变得更好。

DokuWiki 的创始人 Andreas Gohr 宣布,下一个版本将支持直接解析和渲染 Markdown 文本。这意义重大,原因很简单:DokuWiki 一直以来都使用自己的语法,而 Markdown 已经成为开发者平台、文档工具、论坛和问题跟踪系统的标准格式。

为什么直到现在才推出这个选项?DokuWiki 和 Markdown 大约在 2004 年同时推出。因此,在 Markdown 被全球广泛采用,并进入 Reddit、Stack Overflow 和 GitHub 等平台之前,DokuWiki 就已经独立开发了自己的语法。

早期将 Markdown 添加到 DokuWiki 的尝试依赖于插件,例如 Markdowku 插件,该插件利用现有的解析器将 DokuWiki 和 Markdown 语法结合起来。然而,Gohr 指出,完整的 Markdown 支持无法以插件的形式有效实现,需要集成到 DokuWiki 的核心中。

该实现有三个主要目标:尽可能使用 DokuWiki 的解析器支持 Markdown 语法,允许用户在 DokuWiki 语法、Markdown 或混合模式之间进行选择,并根据现有的 Markdown 测试用例验证行为。

然而,该功能初期并不完全兼容 Markdown。Gohr 指出,DokuWiki 的单遍解析器难以甚至无法支持某些 Markdown 行为。例如,代码块规则已被简化,其实现主要集中于常见的三个反引号格式。

此外,某些功能被有意排除在外,例如通过文本下划线创建的标题样式。为了与现有渲染器和插件保持兼容性,标题内的格式设置(包括粗体文本或链接)最初也不受支持。

目前,新$conf['syntax']选项默认启用dw,因此 DokuWiki 语法仍保持标准格式。需要 Markdown 支持的用户必须在配置管理器中手动启用。未来,安装程序可能会默认采用混合md+dw模式,或者允许用户在安装过程中选择自己偏好的语法。

赞(0)
未经允许不得转载;国外VPS测评网 » DokuWiki终于要内置Markdown支持了
分享到