Skip to content

Add Google Analytics to linked-markdown.wazoo.dev #16

Description

@EthanThatOneKid

linked-markdown.wazoo.dev currently has no analytics. Google Analytics needs to be set up for the site.

Current state

  • Repo uses GitHub Pages with .nojekyll\ (Jekyll disabled)
  • Site content is Markdown files served directly (\index.md, \spec/index.md, \community/index.md)
  • No HTML wrapper exists to inject analytics scripts

Options

Option A — Create an HTML index page

Replace \index.md\ with \index.html\ that includes the GTAG snippet and embeds/links to the Markdown content. This is the simplest path but changes the site structure.

Option B — Enable Jekyll with a minimal theme layout

Remove .nojekyll, add a _config.yml\ with a minimal Jekyll theme that has Google Analytics support built in (e.g. \jekyll-theme-minimal).

Option C — Add a custom Jekyll layout

Remove .nojekyll, create a _layouts/default.html\ that includes the GA snippet, and set \layout: default\ in the frontmatter of each .md\ file.

Option D — Build step via GitHub Actions

Add a GitHub Actions workflow that injects the GA snippet into rendered HTML before deploying to Pages. This is the most flexible but adds CI complexity.

Acceptance criteria

  • \linked-markdown.wazoo.dev\ loads Google Analytics
  • Page views are tracked in the GA dashboard
  • Existing content (spec, paper, community pages) remains accessible
  • Custom domain \linked-markdown.wazoo.dev\ continues to work

Measurement ID

A new GA4 property should be created for \linked-markdown.wazoo.dev\ in the Wazoo Google Analytics account, or existing org-wide GA can be reused.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions