跳到主要内容

_30-知识库系统操作手册

Responsive Image

会员部分

首次配置的流程较多,但绝大部分都属于一次性配置,以后无需再次操作!部分截图因为任务进度原因,将会稍后更新,如有不明,请联系客服!

区分平台版和OB版,VUE版部分

一、会员全流程体验

1、配置操作流程

1.1.1 获取OBSIDIAN插件

  • 关注微信公众号【易东云网络】
  • 在页面底部发送关键词【云助理OB插件】或【obyun】
  • 根据提示下载插件压缩包

1.1.2 官网注册会员并获取参数

  • 官网:www.ydc.show
  • 注册会员并进入会员中心;
  • 复制以下OBSIDAIN的相关参数等待备用;

1.1.3 安装OBSIDIAN插件

  • OB官网:obsidian.md
  • 从OB官网下载安装电脑客户端到自己电脑
  • 建立OB新仓库
  • 安装【云助理BS插件】到新仓库,安装方法自行百度即可;
  • 回到OB客户端的插件页面,粘贴来自易东云助理平台相应的参数;如图;
  • OB端配置已完成;

2、文档发布流程

1.2.1 OB客户端编辑文档

  • OB客户端建立两个新目录【blog】和【docs】,将分别用于文章动态和在线文档的内容;
  • 在blog和docs目录下,建立任意的若干文章用于测试;
  • 发布到平台有两个方式:一是在左边栏单击图标【发布到易东云助理】的全部发布按钮,发布成功后,会发现右上角有成功发布的提示;二是仅仅发布某一个被修改MD文件,鼠标单击文件名称后右键打开菜单,选择【发布到易东云助理】;如图;

1.2.2 云助理平台发布文档

  • 回到易东云助理的会员中心,找到刚才成功发布的仓库,单击发布按钮进行发布;如图;
  • 大约经过两到三分钟,刷新页面,确认有【已发布】标识;
  • 单击链接图标查看已经发布成功的在线文档。


二、进阶配置

2.1 OB客户端

2.1.1 图片上传

  • 如果MARKDOWN语法熟手,可能不少人都在用picgo工具,不过这里强烈推荐用picgo,这是在picgo基础上发展起来的,功能做了很多的提升;
  • 如果你是MARKDOWN零基础,请直接上手使用piclist即可;具体用法可以自行百度。

2.1.2 MARKDOWN语法

  • 如何你是已经有MARKDOWN语法基础的同学,那么恭喜你,你将会身轻如燕的快速了解并操作系统;
  • 如果你对MARKDOWN语法是零基础,那么也不要担心,因为语法较为简单,通过一小时的学习,基本可以应付大部分的文档写作场景,如果你想把页面搞得更加美观和友好,那么就需要一定时间的学习了;
  • 为了提升大家的MARKDOWN写作水平,我们将会对一个演示文档进行持续维护,给大家一个学习交流的平台。

2.1.3 在线文档终端模拟

  • 如果您是高频次编辑在线文档,又或者对样式的美观有一定的要求,我们推荐使用NODE本地环境来实时模拟终端的样式效果;配置较为简单,即时您是零基础也可以轻松完成,一次配置后即可持续使用;
  • 请注意在OB客户端的样式效果并不能绝对100%模拟线上的效果,因为这属于两个系统了,绝大部分的效果是一样的,但是在细节上每个平台都会有自己的特色,就好像两部不同品牌的汽车,使用方法是完全一样的,但是细节上会有个性化的不同。

2.1.4 自定义样式预设

  • 为了快速处理一些经常用到的样式效果,比如二维码的大小和居中调整,我们做了一些预设,您只需要通过名称快速调用即可;
  • 可自定义自己独有的样式效果。

2.2 云助理平台

2.1.1 在线文档首页参数配置

  • 文档原生首页的绝大部分参数是可以在管理后台直接配置的,包括LOGO,品牌名称等;
  • 稍后我们将会基于BULMA的组件做出更加美观和友好的首页,您可以自由选择;
  • 查看截图

2.1.2 域名自定义

  • 在线文档的首页链接有不同文档的仓库的串码,看起来较长,可以通过自定义域名的方式进行缩短,方便推广和宣传;自定义域名有以下三种,可根据自己的需要在服务器自行配置;
    • CNAME:仅仅替换原域名,串码不会被隐藏,免费服务;
    • 显性URL转发:云服务商有免费额度,跳转后还会显示原网址,串码不会被隐藏,如果您只需要在首页入口使用较短的域名,那么这个是合适的;
    • 隐性URL转发:云服务商是收费服务,跳转后不会显示原网址,包括串码也会被隐藏,从效果上看是最佳选择;
  • 还有一个选择是选择短链服务,通过短链可以同时起到优化域名和统计点击次数的功能。


三、常见报错提示

3.1 OB客户端

将根据使用中碰到的问题进行更新。。。。。。

3.2 云助理平台

将根据使用中碰到的问题进行更新。。。。。。


END