Hugo 相关笔记,大多是对着官方文档整理的中文速查:先能查、再能改。本站与主站都由此构建。
专栏
Hugo
Hugo 使用与配置笔记:内容格式、Markdown 速查、图表(GoAT / Mermaid)、Emoji、页面资源与页捆绑。
文章列表
Hugo 中的 npm 依赖处理
Hugo 怎么处理 npm 依赖:hugo mod npm pack 与 package.hugo.json 的工作流、js.Build 对 node_modules 的解析,以及三种项目规模下的选型建议。
Hugo Config
Hugo 的 markup(Markdown 渲染)配置:Goldmark 的 passthrough 扩展与 LaTeX 数学公式的写法。
用 hugo convert 转换 front matter
把旧笔记的 TOML front matter 批量转成 YAML:`hugo convert` 的可用子命令与迁移时的注意点。
菜单条目的页面参数
菜单条目怎么读页面参数:用 `version` 参数在菜单名旁渲染版本号,并用 with / if 处理外链条目与缺参数的情况。
Front Matter
Hugo 的 front matter(前置元数据):YAML / TOML / JSON 三种格式、官方参考里的例子与默认变量,以及用户自定义字段。
页捆绑(Leaf Bundles)
Hugo 页捆绑入门:当页面除 Markdown 外还涉及图片、PDF 等资源时,把 index.md 与相关文件放进同一文件夹管理更清晰,文中给出 Leaf Bundle 的目录组织示例与官方文档链接。
Emoji
Hugo 表情速查:在站点配置中开启 enableEmoji 后,即可用短代码输出表情,文中按 People、Nature、Objects、Places、Symbols 五类整理完整短代码列表。
Hugo 使用
Hugo 命令行使用手册:给出 hugo help 帮助信息的中文翻译,涵盖 server、new、mod 等子命令与常用构建参数,并演示 hugo config mounts 与 hugo convert 格式转换。
Diagrams
在 Hugo 中使用图表:用 GoAT 语法绘制 ASCII 图表并推荐 Diagon 在线生成器,用 Mermaid 编写流程图、时序图,文中附立方体、光线折射等示例代码。
Markdown
Markdown 语法速查表:解释 Markdown 快速排版转 HTML 的定位,逐节给出标题、强调、列表、链接、图片、代码高亮、表格、水平线的写法与效果示例。