原創軟體-3 提升你的文檔編輯效率Vs Code插件 羊大快速導航
這是我開發的一個專為視障用戶設計的VS Code多語言快速導航插件，
支援Python、Go和Markdown等格式，
內建NVDA/爭渡讀屏/系統語音SAPI朗讀，快速鍵直接操作導航模式和設定選項，不須操作複雜的ui控件，
讓你無論編輯MarkDown文檔，還是敲代碼都更加便捷!
主要功能
- 多語言導航支援 支援Python、Go、Markdown等多種語言
- 書籤功能 快速標記和跳轉到重要代碼位置，每個文檔都有獨立的書籤
- 語音朗讀整合 內建NVDA、ZDSR、Windows語音朗讀
- 雙模式操作 導航模式、設定模式快速鍵直接切換，無須操作複雜的UI控件
- 各種類型的精準導航 代碼中的注釋、判斷式導航，MarkDown的標題、連結、有序、吳旭列表導航
- go和python額外導航快速鍵 在原有導航功能之上的獨立快速鍵命令，方便的在函數、類定義，或是結構體之間跳轉
- 文檔行數統計，當前行號，按快速鍵直接播報
快速開始
- 你可以這樣理解這個插件
所有功能透過快速鍵操作
兩種模式→設定模式、導航模式
設定模式→各種設定選項
導航模式→切換導航類型，在指定的類型之間導航
任何情況都可以按的快速鍵→文檔字數、行數統計，當前所在行號，以及go和pyhton語言的專屬導航快速鍵 - 安裝插件後按 Alt+Shift+S 切換到導航模式
- 使用 Shift+Alt+上/下 切換導航類型
- 使用 Shift+Alt+左/右 執行導航跳轉
- 按 Ctrl+Win+K 添加書籤到當前位置
- 還有更多快速鍵請看後面完整快速鍵介紹
下載和安裝
你可以到這裡下載插件→
不會安裝插件嗎? 可以看之前我寫過的這篇文章裡的安裝步驟→
點我看包含vs code插件安裝方法的文章
或是
備用 點我看包含vs code插件安裝方法的文章
導航功能
插件會根據你目前編輯的檔案格式，自動提供對應的導航選項，
目前支援go、python和MarkDown，MarkDown會應用於任何除了.py和.go以外的所有格式，
但只有在.go和.py中插件才會自動啟動，在其他格式的文件中，只有按了插件的快速鍵插件才會啟動。
每種語言都有專門設計的導航類型，讓你能快速找到想要的代碼或內容段落。
Python導航
- 注釋 找到程式碼中的註釋行
- 判斷式 跳到if、elif、else等條件判斷
- 同級判斷式 在相同縮排層級的判斷式之間循環導航
Go導航
- 注釋 找到程式碼中的註釋行
- 判斷式 跳到條件判斷語句
Markdown導航
- 標題 跳到任何層級的標題
- 同級標題 在相同層級的標題之間循環移動，且只在當前所在的前一級標題內循環移動，而不是整個文檔的所有同級標題
- 連結 導航到文件中的每個超連結
- 有序列表 跳到編號列表項目，且在項目中旬環導航
- 無序列表 跳到項目符號列表，且在項目中旬環導航
- 代碼塊 找到程式碼區塊
go和python共有的導航
這個功能有自己的快速鍵→
ctrl+win+上、下翻頁鍵
用這個功能搭配導航快速鍵定位會更有效率
- 函數 直接跳到函數定義的地方
- go 找到type、struct、interface等類型定義
- python 找到類定義
操作模式
插件有兩種操作模式，按 Alt+Shift+S 可以切換不同的模式。
不同模式下，同樣的按鍵會有不同的功能。
導航模式
這是主要的工作模式，用來瀏覽和跳轉內容。
在這個模式下你可以按這些快速鍵→
- Shift+Alt+上/下 切換不同的導航類型
- Shift+Alt+左/右 執行跳轉動作
書籤管理
書籤功能在任何格式的導航類型都有，
你可以在任何地方設置書籤，然後快速跳回去查看。
- 按 Ctrl+Win+K 在目前這一行加入書籤
- 輸入一個好記的名字，或直接按Enter讓插件自動編號，書籤名稱如果超過１５字會被自動截斷，所以不要太長
- 確認自己在導航模式，按shift+alt+s來切換模式
- 按shift+alt上或下切換到書籤，然後按shift+alt+左或右就能在所有書籤間移動
- 按 Ctrl+Win+L 可以刪除最後跳轉到的書籤
- 還可以按Ctrl+Win+U 把書籤中的（原始位置）書籤更新到當前所在的行
設定模式
設定模式可以調整插件的各種設定選項。
快速鍵→
- Shift+Alt+左/右 選擇不同的設定項目
- Shift+Alt+上/下 修改設定值
可以調整語音引擎、是否朗讀行號、書籤記錄方式等
- 書籤記錄類型
- 僅記錄行號 如果內容有變動，跳轉過去之後可能看到的不是原本的內容
- 僅記錄行內容 相當於全文搜尋，只會跳到第一個匹配的行
- 記錄行號和行內容 會記錄行號和行的內容，當內容變動時，會根據紀錄的行號找到距離最近的匹配行
- 朗讀語音，有下面幾種選項可以選擇
- 自動
插件會自動偵測你電腦上的語音軟體，並選擇能用的來朗讀內容，
優先順序為→
NVDA→ZDSR→windows sapi - NVDA、爭渡讀屏、系統語音 可指定自己喜歡的語音，系統語音只作為最後的備用，可能性能不佳
- 如果切換了語音軟體，或是發現無法順利朗讀，可以按
ctrl+win+r重新偵測可用的語音
此功能會偵測當前啟動了哪個讀頻，並自動切換過去使用該讀頻朗讀
- 自動
所有快捷鍵
- 導航控制
- Shift+alt+S 在導航模式和設定模式間循環切換
- Shift+Alt+左/右 執行導航跳轉或切換設定項目
- Shift+Alt+上/下 切換導航類型或調整設定值
- go和python專屬額外導航
- ctrl+win+上、下翻頁鍵 在類定義、函數、結構體等之間跳轉
- 書籤操作
- Ctrl+Win+K 在目前位置加入書籤，直接enter用預設編號給書籤命名，ESC取消操作
- Ctrl+Win+L 刪除書籤（要先跳到想刪除的書籤）
- Ctrl+Win+U 把原始位置記錄更新到目前所在行
- 語音功能
- Ctrl+Win+R 重新偵測電腦上可用的語音軟體
- 文檔資訊
- Ctrl+Win+Home 朗讀整個檔案的總行數和總字數
- Ctrl+Win+End 朗讀游標目前的位置
注意事項
- 刪除書籤要先跳到那個書籤位置，而且要在60秒內操作才有效，避免誤刪書籤
- 原始位置這個特殊書籤不能刪除，它是用來記住你開始切換書籤前的位置
- 如果你使用了其他導航功能，刪除書籤的狀態就會被清除
- 有些快捷鍵可能跟系統快捷鍵衝突，可以在VS Code設定裡修改