Skip to content

docs(seo): PyTorch-Wildlife structured-data + social + self-hosted assets parity#15

Open
rain-Brian wants to merge 3 commits into
mainfrom
seo/pw-infra-structured-data
Open

docs(seo): PyTorch-Wildlife structured-data + social + self-hosted assets parity#15
rain-Brian wants to merge 3 commits into
mainfrom
seo/pw-infra-structured-data

Conversation

@rain-Brian
Copy link
Copy Markdown
Collaborator

Replicates the infra/structured-data SEO pattern merged in microsoft/Biodiversity#653, adapted for PyTorch-Wildlife.

What

  • JSON-LD via theme override (overrides/main.html): SoftwareSourceCode on the homepage, BreadcrumbList on sub-pages. Schema is gated on page.file.src_path so it cannot leak between pages.
  • Open Graph + Twitter Card meta on every page, pointing at a self-hosted summary_large_image share image.
  • Self-hosted favicon/logo (docs/assets/cat.png) replacing the Zenodo-hosted theme chrome.
  • mkdocs-callouts plugin: fixes > [!TIP] blocks that were rendering as literal [!TIP] text, now proper Material admonitions.
  • git-revision-date-localized plugin for last-updated dates, with fetch-depth: 0 added to the deploy workflow checkout so dates resolve from git history.

Keywords

JSON-LD keywords target the framework / model-zoo lane in the cluster keyword-ownership matrix (wildlife AI framework, conservation deep learning framework, wildlife model zoo, camera trap detection, species classification).

Notes

  • No faq page in this repo, so no FAQPage schema is emitted.
  • mkdocs build --strict passes.

Part of ADO Epic 506340 (SEO Phase 1 repo on-page).

Add SoftwareSourceCode JSON-LD (homepage) and BreadcrumbList (sub-pages)
via a theme override, Open Graph and Twitter Card meta with a self-hosted
local share image, and self-hosted favicon/logo (assets/cat.png) replacing
the Zenodo-hosted theme chrome. Adds mkdocs-callouts so > [!TIP] blocks
render as Material admonitions, and git-revision-date-localized for
last-updated dates (with fetch-depth: 0 in the deploy workflow).
…r:image:alt

Point publisher/creator/maintainer at the canonical
https://www.microsoft.com/en-us/ai/ai-for-good#organization Organization @id
so the node is shareable across the cluster. Add inLanguage en to the WebSite
node and a twitter:image:alt meta mirroring og:image:alt. sameAs (GitHub, PyPI,
PW arXiv) unchanged.
@rain-Brian rain-Brian requested a review from zhmiao June 3, 2026 22:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant