这个项目能做什么

publii-goatcounter-analytics-plugin 是 [Publii](https://getpublii.com/)（一款开源静态网站生成器和内容管理系统）的插件。它允许网站所有者在其发布的网站中嵌入 [GoatCounter](https://www.goatcounter.com) 分析工具和可选的访问者计数器，同时不影响用户隐私。 ## 功能特性 - 将 GoatCounter 跟踪代码简单集成到 Publii 生成的网站中。 - 可选的访问者计数器展示，提供多种格式选项：HTML、SVG 和 PNG。 - 使用 CSS 选择器自定义计数器位置（默认为 `footer`）。 - 可选择移除计数器中的 "by GoatCounter" 品牌文本。 - 支持预览模式，在正式发布前测试分析数据。 ## 安装配置 要配置该插件： 1. **输入 GoatCounter 端点**：将您的 GoatCounter 端点 URL 复制到 Publii 中的插件配置字段。 2. **导航到插件设置**：在 Publii 中，进入站点设置，在插件部分找到 GoatCounter Integration 插件。 3. **输入 GoatCounter 代码**：将您的 GoatCounter 分析代码粘贴到提供的字段中以链接您的网站。 4. **预览模式**：可选项，启用预览模式下的分析输出以便测试。正式上线前请禁用，以防止数据偏差。 ## 访问者计数器 要在您的网站上显示访问者计数器： 1. **启用计数器**：在插件设置中勾选"显示访问者计数器"选项。您还必须在 GoatCounter 站点设置面板中启用"Allow adding visitor counts on your website"，默认是关闭的。 2. **设置 CSS 选择器**：指定将追加计数器的父元素 CSS 选择器（默认为 `footer`）。 3. **选择计数器类型**：选择 HTML、SVG 或 PNG 格式。 4. **移除品牌标识**：可选择隐藏 "by GoatCounter" 归属文本。 ## 自定义样式 根据所选的计数器类型，可进行 CSS 自定义： - **HTML 计数器**：样式化的外层 `div` 和内嵌元素。 - **SVG 计数器**：通过 CSS 自定义 `#gcvc-border`、`#gcvc-for`、`#gcvc-views` 和 `#gcvc-by` 等元素。 有关详细样式指南，请参阅 [GoatCounter 文档](https://www.goatcounter.com/help/visitor-counter)。 ## GDPR 合规 本插件不处理 GDPR 同意事项，因为 GoatCounter 通常被视为无需显式同意通知即可合规。详情请参见 [GDPR 同意通知](https://www.goatcounter.com/help/gdpr)。 ## 许可证 MIT 许可证。欢迎通过拉取请求或 GitHub Issues 提交贡献。