Skip to content

Carbon Ads

VitePress 内置了对 Carbon Ads 的原生支持。通过在配置中定义 Carbon Ads 凭据,VitePress 将在页面上显示广告。

js
export default {
  themeConfig: {
    carbonAds: {
      code: 'your-carbon-code',
      placement: 'your-carbon-placement'
    }
  }
}

这些值是你的 Carbon 帐户中的 data-carbon-zonedata-carbon-placement 属性。要了解有关这些值的更多信息,请访问 Carbon Ads 网站

当用户访问你的站点时,Carbon 将显示来自其广告商网络的广告。广告的质量和内容由 Carbon 控制,VitePress 不会影响显示的广告。

位置

Carbon Ads 将显示在以下位置:

  • 在桌面视图中,广告将显示在右侧边栏中,就在目录下方。
  • 在移动视图中,广告将显示在内容和页脚之间。

禁用广告

你可以通过不提供 Carbon Ads 配置来完全禁用 Carbon Ads。

你也可以通过 frontmatter 在特定页面上禁用 Carbon Ads:

yaml
---
carbonAds: false
---

类型定义

ts
export interface CarbonAdsOptions {
  code: string
  placement: string
}

注意事项

请注意,显示广告可能会影响你的网站性能和用户体验。在决定是否使用 Carbon Ads 时,请考虑以下因素:

  • 性能影响:广告脚本可能会增加页面加载时间
  • 用户体验:一些用户可能会觉得广告干扰阅读体验
  • 内容相关性:Carbon Ads 主要面向开发者,确保你的受众匹配

如果你决定使用 Carbon Ads,建议:

  • 监控网站性能指标
  • 收集用户反馈
  • 考虑提供无广告的付费版本或赞助选项

替代方案

如果 Carbon Ads 不适合你的需求,你可以考虑其他选项:

  • GitHub Sponsors:如果你的项目在 GitHub 上
  • Open Collective:用于开源项目的资金管理
  • Patreon:基于订阅的支持平台
  • 自定义赞助页面:直接联系潜在赞助商

你可以使用 VitePress 的布局插槽来添加自定义的赞助或广告内容。

vitepress开发指南