功能升级 | Choerodon猪齿鱼“新”知识管理介绍

Choerodon猪齿鱼知识管理是一种内容管理工具，具备建立、编辑、导航、连接、搜索等功能。它为企业、IT团队提供方便的项目协做平台和强大的项目内容管理平台，集中式管理产品相关内容等，例如需求收集、架构设计、功能设计、开发规范、命名规范、会议记录、计划安排等。

在0.17版本中，猪齿鱼上线了新的知识管理，做为项目团队内容管理功能，并在0.18作了升级和功能加强，而原有的承载知识管理功能的Wiki管理将在0.19版本正式下线。

那么，这个新的知识管理和以前的“知识管理（Wiki管理）”有何不一样？

新老知识管理有何区别？

猪齿鱼早期的知识管理——“Wiki管理”是团队基于开源产品XWiki所开发。XWiki是一个由Java编写的基于LGPL协议发布的开源wiki和应用平台，基本涵盖了在知识、文档管理等方面所需的各类大小功能。但随着产品的不断演进，XWiki官方团队减小对产品的投入，大大下降了迭代以及运维的效率。

而0.18版本中使用的知识管理则由猪齿鱼团队自行开发，内置于猪齿鱼平台，再也不须要跳转至Wiki空间，保留了文档编辑、分享、管理等基本功能，总体上更加轻量。

为何要从新开发一个新的知识管理服务？

随着更多新用户的增长以及数据的不断积累，XWiki已经没法知足用户在体验和操做上的更高需求，根据社区成员和用户的反馈，猪齿鱼进行了商议和选型，通过1个迭代的周期推出了新的知识管理。

选择从新开发的缘由有不少，主要有如下几点：

▍1. 功能开发成本高

Wiki管理自上线以来，一直在不断迭代优化，但猪齿鱼在实际开发过程当中发现，针对wiki管理的功能优化，即便是一些广泛性需求，功能开发代价也经常加倍。

好比使用频率很高的分享功能，因为原XWiki中的分享功能在猪齿鱼平台中没法知足到用户的需求，猪齿鱼只能进行二次开发。在开发过程当中，常常会由于一些诸如须要先读懂源代码逻辑等工做，让工做量超出预期，反而下降了团队的开发效率。

▍2. 升级引发重构

猪齿鱼引用XWiki(版本)实现了内容的管理，但同时，为了知足用户的需求，通常都会对其进行二次开发，在此状况下，若是猪齿鱼跟随官方对XWiki进行了升级，那就意味着二次开发代码的重构，升级的不肯定性会带来很大的成本，所以弃用XWiki并开发新的知识管理颇有必要。

▍3. 操做较为复杂，用户体验不佳

猪齿鱼是一个既追求产品功能又重视产品体验的平台。在前几个版本中，开发者更多地是在关注功能是否缺失，可随着产品功能的逐步完善，产品经理和设计师的关注度逐步向体验和操做转移。

根据产品团队的不彻底统计，针对Wiki管理，社区论坛上关于操做的问题达到50%以上，性能问题达到了20%以上，好比：

一、Wiki服务与猪齿鱼平台用户同步的问题； 二、权限配置的问题； 三、左侧树形菜单结果加载过慢问题。

这一切本不应出现的问题，占到了总数的70%，此时，猪齿鱼团队更加肯定Wiki必须重构。

猪齿鱼知识管理服务上线

从决定重构，选型，开发再到最后的上线，开发团队先后花了大概3周的时间，在0.17版本发布了一个可用的基础版。

新的知识管理是一个开发轻量级，操做简便的内容管理工具，具备最基本的建立、编辑、导航、连接、版本回滚、搜索等功能，组织层和项目层均有属于本身的知识管理服务。

1、操做和体验

▍1. 安装、升级更加快捷

无需引入第三方XWiki，可直接部署、升级猪齿鱼知识管理服务。

▍2. 操做简单，弱化了权限设置操做，突出团队共享

结构权限上与以前的Wik相比，没变的是同项目的成员可查看项目内建立的全部文档，不一样的是组织层的文档，各个项目成员均能查看；

项目成员可对其余成员建立的文档进行编辑，但只能删除本身建立的文档。

▍3. 界面布局清晰，无需手册容易上手

2、功能

▍1. 文档的建立与编辑

• 建立文档便是建立内容也是建立页面；
• 编辑器支持基本的编辑须要；
• 支持实时保存，离开界面时，会进行确认提醒；
• 支持2种编辑模式：markdown/所见即所得。

▍2. 文档的查看

• 点击左侧树形菜单结构进行查看（无限层级）；
• 支持全局搜索查看；
• 可显示目录，经过目录跳转到目标位置进行查看；
• 可针对文档进行评论、附件上传；
• 面包屑导航显示文档的位置；
• 可经过分享连接的方式，分享本身建立的文档，非项目成员可经过分享的连接查看文档。

▍3. 其余操做

• 文档可在左侧树型菜单上自由移动，可移动单个文档或文档集；
• 支持Word格式文档的导入；
• 支持PDF的导出；
• 支持版本回滚以及历史版本对比（并显示新增和删除记录）；
• 全部操做日志的记录。

针对知识管理，猪齿鱼团队会逐步迭代，进行功能和操做体验的提高。但愿重构后的知识管理能够更好地帮助到你们，也欢迎你们多多反馈，开发团队会积极回应你们的需求和意见。

插播通知

Choerodon猪齿鱼将于0.19版本正式取消Wiki管理功能，全部文档内容管理相关操做请你们在知识管理中进行。

Wiki管理和知识管理会在0.18版本中并行，方便用户进行数据迁移。Choerodon猪齿鱼系统已经将全部用户所属项目空间下的Wiki文档自动迁移至知识管理，如您在wiki空间中还有新的增改，可点击知识管理菜单栏上方“wiki迁移”进行手动二次迁移。

关于Choerodon猪齿鱼

Choerodon猪齿鱼是一个开源多云技术平台，是基于开源技术Kubernetes，Istio，knative，Gitlab，Spring Cloud来实现本地和云端环境的集成，实现企业多云/混合云应用环境的一致性。平台经过提供精益敏捷、持续交付、容器环境、微服务、DevOps等能力来帮助组织团队来完成软件的生命周期管理，从而更快、更频繁地交付更稳定的软件。

Choerodon猪齿鱼已开通官方微信交流群，欢迎你们添加Choerodon猪齿鱼微信(ID:choerodon-c7n)入群

你们也能够经过如下社区途径了解猪齿鱼的最新动态、产品特性，以及参与社区贡献：

• 官网：http://choerodon.io
• 论坛：http://forum.choerodon.io
• Github：https://github.com/choerodon
• 码云：https://gitee.com/choerodon