Test Admonition
Admonition Test Page
这个页面用来测试 Hugo render hooks 实现的 admonition 功能。
基础 Admonition 类型
Note 类型
这是一个提示
这里是提示的内容,可以包含多行文本和其他 markdown 元素。
重要信息: 支持粗体文本和其他格式。
Info 类型
信息提示
这是一条信息性内容,通常用于向读者提供有用的背景知识。
Tip 类型
实用技巧
这里分享一个实用的小技巧,可以帮助提高效率。
- 支持列表项
- 也支持代码:
hugo server --buildDrafts
Warning 类型
注意事项
请注意这个重要的警告信息。在执行某些操作之前,请确保备份重要数据。
Danger 类型
危险警告
这是一个危险操作的警告。执行此操作可能导致数据丢失或系统损坏。
可折叠的 Admonition
剧透内容(可折叠)
点击查看剧透
《星球大战》中,达斯·维德其实是卢克的父亲。这个情节是电影史上最著名的转折之一。
可折叠的代码示例
点击展开代码示例
以下是一个简单的 Hugo shortcode 示例:
{{ $title := .Get "title" | default "Default Title" }}
<div class="custom-block">
<h3>{{ $title }}</h3>
{{ .Inner | markdownify }}
</div>
可折叠的技术细节
高级用法说明
如果你想深入了解 Hugo render hooks,可以查看以下内容:
- Blockquote Render Hook: 处理引用块的自定义渲染
- 属性支持: 可以为引用添加自定义属性
- 条件渲染: 根据内容判断是否应用 admonition 样式
更多信息请参考 Hugo 官方文档。
带属性的引用
普通引用
代码是写给人看的,恰好也能在机器上运行。
带作者的引用
生活就像一盒巧克力,你永远不知道下一颗是什么味道。
只有来源的引用
知识就是力量。
技术引用
任何能够出错的事情,都会出错。
嵌套内容测试
包含代码的 Admonition
配置提示
在使用 admonition 功能之前,请确保你的 config.toml 包含以下配置:
[markup.goldmark.parser.attribute]
block = true
title = true
包含列表的 Admonition
功能特性
当前 admonition 功能支持:
- ✅ 多种类型(note, info, tip, warning, danger, spoilers)
- ✅ 可折叠内容(使用
+符号) - ✅ 自定义标题
- ✅ 嵌套 Markdown 内容
- ✅ 暗色主题适配
包含表格的 Admonition
类型对照表
| 类型 | 颜色 | 图标 | 用途 |
|---|---|---|---|
| note | 蓝色 | ℹ | 一般信息 |
| info | 蓝色 | ℹ | 重要信息 |
| tip | 绿色 | 💡 | 技巧提示 |
| warning | 橙色 | ⚠ | 警告注意 |
| danger | 红色 | 🚨 | 危险警告 |
| spoilers | 紫色 | 👁 | 剧透内容 |
常规 Blockquote
这些是常规的引用块,不使用 admonition 语法:
这是一个普通的引用块。它保持传统的引用样式,不会被转换为 admonition。
程序员的三大美德:懒惰、急躁和傲慢。
优化代码的第一条规则:不要优化。 优化代码的第二条规则(仅限专家):还是不要优化。
混合使用示例
在实际使用中,你可能会这样组合不同的内容:
重要提醒
在开始之前,请注意以下几点:
然后是一个普通的引用:
最好的代码是没有代码。
最后再来一个技巧:
高级技巧
如果你想要更好的性能,可以考虑:
hugo --minify --gc
这会启用压缩并进行垃圾回收。