跳转至

代码片段

代码片段是一段可复用的文本,你只需几次按键就能插入。片段让你免于重复输入样板内容——代码块骨架、彩色文字标签、今天的日期——还能包裹当前选区以就地重新排版。

片段管理

每个用户自定义片段都以一个 json 文件保存,因此片段就是可备份、可分享的文件。VNote 还内置了一些片段,例如插入当前日期。内置片段为只读;你可以用面板的显示内置片段开关来显示或隐藏它们。

代码片段停靠部件列出所有可用片段。

定义片段

创建片段时,你可以设置:

  • 名称(Name)——用于搜索片段的标识符。
  • 快捷方式——可选的两位数字代码,用于快速定位片段。
  • 光标标记(Cursor Mark)——标记应用片段后光标停留的位置。它在内容中应出现一次
  • 选区标记(Selection Mark)——标记选中文本的插入位置。它可以出现多次;应用片段时,每个选区标记都会被替换为选中的文本。

默认情况下,光标标记是 @@,选区标记是 $$(如下方示例所用)。

应用片段

从片段面板

把光标放到你想要插入文本的位置,然后在片段面板中双击某个片段。

使用快捷键

在编辑器中按 Ctrl+G, I 调出包含所有片段的面板。在其中你可以:

  • 输入片段的两位数字代码(例如 00)直接应用。
  • 输入名称的一部分(例如 my)进行搜索,然后按 Enter 应用第一个匹配项。
  • Tab 在搜索框与片段列表之间移动焦点,用方向键在列表中导航,再按 Enter 应用所选片段。

通过符号

在编辑器中直接输入 %snippet_name%,然后按 Ctrl+G, I,即可把该符号展开为片段 snippet_name。VNote 中许多单行输入框也接受这种写法,包括新建笔记对话框、新建笔记本对话框以及笔记模板

示例

插入 C++ 代码块(光标落在内部):

```cpp
@@
```

注释掉选中的文本:

<!-- $$@@ -->

包裹选区以着色或高亮:

<font color=red>$$@@</font>
<mark>$$@@</mark>

若要选中一段文本并立即包裹它:先选中,再应用片段,$$ 标记会被替换为你的选区,同时光标移动到 @@

模板中的片段

由于模板支持片段,模板可以在你创建笔记时自动填入内容——例如把笔记名作为标题插入。参见模板