Hugo广告位管理系统使用示例

这是一个演示Hugo广告位管理系统的示例文章。

广告位管理系统特性

1. 支持的广告位置

目前系统支持以下有效的广告位置：

• toc-start - TOC目录上方 ✅
• toc-end - TOC目录下方 ✅
• body-end - 页面底部（文章结尾）✅

2. 灵活的配置方式

通过在文章的前置元数据中配置 ads 字段，你可以精确控制在不同位置显示哪些广告：

ads:
  toc-start: ["social-follow"]           # TOC开始位置
  toc-end: ["adsense-banner"]           # TOC结束位置  
  body-end: ["wechat-sponsor"]          # 页面底部

3. 支持的广告位类型

目前系统支持以下广告类型：

• social-follow - 社交媒体关注
• adsense-banner - AdSense横幅广告
• adsense-sidebar - AdSense侧边栏广告
• affiliate-books - 图书联盟推荐
• course-promotion - 课程推广
• wechat-sponsor - 微信赞助二维码

4. 配置层级

• 全局配置: 在 config/_default/params.yaml 中设置默认广告位
• 页面配置: 在单篇文章中覆盖全局设置
• 禁用广告: 通过 disable_ads: true 完全禁用某篇文章的广告

使用示例

基础配置

# 在 config/_default/params.yaml 中设置默认配置
ads:
  toc-start: ["social-follow"]
  toc-end: ["adsense-banner"] 
  body-end: ["wechat-sponsor"]

文章级配置

# 在具体文章的 frontmatter 中
ads:
  toc-start: ["social-follow", "course-promotion"]  # 多个广告
  toc-end: []                                       # 不显示广告
  body-end: ["wechat-sponsor"]                      # 页面底部显示

完全禁用广告

# 禁用某篇文章的所有广告
disable_ads: true

重要更新说明

⚠️ Hugo Blox 主题支持的 Hook 位置有限

经过测试，以下位置是有效的：

• ✅ toc-start - 文章目录上方
• ✅ toc-end - 文章目录下方
• ✅ body-end - 页面底部

以下位置无效（主题不支持）：

• ❌ content-start - 已删除
• ❌ content-middle - 已删除
• ❌ content-end - 已删除

如果需要在文章中间插入广告，建议：

1. 手动在 Markdown 中插入广告代码
2. 使用 body-end 作为文章结尾广告位
3. 扩展主题模板添加更多 Hook 位置

扩展性

系统设计具有很好的扩展性：

1. 添加新广告类型: 只需在 layouts/partials/ads/ 目录下创建新的模板文件
2. 添加新广告位置: 需要确保 Hugo Blox 主题支持该 Hook 位置
3. 支持A/B测试: 可以轻松配置不同的广告组合进行测试

这个广告管理系统让你能够：

• 🎯 精确控制广告显示位置
• 🔧 灵活配置不同文章的广告策略
• 📊 方便进行A/B测试和效果优化
• 🚀 保持代码整洁和可维护性