跳转到主内容

专栏

Hugo

Hugo 使用与配置笔记:内容格式、Markdown 速查、图表(GoAT / Mermaid)、Emoji、页面资源与页捆绑。

Hugo 相关笔记,大多是对着官方文档整理的中文速查:先能查、再能改。本站与主站都由此构建。

文章列表

15 篇

Hugo 中的 npm 依赖处理

Hugo 怎么处理 npm 依赖:hugo mod npm pack 与 package.hugo.json 的工作流、js.Build 对 node_modules 的解析,以及三种项目规模下的选型建议。

阅读全文 →

Hugo Config

Hugo 的 markup(Markdown 渲染)配置:Goldmark 的 passthrough 扩展与 LaTeX 数学公式的写法。

阅读全文 →

用原型生成页包

原型(archetype)生成页包的实例:`archetypes/post-bundle/` 的目录结构与 `hugo new` 的产物。

#Archetype#Template
阅读全文 →

Shortcode

短代码(shortcode)用于在 Markdown 里扩展它本身不支持的语法:内置简码的用法,以及自己写一个简码的步骤。

#Shortcode
阅读全文 →

Page Resources

Hugo 页面资源概念说明:图像、其他页面、文档等与页面关联的资源拥有自己的 URL 和元数据,可通过页捆绑机制统一管理。

#Resources
阅读全文 →

Front Matter

Hugo 的 front matter(前置元数据):YAML / TOML / JSON 三种格式、官方参考里的例子与默认变量,以及用户自定义字段。

#Front Matter#Markdown
阅读全文 →

页捆绑(Leaf Bundles)

Hugo 页捆绑入门:当页面除 Markdown 外还涉及图片、PDF 等资源时,把 index.md 与相关文件放进同一文件夹管理更清晰,文中给出 Leaf Bundle 的目录组织示例与官方文档链接。

阅读全文 →

Emoji

Hugo 表情速查:在站点配置中开启 enableEmoji 后,即可用短代码输出表情,文中按 People、Nature、Objects、Places、Symbols 五类整理完整短代码列表。

#Emoji
阅读全文 →

Hugo 使用

Hugo 命令行使用手册:给出 hugo help 帮助信息的中文翻译,涵盖 server、new、mod 等子命令与常用构建参数,并演示 hugo config mounts 与 hugo convert 格式转换。

#Hugo#Usage
阅读全文 →

Diagrams

在 Hugo 中使用图表:用 GoAT 语法绘制 ASCII 图表并推荐 Diagon 在线生成器,用 Mermaid 编写流程图、时序图,文中附立方体、光线折射等示例代码。

#Hugo#Diagram
阅读全文 →

Markdown

Markdown 语法速查表:解释 Markdown 快速排版转 HTML 的定位,逐节给出标题、强调、列表、链接、图片、代码高亮、表格、水平线的写法与效果示例。

#Markdown#Cheatsheet
阅读全文 →