匠果 编辑器实现了基础的 Markdown 语法,还在此基本上进行了拓展,支持大纲、数学公式、脑图、图表、流程图、甘特图、时序图、五线谱、多媒体、代码高亮等诸多特性,尤其重要的是 Vditor 支持即时渲染(类似 Typora),大幅提升了 Markdown 的作写体验。
1. 界面
匠果编辑器主要主要由三部分组成:目录栏(左)、文章栏(中)、编辑栏(右)。
1.1. 目录栏
一部作品是由章、节组成,目录栏就是作品的章,您也可以将其视为文件的目录。目录栏是对章(目录)进行管理的工具。
1.1.1. 作品信息栏
显示作品名称。鼠标悬停于右侧箭头处,弹出功能菜单:
- 设置:前往作品设置页面。
1.1.2. 目录工具条
- 新建:新建目录;
- 编辑:编辑目录信息;
- 删除:删除当前选择的目录。删除目录会连同其中的文章一同删除,请谨慎操作。
1.1.2.1. 新建(编辑)目录
- 标题:章(目录)的标题;
- 简介:本章核心思想简要介绍;
- 评论:是否可以评论;
- 显示:是否在前台页面显示。关闭后,该章(目录)不会在前台页面显示,但其中的文章仍然会显示。
- 目录列表栏:显示当前作品的章(目录)。
1.1.3. 右键菜单
在章(目录)节点上点击鼠标右键,会弹出相应的操作菜单。
1.2. 文章栏
文章栏对章(目录)内的文章进行管理,包括新建、编辑、删除、撤销发布、历史记录等功能。
1.2.1. 文章信息栏
文章信息栏显示当前章(目录)下的文章相关信息。
1.2.2. 文章工具条
- 新建:新建文章;
- 编辑:编辑文章信息;
- 删除:删除文章;
- 撤销发布:撤销已发布的文章。被撤销的文章将不会在网站前台展示;
- 版本管理:显示文章编辑过程中产生的版本;
1.2.2.1. 版本管理
匠果编辑器对文章编辑过程中产生的不同版本进行记录和管理,版本管理 展示了文章的历史版本,创作者可根据自身需要选择回退。
1.2.3. 文章列表栏
文章列表栏显示章(目录)的文章列表。
- 创建时间:文章创建距离现在的时间;
- 状态:文章当前的状态。:草稿:已发布
- 标题及简介;
- 标签:您可以为文章设置相应的标签,便于归类和搜索。一篇文章最多可设置5个标签;
- 引用图:文章内引用的图片缩略图。
1.3. 编辑栏
文章编辑区域,包括功能信息栏和编辑器。
1.3.1. 功能信息栏
- 专注模式:打开/关闭目录栏和文章栏及信息提示和通知等,使创作不被其它因素干扰;
- 文章标题:当前正在编辑的文章标题;
- 保存:保存正在编辑的文章;
- 发布:发布当前正在编辑的文章。文章发布后,将会在网站前台公布展示;
- 信息菜单:当前登录的创作者信息。鼠标悬停则显示功能菜单,如下:
- 网站首页:返回匠果首页;
- 作品管理:返回作品管理页;
- 退出登录。
1.3.2. 编辑器工具栏
工具栏展示了常用的编辑工具,包括标题、加粗、斜体、删除线、链接等,创作时可根据自身需要使用,也可直接在编辑器内键入 Markdown 标记达到相同的目的。
1.3.3. 编辑器
文章编辑区域。
2. 什么是双向链接
双向链接,是一种升级的标签,利用双中括号 [[]] 将关键词概括起来,在前台查看文章时,将鼠标移动至关键词或点击关键词,就可以显示或跳转到相应的内容,从而形成一个网状知识结构,让你在不知不觉中,搭建起一个知识网络,让知识在不同的情境中自由流动,帮你对抗知识的遗忘,对抗知识的碎片化。
2.1. 匠果的双向链接
匠果是以书籍作品为核心,通过双向链接的形式将作品的各章的知识互联,从而让知识流动了起来,形成网状知识结构。
匠果支持以下两种双向链接方式:
- [[]] 两个中括号可以引用书中的章节。如下图所示,键入连续的两个中括号 [[ 会自动弹出章节列表,选中其中要引用的项即可:
- (()) 两个小括号可以引用章节中的段落,具体操作方法同上。
- 引入双项链接并发布文章后,在作品的文章页面,将鼠标移动至引用链接上,将会以如下方式进行展示:
通过 [[]] 的方式,把生活、学习、工作等点点滴滴记录下来,在这个过程中,你会发现有新的知识出现,你可以选择为其创建一个链接(输入 [[ 并输入新的知识回车,系统会自动创建文章 ),待日后学习和记录,长久以往你的知识就形成了网状结构,也就成为了你的作品。
建立双链后,你可以通过关系图来查看作品中所有文章或当前文章与其它的文章之间的关系。共有三种关系图查看方式:
- 点击编辑器目录栏的 全局关系图 图标,即可查看作品中所有文章的关系图;
- 点击编辑器文章栏的 关系图 图标,即可查看当前文章的关系图;
- 前台文章页面右侧可查看当前文章的关系图。
2.3. 注意事项
要尽量避免引用未发布的文章或段落,因为它不会在前台的文章页面展示。