Quiver快速入門
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 - 單元格類型
目前支持五種單元格類型:
- 文本單元格:支持富文本編輯,圖像和鏈接。
- 代碼單元格:使用 ACE 代碼編輯器,語法高亮顯示支持 120+ 語言、 20 + 主題、 支持自動縮進、 代碼自動補全,功能多多。
- Markdown 單元格:支持自定義 CSS,即時預覽。
- LaTeX 單元格: 使用 MathJax 來排版筆記中的數學公式。
- 圖表單元格:使用純文本創建序列圖和流程圖。
文本單元格
你可以使用工具欄按鈕或鍵盤快捷方式更改文本格式。在"格式"菜單下可以找到所有格式設置選項和鍵盤快捷方式。
代碼單元格
這是一個代碼單元格設置為 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 單元格中使用。
圖表單元格
使用圖標單元格可以很方便地創建序列圖和流程圖。
請參照這里的語法:
序列圖示例:
預覽如下:
流程圖示例:
預覽如下:
3 - 單元格操作
單元格操作很容易上手,但其實功能強大。
其中最重要的一個操作你已經學會了:按"shift + 返回"(⇧⏎) 來創建一個新的單元格。默認情況下新建的單元格是一個文本單元格,但你可以輕松地將其轉換為其它類型的單元格。
轉換單元格類型有好幾種方法:你可以使用工具欄上的下拉菜單,或者鍵盤快捷方式 (⌥⌘1 轉換為文本單元格,⌥⌘2 轉換為代碼單元格,⌥⌘3 轉換為 Markdown 單元格,⌥⌘4 轉換為 LaTeX 單元格,⌥⌘5 轉換為圖表單元格)。這些快捷方式可以在“單元格”菜單下找到。
另一個重要的操作是如何合並兩個單元格。只需將光標放在第二個單元格的開頭,然后按回退鍵。請注意不同類型的單元格不能合並。
有時候你可能想在當前光標位置添加一個新的單元格。你可以用“單元格”菜單下的 "New Cell At Cursor" (⇧⌘I) 菜單項實現。
你還可以剪切、復制或粘貼單元格,拆分單元格,向上或向下移動單元格。所有這些單元格操作和其相應的鍵盤快捷方式可以在“單元格”菜單下找到。
4 - 圖像、 文件和鏈接
你可以拖拽或粘貼圖像到文本單元格中。你也可以使用工具欄中的“插入圖像”按鈕 。
插入的圖像自動復制到當前筆記的資源文件夾中,因此即使原始圖像被刪除,筆記中的圖像也照樣可以使用。
如果將一個文件 (例如,PDF、 zip、 源文件) 拖拽到文本單元格中,你可以選擇將它復制到資源文件夾,或者保存為鏈接。您也可以使用工具欄中的“附加文件”按鈕。
如果粘貼的文本中有 URL,Quiver 會自動將其轉換為鏈接,比如 http://www.apple.com。
另一個有用的功能是筆記鏈接。您可以使用“筆記”菜單下的菜單項"復制筆記鏈接"(⌃⌥⌘C)來復制當前筆記的鏈接,例如:
這樣你可以很方便地交叉引用你的筆記。不同筆記本中的筆記也可以相互鏈接。
筆記鏈接在 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 文件。這樣你可以輕松地在另一台電腦上加載同樣的設置。