美文网首页Linux
用 Seafile 公开资料库功能高效发布文档

用 Seafile 公开资料库功能高效发布文档

作者: Seafile | 来源:发表于2019-07-05 16:40 被阅读0次

    在Seafile 7.0中,用户可以将一个资料库作为公共资料库来对外发布。如果你有对外的手册、指南等文档需要发布,就可以使用这一功能。 比如我们 Seafile 的服务器手册就是发布为一个公开的资料库。


    公开资料库中的 Markdown 格式的文件会直接在公开资料库界面中展现。公开资料库中也可以包含任意格式的文件,这些文件点击后会在单独的外链页面中打开,访问者可以在线查看或者下载这些文件。

    现在很多开源软件作者都会将文档作为代码托管在 github 上,然后将 Markdown 文件编译成 html 再对外发布。通过直接将文档的原始 Markdown 文件保存在 Seafile 中,即可以所见即所得的方式来编辑维护文档,同时对外发布,大大简化了流程。后续我们会专门写一篇文章来介绍如何将现有的文档从 Github, Gitbook 等平台迁移到 Seafile。

    发布一个资料库为公开资料库

    如下图所示,在Seafile网页端左侧工具栏选择“已发布的资料库”,再点击正上方的“发布资料库”按钮,选择并提交需要发布的资料库即可。已发布的资料库将显示在下方列表中,任何人都可以通过该资料库的url来访问其中的文件。

    公开资料库中的导航

    你可以用两种方式为公开资料库提供导航:

    • 直接显示目录树
    • 使用 index.md 文件

    直接显示目录树

    对简单的文档,你可以不用自定义导航,资料库左边栏会直接显示出目录树。访问者可以在目录树中快速访问某个文件。


    使用 index.md 文件

    当我们需要发布手册这种文档时,导航条目应该是按照方便大家阅读的顺序来编排,而目录树只能以资料库固有的目录顺序来提供导航,也不支持调整导航条目的顺序。为了解决这个问题,在Seafile专业版7.0.4或者社区版7.0.3版本之后,我们可以在资料库中手动创建 index.md 文件,并通过插入列表来自定义导航条目的名称和顺序。

    如下图所示,创建 index.md 文件之后,你可以插入列表并为每个列表项添加一个文档的链接,方便在导航中跳转。列表项的名称可以修改,每个列表项都会转化为导航中一个同名的条目,条目的顺序和自定义列表项的顺序是一致的。


    如下图所示,在index.md文件中插入自定义列表之后,当用户访问公开资料库时,左边的导航栏显示的不再是目录树,而是一个和列表每一项的名称、顺序完全一致的导航。点击左侧导航中任意一个条目,界面右侧都会立刻呈现出对应的文档内容。


    Seafile 7.0 版本现在已经发布到了 Seafile 的官网(https://www.seafile.com/download/),感兴趣的用户可以去下载使用,欢迎大家反馈意见!

    相关文章

      网友评论

        本文标题:用 Seafile 公开资料库功能高效发布文档

        本文链接:https://www.haomeiwen.com/subject/mhvehctx.html