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</h1><pre>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> </pre><hr/> </body> </html>