代码片段¶
代码片段是一段可复用的文本,你只需几次按键就能插入。片段让你免于重复输入样板内容——代码块骨架、彩色文字标签、今天的日期——还能包裹当前选区以就地重新排版。
片段管理¶
每个用户自定义片段都以一个 json 文件保存,因此片段就是可备份、可分享的文件。VNote 还内置了一些片段,例如插入当前日期。内置片段为只读;你可以用面板的显示内置片段开关来显示或隐藏它们。
代码片段停靠部件列出所有可用片段。
定义片段¶
创建片段时,你可以设置:
- 名称(Name)——用于搜索片段的标识符。
- 快捷方式——可选的两位数字代码,用于快速定位片段。
- 光标标记(Cursor Mark)——标记应用片段后光标停留的位置。它在内容中应出现一次。
- 选区标记(Selection Mark)——标记选中文本的插入位置。它可以出现多次;应用片段时,每个选区标记都会被替换为选中的文本。
默认情况下,光标标记是 @@,选区标记是 $$(如下方示例所用)。
应用片段¶
从片段面板¶
把光标放到你想要插入文本的位置,然后在片段面板中双击某个片段。
使用快捷键¶
在编辑器中按 Ctrl+G, I 调出包含所有片段的面板。在其中你可以:
- 输入片段的两位数字代码(例如
00)直接应用。 - 输入名称的一部分(例如
my)进行搜索,然后按Enter应用第一个匹配项。 - 按
Tab在搜索框与片段列表之间移动焦点,用方向键在列表中导航,再按Enter应用所选片段。
通过符号¶
在编辑器中直接输入 %snippet_name%,然后按 Ctrl+G, I,即可把该符号展开为片段 snippet_name。VNote 中许多单行输入框也接受这种写法,包括新建笔记对话框、新建笔记本对话框以及笔记模板。
示例¶
插入 C++ 代码块(光标落在内部):
注释掉选中的文本:
包裹选区以着色或高亮:
若要选中一段文本并立即包裹它:先选中,再应用片段,$$ 标记会被替换为你的选区,同时光标移动到 @@。
模板中的片段¶
由于模板支持片段,模板可以在你创建笔记时自动填入内容——例如把笔记名作为标题插入。参见模板。