Skip to content

fix: make documentation page titles distinguishable by section #1607

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Oct 10, 2025
Merged

fix: make documentation page titles distinguishable by section #1607

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
2afebf3
Initial plan
Copilot Oct 10, 2025
bb1687f
Update page titles to be more distinguishable across docs sections
Copilot Oct 10, 2025
b72fa3f
Use get_topic_title helper instead of duplicating logic
Copilot Oct 10, 2025
f552ad4
Move topics logic to shared utils directory
Copilot Oct 10, 2025
917b75a
doing what copilot dont
teemingc Oct 10, 2025
22f0b8b
copilot messed this up
teemingc Oct 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion apps/svelte.dev/src/lib/server/llms.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,9 +66,15 @@ export function generate_llm_content(options: GenerateLlmContentOptions): string
export const topics: Topic[] = [
{ slug: 'svelte', title: 'Svelte' },
{ slug: 'kit', title: 'SvelteKit' },
{ slug: 'cli', title: 'the Svelte CLI' }
{ slug: 'cli', title: 'Svelte CLI' },
{ slug: 'mcp', title: 'Svelte MCP' }
];

export function get_topic_title(slug: string): string {
const topic = topics.find((t) => t.slug === slug);
return topic?.title ?? 'Svelte';
}

export function get_documentation_title(topic: Topic): string {
return `This is the developer documentation for ${topic.title}.`;
}
Expand Down
18 changes: 14 additions & 4 deletions apps/svelte.dev/src/routes/docs/[topic]/[...path]/+page.svelte
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,16 @@
return `https://github.com/sveltejs/${name}/edit/main/documentation/${link}`;
});
// Map topic slug to readable title
const topicTitles: Record<string, string> = {
svelte: 'Svelte',
kit: 'SvelteKit',
cli: 'Svelte CLI',
mcp: 'Svelte MCP'
};
const topicTitle = $derived(topicTitles[page.params.topic] || 'Svelte');
onMount(() => {
// hash was lowercase in v4 docs and varying case in v5 docs
const hash = location.hash.slice(1);
Expand Down Expand Up @@ -58,15 +68,15 @@
</script>

<svelte:head>
<title>{data.document.metadata.title} • Docs • Svelte</title>
<title>{data.document.metadata.title} - {topicTitle}</title>

<meta name="twitter:title" content="{data.document.metadata.title} • Docs • Svelte" />
<meta name="twitter:title" content="{data.document.metadata.title} - {topicTitle}" />
<meta
name="twitter:description"
content="{data.document.metadata.title} • Svelte documentation"
content="{data.document.metadata.title} • {topicTitle} documentation"
/>
<meta name="twitter:card" content="summary_large_image" />
<meta name="description" content="{data.document.metadata.title} • Svelte documentation" />
<meta name="description" content="{data.document.metadata.title} • {topicTitle} documentation" />
<meta
name="twitter:image"
content="https://svelte.dev/docs/{page.params.topic}/{page.params.path}/card.png"
Expand Down