分析和使用服务#

该主题通过 analytics 选项支持多种网络分析服务。它通过传递包含选项的字典进行配置。有关您要使用的分析提供商的相关选项,请参阅以下部分。

html_theme_options = {
    # See below for options for each service
    "analytics": analytics_options,
}

一般来说,我们推荐使用 Plausible 而不是 Google Analytics,因为它在用户安全和隐私方面拥有更好的故事。此外,它更加开源和透明。事实上,您可以自托管 Plausible 服务器.

scientific-python.org 上获取自托管的 Plausible 服务器

如果您的文档是 SciPy / PyData 生态系统中的一部分,他们可能能够在 https://views.scientific-python.org/<your-package> 上为您托管 Plausible 服务器。要询问此事,请在您选择的社交媒体平台上与他们联系,并在 scientific-python.org 上了解更多信息。

Plausible 分析#

plausible.io 可用于收集网站的简单且注重隐私的分析。要配置,您需要提供两件事

  • 指向由您的 Plausible 服务器提供的 JavaScript 分析脚本的 URL

  • 反映您的文档所在位置的域

Plausible 的 JavaScript 将包含在所有 HTML 页面中以收集指标。包含分析结果的仪表板将在 https://<plausible-url>/<my-domain> 上可用。

html_theme_options["analytics"] = {
    # The domain you'd like to use for this analytics instance
    "plausible_analytics_domain": "my-domain",
    # The analytics script that is served by Plausible
    "plausible_analytics_url": "https://.../script.js",
}

另请参阅

有关此脚本的更多信息,请参阅 Plausible 文档.

Google Analytics#

如果指定了 google_analytics_id 配置选项(如 G-XXXXXXXXXX),则 Google Analytics 的 JavaScript 将包含在 HTML 页面中。

html_theme_options["analytics"] = {
    "google_analytics_id": "G-XXXXXXXXXX",
}