工作區管理
VMark 中的工作區是以資料夾形式開啟的專案根目錄。開啟工作區後,側邊欄會顯示檔案樹狀結構、快速開啟功能可索引所有 Markdown 檔案、終端機從專案根目錄啟動,且你的開啟分頁會在下次啟動時還原。
若未開啟工作區,你仍然可以開啟單一檔案,但無法使用檔案總管、專案內搜尋和工作階段還原。
開啟工作區
| 方式 | 操作 |
|---|---|
| 選單 | 檔案 > 開啟工作區 |
| 快速開啟 | Mod + O,然後在底部選擇 **瀏覽... ** |
| 拖放 | 從 Finder 將 Markdown 檔案拖入視窗 — VMark 自動偵測其專案根目錄並開啟工作區 |
| 最近的工作區 | 檔案 > 最近的工作區,選取先前的專案 |
開啟工作區時,VMark 會在側邊欄顯示檔案總管。若之前已開啟過此工作區,先前開啟的分頁會自動還原。
TIP
若目前視窗有未儲存的變更,VMark 會提示你在新視窗中開啟工作區,避免遺失目前的工作內容。
檔案總管
開啟工作區後,檔案總管會出現在側邊欄,顯示以工作區資料夾為根目錄的 Markdown 檔案樹狀結構。
導覽
- 單擊 資料夾以展開或折疊
- 雙擊 或按 Enter 開啟檔案(在分頁中)
- 非 Markdown 檔案以系統預設應用程式開啟
檔案操作
右鍵點擊任意檔案或資料夾可存取情境選單:
| 操作 | 說明 |
|---|---|
| 開啟 | 在新分頁中開啟檔案 |
| 重新命名 | 行內編輯檔案或資料夾名稱(也可按 F2) |
| 複製 | 建立檔案的副本 |
| 移至... | 透過對話框將檔案移至其他資料夾 |
| 刪除 | 將檔案或資料夾移至系統垃圾桶 |
| 複製路徑 | 複製絕對檔案路徑至剪貼簿 |
| 在 Finder 中顯示 | 在 Finder 中顯示檔案(macOS) |
| 新建檔案 | 在此位置建立新的 Markdown 檔案 |
| 新建資料夾 | 在此位置建立新資料夾 |
你也可以直接在樹狀結構中 拖放 檔案至不同資料夾。
顯示切換
預設情況下,檔案總管只顯示 Markdown 檔案並隱藏點檔案(dotfile)。兩個切換選項可更改此行為:
| 切換選項 | 快捷鍵 | 功能 |
|---|---|---|
| 顯示隱藏檔案 | Mod + Shift + .(macOS)/ Ctrl + H(Win/Linux) | 顯示點檔案和隱藏資料夾 |
| 顯示所有檔案 | (設定或情境選單) | 在文件旁顯示非 Markdown 檔案 |
這兩項設定均按工作區儲存,並在工作階段之間持久保留。
排除的資料夾
以下資料夾預設從樹狀結構中排除:
.gitnode_modules
這些預設值在工作區第一次開啟時套用。
快速開啟
按 Mod + O 開啟快速開啟覆蓋層。它提供三個來源的模糊搜尋:
- 你之前開啟過的 最近檔案
- 目前視窗中的 已開啟分頁(以圓點標示)
- 工作區中的 所有 Markdown 檔案
輸入幾個字元即可篩選 — 搜尋為模糊匹配,因此 rme 可找到 README.md。使用方向鍵導覽,按 Enter 開啟。底部的固定 **瀏覽... ** 選項可開啟檔案對話框。
| 操作 | 快捷鍵 |
|---|---|
| 開啟快速開啟 | Mod + O |
| 在結果中導覽 | 上 / 下 |
| 開啟選取的檔案 | Enter |
| 關閉 | Escape |
TIP
未開啟工作區時,快速開啟仍然有效 — 它會顯示最近的檔案和已開啟的分頁,但無法搜尋檔案樹。
最近的工作區
VMark 可記憶最多 10 個最近開啟的工作區。可從選單列的 檔案 > 最近的工作區 存取。
- 工作區按最後開啟時間排序(最近的在前)
- 清單在每次變更時同步至原生選單
- 選擇 清除最近的工作區 以重設清單
工作區設定
每個工作區都有自己的設定,在工作階段之間持久保留。設定儲存在 VMark 應用程式資料目錄中 — 不在專案資料夾內 — 所以你的工作區保持整潔。
以下設定按工作區儲存:
| 設定 | 說明 |
|---|---|
| 排除的資料夾 | 從檔案總管中隱藏的資料夾 |
| 顯示隱藏檔案 | 是否顯示點檔案 |
| 顯示所有檔案 | 是否顯示非 Markdown 檔案 |
| 最後開啟的分頁 | 下次開啟時還原工作階段的檔案路徑 |
TIP
工作區設定與資料夾路徑綁定。在同一台電腦上開啟相同資料夾,始終會還原你的設定,即使是從不同視窗開啟也一樣。
工作階段還原
關閉有工作區的視窗時,VMark 會將已開啟分頁的清單儲存至工作區設定。下次開啟同一工作區時,這些分頁會自動還原。
- 只有已儲存檔案路徑的分頁才會被還原(未命名分頁不會持久儲存)
- 若自上次工作階段以來某個檔案已被移動或刪除,會靜默跳過
- 工作階段資料在視窗關閉和工作區關閉(檔案 > 關閉工作區)時儲存
多視窗
每個 VMark 視窗都可以有自己獨立的工作區。這讓你可以同時處理多個專案。
- 檔案 > 新視窗 開啟全新視窗
- 在新視窗中開啟工作區不影響其他視窗
- 視窗大小和位置按視窗記憶
從 Finder 拖入 Markdown 檔案時,若目前視窗已有未儲存的工作,VMark 會自動在新視窗中開啟該檔案的專案。
終端機整合
整合終端機會自動使用工作區根目錄作為其工作目錄。開啟或切換工作區時,所有終端機工作階段都會 cd 至新的根目錄。
在每個終端機工作階段中,VMARK_WORKSPACE 環境變數會被設定為工作區路徑,讓你的腳本可以引用專案根目錄。