開發設定

本文介紹 Hugo 開發相關設定。

編輯器設定

• VS Code 語法高亮和補全：theNewDynamic/language-hugo-vscode
• JetBrains 語法高亮和補全：Smart Hugo

Formatter 設定

HTML

可以使用 prettier 插件以格式化 HTML + go-template。

npm install --save-dev prettier prettier-plugin-go-template

{
  "plugins": ["prettier-plugin-go-template"],
  "overrides": [
    {
      "files": ["*.html"],
      "options": {
        "parser": "go-template"
      }
    }
  ]
}

並且使用 prettier --write --list-different FILE 格式化。

也可以使用 Hugo 官方的 gotmplfmt，和 prettier 相比最大的差異為 gotmplfmt 不支援沒有任何設定，不支援 style 和 script 標籤，而且不是 npm 生態系。

Markdown

rumdl 是 Markdown LSP 而不只是 formatter，並且支援 Hugo 特殊用法，比如 shortcode, Markdown attributes, custom root 等等。