You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@skywalking.apache.org by wu...@apache.org on 2026/07/31 00:22:59 UTC
(skywalking-website) 04/05: Single per page, home-page title, and comment cleanup
This is an automated email from the ASF dual-hosted git repository.
wu-sheng pushed a commit to branch seo-foundations
in repository https://gitbox.apache.org/repos/asf/skywalking-website.git
commit 3a4435570df2593ffb4a173d893af5bb76cd3a02
Author: Wu Sheng <wu...@foxmail.com>
AuthorDate: Fri Jul 31 07:54:38 2026 +0800
Single <title> per page, home-page title, and comment cleanup
Every page but the home page carried two <title> tags: partials/head.html emitted
one and all 21 baseof templates repeated the identical expression. Removed from
the baseofs so head.html is the sole owner.
The home page's <title> was "Apache SkyWalking", which wins brand queries and
nothing else, and could not be changed because the IsHome branch printed
.Site.Title unconditionally. It now honours an optional `seo_title` front-matter
key, set only on content/_index.html; every other page keeps
"Page | Apache SkyWalking".
Also:
- The docs BreadcrumbList still named the section "Projects and Docs" after the
nav was renamed to "Documentation".
- Trimmed the comments added across this branch down to the constraints a reader
cannot infer from the code, dropping the narrative ones.
- CLAUDE.md: documented that `Latest` and the newest version entry must share a
commitId (the canonical rule reads it, and BanyanDB drifted for two releases),
plus a section on what layouts/partials/seo/ owns and the rules that are easy
to break — absolute baseURL, single <title>, and content/zh being blog posts
rather than a translated site.
---
CLAUDE.md | 31 ++++++++++++++++++++++
assets/scss/_custom_home.scss | 26 ++++++------------
config.toml | 17 +++++-------
content/_index.html | 12 ++++-----
layouts/blog/baseof.html | 1 -
layouts/contributors/baseof.html | 1 -
layouts/docs/baseof.html | 1 -
layouts/downloads/baseof.html | 1 -
layouts/events/baseof.html | 1 -
layouts/partials/navbar.html | 4 ---
layouts/partials/seo/doc-canonical-map.html | 19 ++++---------
layouts/partials/seo/lang.html | 11 +++-----
layouts/partials/seo/meta.html | 30 +++++++--------------
layouts/partials/seo/schema.html | 21 +++++----------
layouts/projectdoc/baseof.html | 1 -
layouts/tags/baseof.html | 1 -
layouts/team/baseof.html | 1 -
layouts/users/baseof.html | 1 -
layouts/zh/baseof.html | 1 -
layouts/zh/list.html | 4 ---
themes/docsy/layouts/blog/baseof.html | 1 -
themes/docsy/layouts/contributors/baseof.html | 1 -
themes/docsy/layouts/docs/baseof.html | 1 -
themes/docsy/layouts/downloads/baseof.html | 1 -
themes/docsy/layouts/events/baseof.html | 1 -
themes/docsy/layouts/partials/footer.html | 2 --
themes/docsy/layouts/partials/head.html | 3 ++-
.../docsy/layouts/partials/sidebar-skywalking.html | 2 --
themes/docsy/layouts/projectDoc/baseof.html | 1 -
themes/docsy/layouts/swagger/baseof.html | 1 -
themes/docsy/layouts/taxonomy/baseof.html | 1 -
themes/docsy/layouts/team/baseof.html | 1 -
themes/docsy/layouts/users/baseof.html | 1 -
themes/docsy/layouts/zh/baseof.html | 1 -
34 files changed, 76 insertions(+), 127 deletions(-)
diff --git a/CLAUDE.md b/CLAUDE.md
index 9a606de2bca2..0931189abd81 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -71,6 +71,14 @@ When releasing a new version, update the component's `docs` section:
2. **Add new versioned entry**: insert a `v<VERSION>` entry right after `Latest` with the same commitId and link pattern `/docs/<repo-slug>/v<VERSION>/readme/`.
3. **Keep old versions** as-is.
+`Latest` and the newest `v<VERSION>` entry **must carry the same commitId**. Steps 1
+and 2 give that for free, but it is load-bearing beyond cosmetics: those two URL
+trees render the same source, and `layouts/partials/seo/doc-canonical-map.html`
+compares commitIds to decide which versioned pages point `rel=canonical` at
+`/latest/`. If `Latest` drifts, the duplicate pair silently competes in search and
+`/latest/` serves stale docs — BanyanDB sat on the v0.10.1 commit through two
+releases this way.
+
### Docs entry types
Components use two styles in docs.yml:
- **Hugo-hosted docs** (have `repoUrl`): use `/docs/<repo-slug>/<version>/readme/` links with `commitId`. These have `Next`, `Latest`, and versioned entries.
@@ -83,3 +91,26 @@ TAG_SHA=$(gh api repos/apache/<repo>/git/ref/tags/v<VERSION> --jq '.object.sha')
# Dereference annotated tag to actual commit
COMMIT_SHA=$(gh api repos/apache/<repo>/git/tags/$TAG_SHA --jq '.object.sha')
```
+
+## SEO metadata
+
+`layouts/partials/seo/` owns every search-facing tag; it is wired in once through
+`layouts/partials/hooks/head-end.html`, so the theme stays unforked.
+
+- `meta.html` — `rel=canonical`, `<meta name="description">`, en/zh `hreflang`
+- `doc-canonical-map.html` — the commitId rule described above
+- `schema.html` — JSON-LD (Organization, SoftwareApplication, BlogPosting, TechArticle, BreadcrumbList)
+- `lang.html` — the `<html lang>` value, derived from the URL because `content/zh`
+ is a section rather than a Hugo language
+
+Rules that are easy to break:
+
+- **`baseURL` in config.toml must stay absolute.** Sitemap `<loc>`, `og:url` and
+ canonical all derive from it, and the sitemaps.org spec rejects relative `<loc>`.
+- **`<title>` is emitted only by `themes/docsy/layouts/partials/head.html`.** Every
+ `baseof.html` used to repeat it, giving each page two. Do not add it back.
+- **`content/zh` holds Chinese blog posts only** — not a translated site. Adding a
+ `[languages]` block would restructure those URLs and strand the `layouts/zh/`
+ templates, for no gain.
+- The home page's `<title>` comes from `seo_title` in `content/_index.html` front
+ matter; every other page uses `Page | Apache SkyWalking`.
diff --git a/assets/scss/_custom_home.scss b/assets/scss/_custom_home.scss
index 20212368fd07..0997cfdad455 100644
--- a/assets/scss/_custom_home.scss
+++ b/assets/scss/_custom_home.scss
@@ -161,10 +161,9 @@ $brand-grad: linear-gradient(180deg, #479EEB 0%, #3788D0 100%);
font-size: 46px; line-height: 1.1; font-weight: 800; color: $ink;
letter-spacing: -1.1px; margin: 0 0 16px; border: 0; padding: 0;
.accent {
- // Keep "cloud-native and AI" whole: left to wrap freely it either
- // strands "and AI" on its own line or breaks at the hyphen in
- // "cloud-native". Forcing it to one unit moves the break to the
- // phrase boundary after "for".
+ // Keeps "cloud-native and AI" whole. Left to wrap it either strands
+ // "and AI" alone or, under text-wrap: balance, splits "cloud-native"
+ // at the hyphen.
white-space: nowrap;
background: linear-gradient(120deg, #3788D0, #E7136C 120%);
-webkit-background-clip: text; background-clip: text; -webkit-text-fill-color: transparent;
@@ -199,9 +198,7 @@ $brand-grad: linear-gradient(180deg, #479EEB 0%, #3788D0 100%);
// ---------- CAPABILITIES ----------
.cap-grid {
- // Five pillars (GenAI joined in 10.4) plus a CTA tile fill a 3x2 grid
- // exactly — no orphan card, and the sixth slot earns an internal link
- // to /docs/ instead of sitting empty.
+ // Five pillars plus the CTA tile fill 3x2 exactly, leaving no orphan card.
display: grid; grid-template-columns: repeat(3, 1fr); gap: 20px;
}
.cap-card {
@@ -226,11 +223,9 @@ $brand-grad: linear-gradient(180deg, #479EEB 0%, #3788D0 100%);
&.metrics { background: #e2f1fd; color: #1d6fb8; }
&.logging { background: #f0e7fd; color: #7c3aed; }
&.profiling { background: #def5e7; color: #11814b; }
- // Matches the AI topic colour in data/blog_topics.yml and the AI eco-card.
- &.genai { background: #fde8f3; color: #be2069; }
+ &.genai { background: #fde8f3; color: #be2069; } // data/blog_topics.yml
}
- // Sixth tile: a link, not a pillar — dashed and tinted so it reads as an
- // invitation rather than a fifth-and-a-half capability.
+ // Dashed and tinted so it reads as a link, not a sixth capability.
.cap-card--cta {
text-decoration: none;
border-style: dashed;
@@ -893,8 +888,6 @@ $brand-grad: linear-gradient(180deg, #479EEB 0%, #3788D0 100%);
p { font-size: 16px; color: $body; line-height: 1.6; margin: 0; max-width: 660px; }
}
- // Definitional block above the Chinese article list — the site's only
- // Chinese-language explanation of what SkyWalking is.
.zh-intro {
padding: 26px 0 4px;
.container { max-width: 1200px; }
@@ -1580,11 +1573,8 @@ $brand-grad: linear-gradient(180deg, #479EEB 0%, #3788D0 100%);
.map3d-play-label { font-size: 13px; }
}
-// =====================================================================
-// Footer: community links without an iconfont glyph (B站, 掘金) render as
-// their name. Size them to sit on the same baseline as the icon links,
-// which carry Bootstrap's .h3.
-// =====================================================================
+// Footer links with no iconfont glyph render as text; align them to the
+// baseline of the icon links, which carry Bootstrap's .h3.
.footer-link-text {
font-size: 15px;
font-weight: 600;
diff --git a/config.toml b/config.toml
index 28306fdc06fd..6c093706355c 100644
--- a/config.toml
+++ b/config.toml
@@ -1,6 +1,5 @@
-# Must be the absolute production URL: Hugo derives <loc> in sitemap.xml, og:url,
-# rel=canonical and the RSS links from it. A relative baseURL emits relative
-# <loc> values, which the sitemaps.org spec rejects outright.
+# Must stay absolute: sitemap <loc>, og:url and rel=canonical derive from it,
+# and the sitemaps.org spec rejects relative <loc>.
baseURL = "https://skywalking.apache.org/"
title = "Apache SkyWalking"
@@ -142,8 +141,7 @@ time_format_blog = "Jan 2, 2006"
weight = 1
[[menu.main]]
- # Keep in step with content/docs/_index.md's title and the mobile sidebar —
- # the same destination used to carry four different names.
+ # Keep in step with content/docs/_index.md and the mobile sidebar.
name = "Documentation"
weight = 10
url = "/docs"
@@ -252,10 +250,8 @@ weight = 1
desc = "Follow us on Twitter to get the latest news!"
[[params.links.user]]
name ="Slack"
- # Same destination as the home page's Slack card. The old
- # http://s.apache.org/slack-invite redirects to infra.apache.org/slack.html,
- # which only offers self-signup to @apache.org addresses — a dead end for
- # everyone else. Email is the only route that actually yields an invite.
+ # Not s.apache.org/slack-invite: it only self-signs-up @apache.org addresses.
+ # Must match the home page's Slack card.
url = "mailto:dev@skywalking.apache.org?subject=Request%20to%20join%20SkyWalking%20Slack"
icon = "iconfont icon-slack"
desc = "Ask the dev mailing list for a Slack invite"
@@ -271,8 +267,7 @@ weight = 1
url = "https://github.com/apache/skywalking"
icon = "iconfont icon-github"
desc = "Development takes place here!"
-# Chinese third-party platforms. No iconfont glyph exists for either, so the
-# footer renders these by name — see partials/footer.html.
+# No iconfont glyph for these two, so footer.html falls back to the name.
[[params.links.user]]
name = "B站"
url = "https://space.bilibili.com/390683219"
diff --git a/content/_index.html b/content/_index.html
index 3e35c392cba1..2eb82dfbbd7e 100644
--- a/content/_index.html
+++ b/content/_index.html
@@ -1,9 +1,10 @@
+++
title = "Apache SkyWalking"
linkTitle = "Apache SkyWalking"
-# Without an explicit description Hugo's internal opengraph/twitter templates fall
-# back to .Summary, which on this page scrapes the hero SVG ("· APACHE SOFTWARE
-# FOUNDATION · OPEN SOURCE · ...") into every social card and search snippet.
+# Overrides the <title> tag on this page only.
+seo_title = "Apache SkyWalking — Observability for cloud-native and AI"
+# Required: without it Hugo's opengraph template falls back to .Summary, which
+# scrapes the hero SVG text into every social card.
description = "Apache SkyWalking is an open source observability platform for cloud native architectures. It brings distributed tracing, metrics, logs, profiling and alarms into one platform, with auto-instrumentation agents for Java, Go, Python, Node.js, PHP, Rust, Ruby and .NET, plus eBPF on Kubernetes. It also monitors GenAI and LLM services — latency, token usage and estimated cost per provider and model — and ships a built-in assistant that investigates incidents in natural language."
+++
@@ -293,10 +294,7 @@ description = "Apache SkyWalking is an open source observability platform for cl
<p>Open a discussion or file an issue on GitHub — feature requests, questions and bug reports all welcome.</p>
<span class="cc-more">GitHub Discussions →</span>
</a>
- <!-- mailto, not http://s.apache.org/slack-invite: that redirects to
- infra.apache.org/slack.html, which only offers self-signup to
- @apache.org addresses. Kept in step with the Slack entry in
- config.toml's [params.links.user], which the footer renders. -->
+ <!-- Keep in step with the Slack entry in config.toml [params.links.user]. -->
<a class="community-card" href="mailto:dev@skywalking.apache.org?subject=Request%20to%20join%20SkyWalking%20Slack">
<span class="cc-ic"><i class="iconfont icon-slack"></i></span>
<h4>Join our Slack</h4>
diff --git a/layouts/blog/baseof.html b/layouts/blog/baseof.html
index f67505d96085..c024fcd4d0f6 100644
--- a/layouts/blog/baseof.html
+++ b/layouts/blog/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
{{ partial "blog-topic-styles.html" . }}
</head>
<body class="td-{{ .Kind }} td-blog">
diff --git a/layouts/contributors/baseof.html b/layouts/contributors/baseof.html
index b54cae85e3eb..979e630115b6 100644
--- a/layouts/contributors/baseof.html
+++ b/layouts/contributors/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-contributors">
<header>
diff --git a/layouts/docs/baseof.html b/layouts/docs/baseof.html
index 36b314c4eb18..1bc363d3b451 100644
--- a/layouts/docs/baseof.html
+++ b/layouts/docs/baseof.html
@@ -3,7 +3,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js td-docs">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-docs-landing">
<header>{{ partial "navbar.html" . }}</header>
diff --git a/layouts/downloads/baseof.html b/layouts/downloads/baseof.html
index 2c428755c157..2a298820329e 100644
--- a/layouts/downloads/baseof.html
+++ b/layouts/downloads/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-downloads">
<header>
diff --git a/layouts/events/baseof.html b/layouts/events/baseof.html
index 68b244c9c6a5..5075ff7abf33 100644
--- a/layouts/events/baseof.html
+++ b/layouts/events/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-events">
<header>
diff --git a/layouts/partials/navbar.html b/layouts/partials/navbar.html
index 8465a2bf6ed3..6973b991db4c 100644
--- a/layouts/partials/navbar.html
+++ b/layouts/partials/navbar.html
@@ -25,10 +25,6 @@
</li>
{{ end }}
{{ end }}
- {{- /* Chinese blog: a direct link to /zh/, the only on-site destination
- this menu ever had. The B站 and 掘金 accounts that used to share
- the dropdown are third-party presence, not our content, and now
- sit in the footer next to Twitter and Slack. */ -}}
{{ $zhActive := or (eq $sec "zh") (eq $sec "zh_tags") }}
<li class="nav-item mr-3 mb-lg-0">
<a class="nav-link{{ if $zhActive }} active{{ end }}" href="/zh/"><span{{ if $zhActive }} class="active"{{ end }}>中文博客</span></a>
diff --git a/layouts/partials/seo/doc-canonical-map.html b/layouts/partials/seo/doc-canonical-map.html
index a93728c019d3..64b979d8cc3d 100644
--- a/layouts/partials/seo/doc-canonical-map.html
+++ b/layouts/partials/seo/doc-canonical-map.html
@@ -1,17 +1,8 @@
-{{- /* Returns a slice of {from, to} URL-prefix pairs for versioned docs that are
- an exact re-rendering of the `latest` alias.
-
- docs.js builds one URL tree per entry in data/docs.yml, so `Latest` and the
- newest tagged version are rendered twice from the *same* commitId — e.g.
- /docs/main/latest/ and /docs/main/v10.4.0/ have identical article bodies and
- differ only in nav hrefs and the version <select>. Both URLs stay live and
- served; the tagged one just points rel=canonical at /latest/ so the pair
- stops competing in search results.
-
- This is keyed on commitId equality, so it corrects itself at every release:
- once `Latest` advances to a new commit, the old tag no longer matches and
- falls back to self-canonical. Genuinely older versions never appear here —
- they self-canonicalise and remain independently indexable. */ -}}
+{{- /* {from, to} URL-prefix pairs for versioned doc trees that render the same
+ commitId as `Latest` — e.g. /docs/main/v10.4.0/ and /docs/main/latest/ are
+ the same document at two URLs, so the tagged one canonicalises to /latest/.
+ Keyed on commitId, so it self-corrects at each release; older versions never
+ match and stay self-canonical. Every URL remains served either way. */ -}}
{{- $pairs := slice -}}
{{- range $group := site.Data.docs -}}
{{- with $group.list -}}
diff --git a/layouts/partials/seo/lang.html b/layouts/partials/seo/lang.html
index 873663c59d6d..1b34aa656d6c 100644
--- a/layouts/partials/seo/lang.html
+++ b/layouts/partials/seo/lang.html
@@ -1,11 +1,6 @@
-{{- /* Returns the BCP-47 language tag for the current page.
-
- The site is configured as a single Hugo language (English), so every
- baseof template that writes `lang="{{ .Site.Language.Lang }}"` emits
- lang="en" — including the Chinese posts under content/zh and their
- zh_tags taxonomy. Search engines (Baidu especially) use that attribute
- to decide what language a document is in, so derive it from the URL
- instead until/unless the site moves to a real [languages] config. */ -}}
+{{- /* BCP-47 tag for the page. content/zh holds Chinese posts but the site is a
+ single Hugo language, so .Site.Language.Lang reports "en" for them too;
+ derive it from the URL instead. */ -}}
{{- $lang := site.Language.Lang -}}
{{- if or (hasPrefix .RelPermalink "/zh/") (hasPrefix .RelPermalink "/zh_tags/") -}}
{{- $lang = "zh-CN" -}}
diff --git a/layouts/partials/seo/meta.html b/layouts/partials/seo/meta.html
index dd61a77b373c..5fdee3c6c490 100644
--- a/layouts/partials/seo/meta.html
+++ b/layouts/partials/seo/meta.html
@@ -1,10 +1,7 @@
{{- $path := .RelPermalink -}}
{{- $lang := partial "seo/lang.html" . -}}
-{{- /* --- rel=canonical -------------------------------------------------------
- Self-canonical everywhere, except versioned doc trees that are a duplicate
- rendering of /latest/ (see seo/doc-canonical-map.html), which point at the
- /latest/ equivalent of the same page. */ -}}
+{{- /* Self-canonical, except doc versions that duplicate /latest/. */ -}}
{{- $canonical := .Permalink -}}
{{- range $p := partialCached "seo/doc-canonical-map.html" . -}}
{{- if hasPrefix $path $p.from -}}
@@ -13,12 +10,8 @@
{{- end -}}
<link rel="canonical" href="{{ $canonical }}">
-{{- /* --- meta description ----------------------------------------------------
- Hugo's internal opengraph template already emits og:description, but no
- plain <meta name="description"> was ever rendered. Only emit one when the
- page has a real description or usable prose — a duplicated boilerplate
- description across 4k doc pages is worse than letting Google build its own
- snippet from the content. */ -}}
+{{- /* Omitted when there is nothing page-specific to say: one boilerplate
+ description repeated across 4k doc pages is worse than none. */ -}}
{{- $desc := default "" .Params.description -}}
{{- if and (eq $desc "") (not .IsHome) .Content -}}
{{- $desc = .Summary | plainify | htmlUnescape | chomp -}}
@@ -28,10 +21,8 @@
<meta name="description" content="{{ . }}">
{{- end }}
-{{- /* --- hreflang ------------------------------------------------------------
- content/zh holds Chinese translations of ~half the posts in content/blog,
- matched by identical slug. Emit reciprocal alternates only when both pages
- actually exist, so an unpaired post never claims a translation it lacks. */ -}}
+{{- /* Reciprocal alternates only where both slugs exist, so an unpaired post
+ never claims a translation it lacks. */ -}}
{{- $en := "" -}}
{{- $zh := "" -}}
{{- if hasPrefix $path "/blog/" -}}
@@ -53,10 +44,7 @@
<link rel="alternate" hreflang="x-default" href="{{ $en | absURL }}">
{{- end }}
-{{- /* Note: og:locale is emitted by Hugo's _internal/opengraph.html and is always
- the site language ("en"), including on the Chinese pages. _internal
- templates cannot be overridden, and a second og:locale here would just be a
- conflicting duplicate — the first one wins in every parser. <html lang> and
- the hreflang pair above are the signals search engines actually use, so this
- is left alone; fixing it would mean replacing the internal OpenGraph call in
- themes/docsy/layouts/partials/head.html with a local partial. */ -}}
+{{- /* og:locale still reports "en" on Chinese pages: it comes from
+ _internal/opengraph.html, which cannot be overridden, and a second tag here
+ would only be a conflicting duplicate. Fixing it means replacing that
+ template call in head.html. */ -}}
diff --git a/layouts/partials/seo/schema.html b/layouts/partials/seo/schema.html
index 7e6c72e3f049..9476332c9ccd 100644
--- a/layouts/partials/seo/schema.html
+++ b/layouts/partials/seo/schema.html
@@ -1,10 +1,6 @@
-{{- /* JSON-LD structured data.
-
- Hugo's internal _internal/schema.html only emits a handful of bare itemprop
- attributes, which neither Google's rich results nor LLM retrievers make much
- use of. Emit real JSON-LD instead: Organization/SoftwareApplication on the
- home page, BlogPosting on posts and release events, TechArticle plus a
- BreadcrumbList on documentation pages. */ -}}
+{{- /* JSON-LD, which _internal/schema.html does not emit: Organization and
+ SoftwareApplication on the home page, BlogPosting on posts, TechArticle
+ plus BreadcrumbList on docs. */ -}}
{{- $lang := partial "seo/lang.html" . -}}
{{- $org := dict
@@ -24,15 +20,12 @@
-}}
{{- $publisher := dict "@id" (absURL "#organization") -}}
-{{- /* The Organization node is repeated in every page's @graph rather than only on
- the home page: a bare "@id" reference to a node defined on a *different*
- document is technically legal JSON-LD but consumers do not dereference it, so
- publisher/author would resolve to nothing. */ -}}
+{{- /* Organization is repeated on every page: consumers do not dereference an
+ @id defined on another document, so publisher would resolve to nothing. */ -}}
{{- $nodes := slice -}}
{{- if .IsHome -}}
- {{- /* Latest SkyWalking APM version, read defensively from data/releases.yml so a
- reshuffle of that file can never fail the build. */ -}}
+ {{- /* Guarded so a reshuffle of data/releases.yml cannot fail the build. */ -}}
{{- $version := "" -}}
{{- with site.Data.releases -}}
{{- with index . 0 -}}
@@ -104,7 +97,7 @@
"@type" "BreadcrumbList"
"itemListElement" (slice
(dict "@type" "ListItem" "position" 1 "name" site.Title "item" (absURL ""))
- (dict "@type" "ListItem" "position" 2 "name" "Projects and Docs" "item" (absURL "docs/"))
+ (dict "@type" "ListItem" "position" 2 "name" "Documentation" "item" (absURL "docs/"))
(dict "@type" "ListItem" "position" 3 "name" .Title "item" .Permalink))) -}}
{{- end -}}
{{- end -}}
diff --git a/layouts/projectdoc/baseof.html b/layouts/projectdoc/baseof.html
index 2fccb1d25f0f..b3ced6aaba45 100644
--- a/layouts/projectdoc/baseof.html
+++ b/layouts/projectdoc/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} project-doc">
<header>
diff --git a/layouts/tags/baseof.html b/layouts/tags/baseof.html
index f59e5a32e126..ccb0735043c5 100644
--- a/layouts/tags/baseof.html
+++ b/layouts/tags/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}</title>
{{ partial "blog-topic-styles.html" . }}
</head>
<body class="td-{{ .Kind }} td-blog">
diff --git a/layouts/team/baseof.html b/layouts/team/baseof.html
index da28a531ae1c..74c94849e443 100644
--- a/layouts/team/baseof.html
+++ b/layouts/team/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-team">
<header>
diff --git a/layouts/users/baseof.html b/layouts/users/baseof.html
index ecd09670b778..621654bb9b16 100644
--- a/layouts/users/baseof.html
+++ b/layouts/users/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-users">
<header>
diff --git a/layouts/zh/baseof.html b/layouts/zh/baseof.html
index 5a98c3a863ce..811bb3ca66b8 100644
--- a/layouts/zh/baseof.html
+++ b/layouts/zh/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
{{ partial "blog-topic-styles.html" . }}
</head>
<body class="td-{{ .Kind }} td-blog">
diff --git a/layouts/zh/list.html b/layouts/zh/list.html
index d533ae4c0b40..9c622e39824e 100644
--- a/layouts/zh/list.html
+++ b/layouts/zh/list.html
@@ -17,10 +17,6 @@
</div>
</section>
-{{- /* Definitional block. The site had no Chinese page explaining what SkyWalking
- actually is — every /zh/ article covers a specific topic — so Chinese search
- and Chinese AI assistants had nothing authoritative on this domain to quote
- for 「SkyWalking 是什么」. The article list below is unchanged. */ -}}
<section class="zh-intro">
<div class="container">
<p class="zh-intro-lede"><strong>Apache SkyWalking 是一个开源的云原生可观测性平台</strong>,把分布式追踪、指标、日志、性能剖析和告警收在同一套数据模型里做关联分析,而不是各看各的。</p>
diff --git a/themes/docsy/layouts/blog/baseof.html b/themes/docsy/layouts/blog/baseof.html
index b6db5a95c9bb..ebcb862e0f48 100644
--- a/themes/docsy/layouts/blog/baseof.html
+++ b/themes/docsy/layouts/blog/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-blog">
<header>
diff --git a/themes/docsy/layouts/contributors/baseof.html b/themes/docsy/layouts/contributors/baseof.html
index 45f9b30b04cf..106b0d0ef636 100644
--- a/themes/docsy/layouts/contributors/baseof.html
+++ b/themes/docsy/layouts/contributors/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }}">
<header>
diff --git a/themes/docsy/layouts/docs/baseof.html b/themes/docsy/layouts/docs/baseof.html
index 2b1b76bc309a..b2c36c964602 100644
--- a/themes/docsy/layouts/docs/baseof.html
+++ b/themes/docsy/layouts/docs/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js td-docs">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
<script async src="/js/github-buttons.js"></script>
</head>
<body class="td-{{ .Kind }}">
diff --git a/themes/docsy/layouts/downloads/baseof.html b/themes/docsy/layouts/downloads/baseof.html
index 0f6f15f16aa7..4b2555369d9c 100644
--- a/themes/docsy/layouts/downloads/baseof.html
+++ b/themes/docsy/layouts/downloads/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-docs td-downloads">
<header>
diff --git a/themes/docsy/layouts/events/baseof.html b/themes/docsy/layouts/events/baseof.html
index b5af34091a92..3c4c26418e9b 100644
--- a/themes/docsy/layouts/events/baseof.html
+++ b/themes/docsy/layouts/events/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }}">
<header>
diff --git a/themes/docsy/layouts/partials/footer.html b/themes/docsy/layouts/partials/footer.html
index 6ffcf6645157..1dcb3502b019 100644
--- a/themes/docsy/layouts/partials/footer.html
+++ b/themes/docsy/layouts/partials/footer.html
@@ -30,8 +30,6 @@
{{- if $link.icon -}}
<i class="{{ $link.icon }}"></i>
{{- else -}}
- {{- /* Links with no iconfont glyph (B站, 掘金) render as their name instead
- of an empty <i>, so they are visible at all. */ -}}
{{ $link.name }}
{{- end -}}
</a>
diff --git a/themes/docsy/layouts/partials/head.html b/themes/docsy/layouts/partials/head.html
index 5200dfc7486d..c65f268daa02 100644
--- a/themes/docsy/layouts/partials/head.html
+++ b/themes/docsy/layouts/partials/head.html
@@ -12,7 +12,8 @@
<link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink | relURL }}">
{{ end -}}
{{ partialCached "favicons.html" . }}
-<title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
+{{- /* The site's only <title>; do not re-add one to a baseof template. */ -}}
+<title>{{ if .IsHome }}{{ with .Params.seo_title }}{{ . }}{{ else }}{{ .Site.Title }}{{ end }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
{{- template "_internal/opengraph.html" . -}}
{{- template "_internal/schema.html" . -}}
{{- template "_internal/twitter_cards.html" . -}}
diff --git a/themes/docsy/layouts/partials/sidebar-skywalking.html b/themes/docsy/layouts/partials/sidebar-skywalking.html
index fb955429ce1f..9902670dbd8f 100644
--- a/themes/docsy/layouts/partials/sidebar-skywalking.html
+++ b/themes/docsy/layouts/partials/sidebar-skywalking.html
@@ -8,8 +8,6 @@
<div class="nav-item"><a href="/downloads/" class="nav-link{{ if eq $sec "downloads" }} router-link-active{{ end }}">Downloads</a></div>
<div class="nav-item"><a href="/team/" class="nav-link{{ if eq $sec "team" }} router-link-active{{ end }}">Team</a></div>
<div class="nav-item"><a href="/users/" class="nav-link{{ if eq $sec "users" }} router-link-active{{ end }}">Users</a></div>
- {{- /* Mirrors the desktop navbar: a direct link to the on-site Chinese blog.
- B站 and 掘金 are third-party accounts and live in the footer now. */ -}}
<div class="nav-item"><a href="/zh/" class="nav-link{{ if or (eq $sec "zh") (eq $sec "zh_tags") }} router-link-active{{ end }}">中文博客</a></div>
<div class="nav-item">
<div class="dropdown-wrapper open">
diff --git a/themes/docsy/layouts/projectDoc/baseof.html b/themes/docsy/layouts/projectDoc/baseof.html
index 57cf4a435ab7..ede2ea2f4eac 100644
--- a/themes/docsy/layouts/projectDoc/baseof.html
+++ b/themes/docsy/layouts/projectDoc/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} project-doc">
<header>
diff --git a/themes/docsy/layouts/swagger/baseof.html b/themes/docsy/layouts/swagger/baseof.html
index 70ca42452213..81008bfdd441 100644
--- a/themes/docsy/layouts/swagger/baseof.html
+++ b/themes/docsy/layouts/swagger/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
<link rel="stylesheet" type="text/css" href="/css/swagger-ui.css">
</head>
<body class="td-{{ .Kind }}">
diff --git a/themes/docsy/layouts/taxonomy/baseof.html b/themes/docsy/layouts/taxonomy/baseof.html
index 0548c6ecd644..62539563d7e5 100644
--- a/themes/docsy/layouts/taxonomy/baseof.html
+++ b/themes/docsy/layouts/taxonomy/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} tags-list">
<header>
diff --git a/themes/docsy/layouts/team/baseof.html b/themes/docsy/layouts/team/baseof.html
index 3813e68eb3c3..2e850db2d9da 100644
--- a/themes/docsy/layouts/team/baseof.html
+++ b/themes/docsy/layouts/team/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }}">
<header>
diff --git a/themes/docsy/layouts/users/baseof.html b/themes/docsy/layouts/users/baseof.html
index ca821407ce64..564de4dd0625 100644
--- a/themes/docsy/layouts/users/baseof.html
+++ b/themes/docsy/layouts/users/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }}">
<header>
diff --git a/themes/docsy/layouts/zh/baseof.html b/themes/docsy/layouts/zh/baseof.html
index e83be393626c..f42656a50c20 100644
--- a/themes/docsy/layouts/zh/baseof.html
+++ b/themes/docsy/layouts/zh/baseof.html
@@ -2,7 +2,6 @@
<html lang="{{ partial "seo/lang.html" . }}" class="no-js">
<head>
{{ partial "head.html" . }}
- <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{ . }} | {{ end }}{{ .Site.Title }}{{ end }}</title>
</head>
<body class="td-{{ .Kind }} td-blog">
<header>