注意事项别名=ps蒸 汽 波

1. 文章标题时，标题从二级标题开始：## xxx
   |二级标题将作为大标，居中显示，后续标题左对齐

Hugo 命令和网站部署

• 部署网站：./utils/deploy.sh
• 在本地服务器上运行：hugo server
  |注意文件路径

Shortcodes

见Daisilia 主题文档

Snippets

使用 Vscode Snippet 功能

编辑代码片段（Snippets）：Ctrl+Shift+p，搜索“snipets”，选择“配置用户代码片段”,选择“markdown.js”

使用自动补全（输入时在光标处的弹出窗口）：

• Up、Down
• Tab/Enter：确定

内置 Snippets

• bold：粗体
• italic：斜体
• fenced codeblock：代码块
• code：行内代码
• fenced math：数学公式
• inline math：行内数学公式
• heading1 … heading6：1 到 6 级标题（小技巧：输入 h4 即可触发 heading4 的提示，其他类似）
• …

自定义 Snippets

CHEERFUL

新建 content 目录下的 test.md 文件：

1

hugo new test.md

markdown.json 文件示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{
  "rrf": {
    "prefix": "rrf",           // 触发文本
    "description": "rellink",
    "body": [                  // 多行
      "[${1:name}]({{< relref \"${2:ref}\" >}})",
      "hello"
    ]
  },
  "kbd": {
    "prefix": "kbd",
    "body": "<kbd>${1:keys}</kbd>", // 单行
  }
}

一般格式

每一个代码片段格式为：

1
2
3
4
5
6
7
8

"rellink": {
  "prefix": "rrf",
  "description": "relative permalink",
  "body": [
    "[${1:name}]({{< relref \"${2:ref}\" >}})",
    "hello"
  ]
}, // 注意这个逗号

• 每个代码片段均有一个唯一的标识符，如"rellink"
• prefix: 触发文本，输入该文本（如rrf）
• description：描述文本，随意
• body：代码块主体，可以用一个字符串表示单行，或一个列表表示多行。

占位符

1

${<num>:<prefill text>}

• <num>：移动顺序
• <prefill text>：预填充文本

特殊占位符：

• $<num>：复制 <num> 号占位符
• $0：移动的终点，移动到此处时结束，不能再反向移动

显示内容

relref指向ID

hugo new diary/2023/05/22.md

更新主题：./update_theme.sh