SEO: sitemap, canonical URLs, improved titles, JSON-LD, RTD redirects

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: milanofthe

src/lib/components/pages/PackageApi.svelte

@@ -102,8 +102,9 @@
 </script>
 
 <svelte:head>
-	<title>{pkg.name} - API{tag ? ` ${tag}` : ''}</title>
-	<meta name="description" content="{pkg.name} API reference documentation" />
+	<title>{pkg.name} API Reference{tag ? ` ${tag}` : ''} — PathSim Docs</title>
+	<meta name="description" content="{pkg.name} API reference documentation — classes, methods, and parameters." />
+	<link rel="canonical" href="https://docs.pathsim.org/{packageId}/latest/api" />
 </svelte:head>
 
 <Tooltip />

src/lib/components/pages/PackageExamples.svelte

@@ -59,8 +59,9 @@
 </script>
 
 <svelte:head>
-	<title>{pkg.name} - Examples</title>
-	<meta name="description" content="{pkg.name} example notebooks" />
+	<title>{pkg.name} Examples — PathSim Docs</title>
+	<meta name="description" content="Interactive example notebooks for {pkg.name} — tutorials, simulations, and code walkthroughs." />
+	<link rel="canonical" href="https://docs.pathsim.org/{packageId}/latest/examples" />
 </svelte:head>
 
 <Tooltip />

src/lib/components/pages/PackageOverview.svelte

@@ -118,8 +118,9 @@
 </script>
 
 <svelte:head>
-	<title>{pkg.name}</title>
+	<title>{pkg.name} — PathSim Docs</title>
 	<meta name="description" content="{pkg.name} - {pkg.description}" />
+	<link rel="canonical" href="https://docs.pathsim.org/{packageId}" />
 </svelte:head>
 
 <Tooltip />

src/routes/+layout.svelte

@@ -111,6 +111,13 @@
 
 <svelte:head>
 	<link rel="stylesheet" href={CDN.katex.css} />
+	{@html `<script type="application/ld+json">${JSON.stringify({
+		"@context": "https://schema.org",
+		"@type": "WebSite",
+		"url": "https://docs.pathsim.org",
+		"name": "PathSim Documentation",
+		"description": "API reference, examples, and guides for PathSim — a Python framework for simulating dynamical systems using block diagrams."
+	})}</script>`}
 </svelte:head>
 
 <Tooltip />

src/routes/+page.svelte

@@ -79,8 +79,9 @@
 </script>
 
 <svelte:head>
-	<title>PathSim Docs</title>
-	<meta name="description" content="Documentation for PathSim - A Python framework for simulating dynamical systems" />
+	<title>PathSim Documentation — API Reference, Examples & Guides</title>
+	<meta name="description" content="Documentation for PathSim — a Python framework for simulating dynamical systems using block diagrams. API reference, interactive examples, and guides." />
+	<link rel="canonical" href="https://docs.pathsim.org/" />
 </svelte:head>
 
 <Tooltip />

src/routes/[package]/[version]/examples/[slug]/+page.svelte

@@ -71,8 +71,9 @@
 </script>
 
 <svelte:head>
-	<title>{data.meta.title} - Example</title>
+	<title>{data.meta.title} — {data.packageId} Example | PathSim Docs</title>
 	<meta name="description" content={data.meta.description} />
+	<link rel="canonical" href="https://docs.pathsim.org/{data.packageId}/latest/examples/{data.meta.slug}" />
 </svelte:head>
 
 <Tooltip />

src/routes/[package]/roadmap/+page.svelte

@@ -18,8 +18,9 @@
 </script>
 
 <svelte:head>
-	<title>{pkg.name} - Roadmap</title>
-	<meta name="description" content="{pkg.name} development roadmap" />
+	<title>{pkg.name} Roadmap — PathSim Docs</title>
+	<meta name="description" content="{pkg.name} development roadmap — upcoming features and planned improvements." />
+	<link rel="canonical" href="https://docs.pathsim.org/{data.packageId}/roadmap" />
 </svelte:head>
 
 <div class="hero">

static/_redirects

@@ -0,0 +1,5 @@
+# Redirect old ReadTheDocs URLs to new structure
+/en/latest/*  /pathsim/latest/:splat  301
+/en/stable/*  /pathsim/latest/:splat  301
+/en/v:version/*  /pathsim/v:version/:splat  301
+/en/*  /pathsim  301

static/sitemap.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url><loc>https://docs.pathsim.org/</loc><priority>1.0</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/pathsim</loc><priority>0.8</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/pathsim/latest/api</loc><priority>0.9</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/pathsim/latest/examples</loc><priority>0.8</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/pathsim/roadmap</loc><priority>0.5</priority><changefreq>monthly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/chem</loc><priority>0.7</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/chem/latest/api</loc><priority>0.7</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/chem/latest/examples</loc><priority>0.7</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/rf</loc><priority>0.7</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/rf/latest/api</loc><priority>0.7</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/rf/latest/examples</loc><priority>0.7</priority><changefreq>weekly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/vehicle</loc><priority>0.6</priority><changefreq>monthly</changefreq></url>
+  <url><loc>https://docs.pathsim.org/flight</loc><priority>0.6</priority><changefreq>monthly</changefreq></url>
+</urlset>