Hugo

以下是 Hugo 中 Markdown 文件开头的元数据区域（官方术语叫 Front Matter）的参数详解： 📌 结构说明 --- 参数名: 值 --- 本质是 YAML/TOML/JSON 格式的元数据区块，用于控制 Hugo 的渲染行为。以下对每个参数做详细解释： 一、核心元数据组 参数 作用说明 推荐值示例 title 文章标题，会被用作 HTML 的 <title> 标签 "深度解析人工智能未来趋势" date 文章创建时间（重要排序依据） 2024-05-30T14:30:00+08:00 tags 标签分类，支持多个标签（影响分类页面生成） ["AI", "机器学习"] draft 草稿模式开关，true 时仅在 hugo server -D 下可见 false (发布时改为false) 二、内容展示控制组 参数 功能细节 主题适配性 showToc 是否显示文章目录（需主题支持） 大多数主题兼容 TocOpen 目录初始展开状态 部分主题支持 hidemeta 隐藏发布日期等元信息显示 主题相关 comments 是否开启评论区（需集成 utterances 等第三方评论系统） Disqus/Utterances 等 三、SEO优化组 参数 技术细节 canonicalURL 规范链接，用于防止重复内容SEO惩罚（当多URL指向同一内容时指定权威地址） description 网页描述（重要SEO元素，建议控制在155字符内） disableHLJS 禁用代码高亮（可提升页面加载速度） 四、高级配置组 参数 特殊说明 weight 手动控制排序权重，值越小排序越靠前（需去掉注释 # 才能生效） aliases 设置 URL 别名（示例值访问 /first 会跳转到该文章） cover 头图配置： - relative: true 表示使用页面资源包（Page Bundle）中的图片 - hidden: true 仅在正文不显示头图 五、开发者工具组 参数 使用场景 editPost 添加「编辑此页」链接（需配置 Git 仓库路径）： - appendFilePath: true 会自动追加文件路径 六、主题拓展组（不同主题功能不同） 参数 常见主题支持情况 ShowReadingTime 显示预计阅读时间（多数主题支持） ShowPostNavLinks 显示上一篇/下一篇导航 UseHugoToc 使用 Hugo 原生目录生成替代主题自带的目录系统 ❗️ 重点注意事项 多作者声明方式： ...

初始化一个 Hugo 网站: 1. 打开终端/CMD，执行初始化命令： hugo new site my-website 这会创建名为 my-website 的网站目录 2. 进入网站目录： cd my-website 3. （建议）添加主题，以最常用的 Ananke 主题为例： git init # 初始化Git仓库 git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke 4. 修改配置文件 hugo.toml，末尾添加： theme = "ananke" 5. 创建第一篇内容： hugo new posts/my-first-post.md 6. 启动本地预览： hugo server -D 打开浏览器访问 http://localhost:1313 就能看到网站啦！ 补充说明： 新建站点后会看到这些默认目录结构： ├── archetypes/ # 内容模板 ├── content/ # 网站内容 ├── layouts/ # 自定义模板 ├── static/ # 静态文件 ├── themes/ # 存放主题 └── hugo.toml # 配置文件 如果要生成静态文件，执行： hugo -D 生成的文件会在 public/ 目录中 ...