docs: SEO enhancements#175
Merged
Merged
Conversation
HennerM
requested review from
MauritsBleeker,
Ndles and
kinggongzilla
as code owners
![claude[bot]](https://avatars.githubusercontent.com/in/1236702?s=60&v=4){kind=small}
There was a problem hiding this comment.
Claude Code Review
This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.
Tip: disable this comment in your organization's Code Review settings.
Contributor
|
All contributors have signed the CLA ✍️ ✅ |
Contributor
|
HennerM
force-pushed
the
claude/seo-sphinx-docs-XN8IH
branch
from
b1c9abb to
57cffe3
Compare
HennerM
changed the title
Adds canonical URLs, sitemap.xml, robots.txt, Open Graph / Twitter card metadata, and per-page description/keywords so crawlers and link unfurlers get rich, correct metadata for noether-docs.emmi.ai. - Wire up sphinx-sitemap + sphinxext-opengraph in the docs dep group - Set html_baseurl (overridable via DOCS_BASEURL env var), html_title, html_short_title, language="en" - Emit per-page <link rel="canonical"> and Open Graph tags (title, type, url, site_name, description, image, image:alt) - Add global twitter:card, twitter:site, robots meta via custom tags - Serve robots.txt with a Sitemap: directive from the site root - Add a .. meta:: description/keywords block on the landing page so the SERP snippet is precise instead of auto-extracted
HennerM
force-pushed
the
claude/seo-sphinx-docs-XN8IH
branch
from
57cffe3 to
5265ead
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds comprehensive SEO (Search Engine Optimization) enhancements to the Noether Framework documentation site, including sitemap generation, Open Graph metadata, Twitter cards, and robots.txt configuration.
Key Changes
sphinx-sitemapandsphinxext-opengraphextensions to generatesitemap.xmland rich metadata for social media link previewshtml_title,html_short_title, andlanguagesettings for improved search engine crawling and accessibilityhtml_baseurl(configurable viaDOCS_BASEURLenvironment variable) to prevent duplicate content penalties and enable proper sitemap generation.. meta::directivesphinx-sitemap>=2.6.0andsphinxext-opengraph>=0.9.1to the docs dependencies in pyproject.tomlImplementation Details
html_baseurlis configurable via theDOCS_BASEURLenvironment variable with a sensible default, allowing flexibility across deployment environmentshttps://claude.ai/code/session_012jSNcmj4bA83zeEHNFB5dL