目前很多研发团队已经使用了 Github 或者 Gitlab 自带的 Wiki 功能来管理文档,那么是否可以轻松地从这些平台将文档迁移到 Seafile 呢?答案是肯定的,由于 Seafile 的 Wiki 也是采用纯文本的 Markdown 格式保存文件的,所以与 Github,和Gitlab 的兼容性良好,文档的语法基本不用改动。
一、把文档导入Seafile
首先你要将 Github 或者 Gitlab 中的 Wiki 下载到本地一份,解压到一个目录里面。然后在 Seafile 中新建一个资料库,把这个本地目录里面的文件和子目录直接拖动到浏览器窗口中,即可快捷上传。
二、创建 index.md 和 home.md 文件
在 Seafile 的 Wiki 中,index.md 文件用于设定页面左边目录树的内容,而 home.md 则用于展示 Wiki 的首页内容。如下图所示。
其中 index.md 的格式与 Gitbook 使用的 SUMMARY.md 格式基本一致,都是通过列表嵌套的级别来表示目录的级别。文件中原有的相对路径链接也是可以直接使用的。需要注意的是,index.md 中每一级列表的缩进必须是两个空格,否则无法识别。
而 home.md 的作用与 Gitbook 的 README.md 的作用一样,所以如果你之前使用的是 Gitbook,可以直接将 README.md 重命名为 home.md。
三、发布文档
回到资料库界面点击左侧工具栏“已发布的资料库”,再点击正上方的“发布资料库”按钮,选择资料库提交即可完成发布。