Quiver快速入门

Quiver快速入门

装载自：https://github.com/HappenApps/Quiver/wiki/Quiver%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8

Quiver 是一个程序员专用的记事本应用，可轻松混合文本、代码、Markdown、LaTeX 到一个记事本中。提供强大的代码编辑功能，以及对 Markdown 和 LaTeX 的编辑和即时预览，提供全文搜索功能。

1 - 开始使用

欢迎使用 Quiver！本教程将帮助您入门。

如果你想立即开始使用 Quiver，只用记住一件事：

Quiver 的笔记是由单元格组成。

单元格可以是一段文本，代码，Markdown，或者LaTeX。一个笔记中可以混排不同类型的单元格，甚至可以给不同的代码单元格设置不同的语言。

新建一https://github.com/HappenApps/Quiver/wiki/Quiver%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8#%E6%96%87%E6%9C%AC%E5%8D%95%E5%85%83%E6%A0%BC个笔记，开始键入你想写的内容。按"shift + 返回"(⇧⏎) 创建一个新的单元格，使用退格键合并单元格。只要知道这些你就可以开始使用 Quiver 了。

但如果你想要了解更多，请继续阅读。

2 - 单元格类型

目前支持五种单元格类型:

1. 文本单元格：支持富文本编辑，图像和链接。
2. 代码单元格：使用 ACE 代码编辑器，语法高亮显示支持 120+ 语言、 20 + 主题、 支持自动缩进、 代码自动补全，功能多多。
3. Markdown 单元格：支持自定义 CSS，即时预览。
4. LaTeX 单元格： 使用 MathJax 来排版笔记中的数学公式。
5. 图表单元格：使用纯文本创建序列图和流程图。

文本单元格

你可以使用工具栏按钮或键盘快捷方式更改文本格式。在"格式"菜单下可以找到所有格式设置选项和键盘快捷方式。

代码单元格

这是一个代码单元格设置为 JavaScript 模式:

这是一个代码单元格设置为 CoffeeScript 模式:

代码单元格支持 120 + 语言的语法高亮、 20 + 主题、 自动缩进，代码折叠，多个游标和选择、 代码自动补全、tab 触发，Vim/Emacs 键绑定等。在 Ace 代码编辑器的网站 http://ace.c9.io 上，你可以读到更多 Ace 代码编辑器的功能。

Markdown 单元格

Markdown 单元格支持标准 Markdown 语法以及 GitHub Flavored Markdown (GFM)。

基本格式

列表

引用

链接

你可以创建链接到另一个笔记：(“笔记”菜单 -> 复制笔记链接 -> 粘贴)

表格

GFM 任务列表

行内 LaTeX

您可以在 Markdown 单元格中使用行内 LaTeX，例如，$x^2$。

LaTeX 单元格

使用 LaTeX 单元格可以很容易地排版数学公式。例如，

预览如下：

也可以在行内使用 LaTeX，例如，$x^2$。

您还可以在设置中添加自定义宏。添加的自定义宏可以在所有的 LaTeX 单元格中使用。

图表单元格

使用图标单元格可以很方便地创建序列图和流程图。

请参照这里的语法：

• 序列图: http://bramp.github.io/js-sequence-diagrams/
• 流程图: http://flowchart.js.org/

序列图示例:

预览如下：

流程图示例:

预览如下：

3 - 单元格操作

单元格操作很容易上手，但其实功能强大。

其中最重要的一个操作你已经学会了：按"shift + 返回"(⇧⏎) 来创建一个新的单元格。默认情况下新建的单元格是一个文本单元格，但你可以轻松地将其转换为其它类型的单元格。

转换单元格类型有好几种方法：你可以使用工具栏上的下拉菜单，或者键盘快捷方式 (⌥⌘1 转换为文本单元格，⌥⌘2 转换为代码单元格，⌥⌘3 转换为 Markdown 单元格，⌥⌘4 转换为 LaTeX 单元格，⌥⌘5 转换为图表单元格)。这些快捷方式可以在“单元格”菜单下找到。

另一个重要的操作是如何合并两个单元格。只需将光标放在第二个单元格的开头，然后按回退键。请注意不同类型的单元格不能合并。

有时候你可能想在当前光标位置添加一个新的单元格。你可以用“单元格”菜单下的 "New Cell At Cursor" (⇧⌘I) 菜单项实现。

你还可以剪切、复制或粘贴单元格，拆分单元格，向上或向下移动单元格。所有这些单元格操作和其相应的键盘快捷方式可以在“单元格”菜单下找到。

4 - 图像、 文件和链接

你可以拖拽或粘贴图像到文本单元格中。你也可以使用工具栏中的“插入图像”按钮 。

插入的图像自动复制到当前笔记的资源文件夹中，因此即使原始图像被删除，笔记中的图像也照样可以使用。

如果将一个文件 (例如，PDF、 zip、 源文件) 拖拽到文本单元格中，你可以选择将它复制到资源文件夹，或者保存为链接。您也可以使用工具栏中的“附加文件”按钮。

如果粘贴的文本中有 URL，Quiver 会自动将其转换为链接，比如 http://www.apple.com。

另一个有用的功能是笔记链接。您可以使用“笔记”菜单下的菜单项"复制笔记链接"(⌃⌥⌘C)来复制当前笔记的链接，例如：

02 - Cell Types

03 - Cell Operations

这样你可以很方便地交叉引用你的笔记。不同笔记本中的笔记也可以相互链接。

笔记链接在 Markdown 单元格中也可以使用。在“笔记”菜单下使用菜单项“复制笔记链接”(⌃⌥⌘C)，然后粘贴到 Markdown 单元格。例如：

它在预览或演示模式中会变成笔记链接。

5 - 预览和演示模式

即时预览

Quiver 支持 Markdown 和 LaTeX 的即时预览。你可以切换到同时显示编辑器和预览的双栏模式 (⌘6)。

你也可以双击列表中的笔记在新窗口打开，然后切换到双栏模式。例如：

当您在编辑器中进行更改时，预览会实时更新。

默认情况下，编辑器和预览之间会同步滚动。但您可以在视图菜单中关闭此功能。

演示模式

Quiver 还支持全屏幕演示模式。您可以从“笔记”菜单中选择“启动演示”(⌃⌥⌘P)，或单击笔记右下角的“演示”按钮。

演示模式非常适合教室使用、 团队会议、 演示或者自己复习笔记。

在演示模式中，你可以使用左/右箭头键来移动到列表中的上个/下个笔记。

6 - 全文搜索

笔记再好，不能快速找到也没用。Quiver 的全文搜索是基于苹果操作系统中 Spotlight 使用的底层工具：Search Kit。因此 Quiver 可以瞬间搜索数以千计的笔记。

若要搜索所有的笔记，请单击右上角的搜索按钮。你可以通过关键字、 标题或 #标签 搜索。

你也可以在一个笔记本中搜索。首先打开笔记本，在列表底部的搜索框中输入关键字或 #标签。这也是全文搜索，不过只显示当前笔记本中的搜索结果。

如果你想在一个笔记中查找关键词，请使用 ⌘F。你会看到一个查找工具栏：

使用 ⌘G (或回车键) 跳转到下一个搜索结果。用 ⇧⌘G （或 shift + 回车）向上查找。

查找工具栏在编辑器和预览中都可以使用。

7 - 标签

Quiver 支持给笔记加标签。这是又一种整理笔记的方式。

你可以按标签分类来浏览笔记：

如果你从列表中同时选择多个笔记，你可以同时给他们添加或删除标签。

8 - 云同步

Quiver 支持使用任意基于文件的云盘同步，比如 Dropbox，iCloud Drive，Google Drive。

要使用云同步，在设置中打开同步页：

将你的 Quiver 库文件转移到 Dropbox 或其他云盘，然后在另一台电脑上打开库文件。这样两台电脑上的笔记会随时同步。

9 - 团队协作

Quiver 支持好几种团队协作的方法。

共享笔记本

共享笔记本是保存在云盘上的一个笔记本。任何基于文件的云盘都可以，比如 Dropbox，iCloud Drive，Google Drive。你可以创建一个新的共享笔记本，或者将一个本地笔记本移到云盘上转换成共享笔记本。另一个团队成员可以在另一台电脑上打开共享笔记本，进行编辑。共享笔记本中的笔记会自动同步。这是一个很好的创建团队共享知识库的方法。

多个用户可以同时对同一个共享笔记本进行操作，比如添加或删除笔记，添加或删除标签。这些操作会自动同步。但是，请注意如果两个团队成员同时修改同一个笔记，Quiver 不会自动解决冲突，而是提醒其中一方笔记已被修改，需要刷新。

版本控制

如果你使用版本控制系统来管理你的代码和文档，建议你也用版本控制系统 （Git， SVN）来管理 Quiver 的笔记。因为 Quiver 的笔记只是普通的 JSON 文本文件，你可以作为文本文件将它们提交到存储库中。

你可以将整个 Quiver 库文件放到版本控制中，或者只放几个笔记本。用版本控制系统管理 Quiver 笔记的一个好处是：如果两个用户同时编辑一个笔记，用版本控制系统可以很方便地解决合并冲突。

10 - 备份和恢复

对于那些不使用云同步或版本控制的用户，还有一种方式可以保管好您的笔记。

若要备份整个库文件，请在设置中打开备份设置页：

选择“备份”来备份您的所有笔记。如果你想要从以前的备份中还原您的所有笔记，请选择“从备份恢复” 然后选择以前的备份。

11 - 导入与导出

Quiver 不会将你的笔记锁住。

Quiver 的笔记本和笔记都保存为普通的 JSON 文本文件。文件格式在此有详细的说明：https://github.com/HappenApps/Quiver/wiki/Quiver-Data-Format。

因此你可以放心，你的笔记永远不会无法读取。而且，Quiver 也很容易与你使用的其它工具集成。

Quiver 自带的导出器支持 HTML、 PDF 和 Markdown。你可以导出整个 Quiver 的笔记本为相互链接的 HTML 网页。

导出为 Markdown 时，代码单元格会自动转换为 Markdown 内嵌代码块。这样你可以很方便地将导出的 Markdown 文件上传到 GitHub 或其它使用 Markdown 的平台。

如果你有特殊的导入或导出的需要，你可以很容易地写一个脚本，读取 Quiver 的笔记格式，然后导出成你想要的格式。自定义脚本对于编写编程相关的书籍或教程的用户尤其有用。

几个示例脚本可以在这里找到: https://github.com/HappenApps/Quiver/wiki/Export-Scripts。

12 - 设置

在常规设置页，您可以更改默认的笔记列表排序、 默认单元格类型等。

在主题设置页，您可以管理界面的主题。Quiver 附带了几个设计精美的主题，包括一个浅色主题和一个深色主题。你也可以自己设计主题。

在单元格设置页，您可以显示/隐藏行号，启用代码自动补全、 更改键绑定，创建整个应用程序范围的 LaTeX 自定义宏等。

在样式设置页，您可以给编辑器、 预览、 演示、 导出的 HTML 或 PDF 设置自定义样式。支持的所有标准的 CSS 规则，如字体大小、 文本颜色、 背景颜色等。

在快捷方式设置页，您可以设置几个系统键盘快捷方式: 将 Quiver 窗口移前、 创建新笔记，和搜索笔记。

同步设置页和备份设置页前面已讲过了。

在高级设置页，您可以将您的设置和自定义 CSS 导出成一个 JSON 文件。这样你可以轻松地在另一台电脑上加载同样的设置。