seo-requirements

SEO and GEO Requirements

These are non-negotiable rules for every page on this site. They apply when writing content, creating templates, or asking the AI agent to build or redesign anything.

Every page <head> MUST include

1. Favicon — <link rel="icon" href="/favicon.ico"> (user places favicon.ico in public/)
2. Canonical URL — <link rel="canonical" href="{{ site.base_url }}{{ page.url | default(value='/') }}"> (deduplicates indexed URLs)
3. Open Graph tags — og:type, og:url, og:title, og:description, og:site_name, og:locale
   • og:type = article when page.collection is set; website for the homepage
   • og:image only when page.image is set — must be an absolute URL. Use {% set _abs_image = page.image %}{% if not page.image is starting_with("http") %}{% set _abs_image = site.base_url ~ page.image %}{% endif %} then reference {{ _abs_image }}
   • og:image:width and og:image:height — include 1200 and 630 (standard social preview dimensions)
   • article:published_time — emit when page.collection and page.date are set
   • article:modified_time — emit when page.collection and page.updated are set
4. Twitter Card tags — twitter:card, twitter:title, twitter:description, twitter:image
   • twitter:card = summary_large_image when page.image is set; summary otherwise
   • twitter:image — same absolutization as og:image (use _abs_image variable)
5. JSON-LD structured data — <script type="application/ld+json"> block:
   • BlogPosting for posts (include datePublished, dateModified if page.updated is set)
   • Article for docs and other collection pages
   • WebSite for the homepage/index
   • BreadcrumbList for all collection pages (Home → Collection → Page)
6. Markdown alternate link — <link rel="alternate" type="text/markdown" title="Markdown" href="{{ site.base_url }}{{ page.url }}.md"> (LLM-native differentiator — must include title attribute)
7. llms.txt discovery — <link rel="alternate" type="text/plain" title="LLM Summary" href="/llms.txt">
8. RSS autodiscovery — <link rel="alternate" type="application/rss+xml" ...>
9. Language attribute — <html lang="{{ lang }}"> (already in bundled themes)