This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 03a31a8ddc8 [website](docs) give markdown links a visible colour on
every brand theme; rename the Doris Core link on all-release (#4163)
03a31a8ddc8 is described below
commit 03a31a8ddc8829d2e3832c42be0486ab29e0c2e2
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Mon Sep 21 18:06:10 2026 +0800
[website](docs) give markdown links a visible colour on every brand theme;
rename the Doris Core link on all-release (#4163)
## What
1. **all-release**: the Doris Core row's link now reads "Release Notes"
(EN + zh-CN), matching the other rows.
2. **Markdown link colour**: `.markdown a` already used
`--ifm-color-primary`, but three brand themes (Steel Cyan `#2C2C34`,
Lava & Black `#121212`, Obsidian Gold `#000`) have a near-black primary,
so links on those themes were indistinguishable from body text
(`#1F1F26`) and only revealed themselves by the hover underline.
## How
- `src/scss/_variables.scss`: new `--brand-link` token. Defaults to
`--brand-primary` (no change on Doris Green and the other coloured
themes); the three near-black themes override it with a readable shade
of their accent — Steel Cyan `#007C9E`, Lava `#CC3A00`, Obsidian Gold
`#8A6D00` (all ≥ 4.6:1 on white).
- `src/scss/components/markdown.scss`: links use `--brand-link` at rest
with no underline, underline on hover (`text-underline-offset: 0.15em`).
Inline code wrapped in a link (`[`foo`](...)`) now inherits the link
colour instead of the grey `.markdown code` colour, so those links are
recognisable too.
- The hover rule keeps (0,1,1) specificity via `:where` and takes its
value from Infima's `--ifm-link-hover-decoration`, so `.button`, DocCard
and the page-level card anchors in community-badges /
contribute-to-doris keep opting out of the underline.
- `src/components/getting-started-card/style.scss`: explicit
`text-decoration: none` on hover. The global `a:hover` underline
propagated through the whole card text (pre-existing, e.g. on
install/intro).
## Verified
Dev server + Chrome, four themes (doris / blue / read / yellow-black),
on `/releases/all-release` and a docs page with a code-wrapped link:
rest colour = `--brand-link`, no underline; hover keeps the colour and
underlines; GettingStartedCard hover no longer underlines.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: morningman <[email protected]>
Co-authored-by: Claude Opus 5 (1M context) <[email protected]>
---
.../current/all-release.md | 2 +-
releasenotes/all-release.md | 2 +-
src/components/getting-started-card/style.scss | 3 +++
src/scss/_variables.scss | 7 +++++++
src/scss/components/markdown.scss | 19 ++++++++++++++++++-
5 files changed, 30 insertions(+), 3 deletions(-)
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs-releases/current/all-release.md
b/i18n/zh-CN/docusaurus-plugin-content-docs-releases/current/all-release.md
index d858b35337e..0f3653925ef 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs-releases/current/all-release.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs-releases/current/all-release.md
@@ -12,7 +12,7 @@
| 项目 | 版本发布说明 | 仓库 |
| --- | --- | --- |
-| Doris Core | [Doris Core 版本发布说明](./core.md) |
[apache/doris](https://github.com/apache/doris) |
+| Doris Core | [Release Notes](./core.md) |
[apache/doris](https://github.com/apache/doris) |
| Doris Flink Connector | [Release
Notes](./ecosystem/doris-flink-connector.md) |
[apache/doris-flink-connector](https://github.com/apache/doris-flink-connector)
|
| Doris Spark Connector | [Release
Notes](./ecosystem/doris-spark-connector.md) |
[apache/doris-spark-connector](https://github.com/apache/doris-spark-connector)
|
| Doris Kafka Connector | [Release
Notes](./ecosystem/doris-kafka-connector.md) |
[apache/doris-kafka-connector](https://github.com/apache/doris-kafka-connector)
|
diff --git a/releasenotes/all-release.md b/releasenotes/all-release.md
index 13b8fc56f9f..364364d45b8 100644
--- a/releasenotes/all-release.md
+++ b/releasenotes/all-release.md
@@ -12,7 +12,7 @@ This document presents release notes for Apache Doris Core
and Doris ecosystem p
| Project | Release notes | Repository |
| --- | --- | --- |
-| Doris Core | [Doris Core Release Notes](./core.md) |
[apache/doris](https://github.com/apache/doris) |
+| Doris Core | [Release Notes](./core.md) |
[apache/doris](https://github.com/apache/doris) |
| Doris Flink Connector | [Release
Notes](./ecosystem/doris-flink-connector.md) |
[apache/doris-flink-connector](https://github.com/apache/doris-flink-connector)
|
| Doris Spark Connector | [Release
Notes](./ecosystem/doris-spark-connector.md) |
[apache/doris-spark-connector](https://github.com/apache/doris-spark-connector)
|
| Doris Kafka Connector | [Release
Notes](./ecosystem/doris-kafka-connector.md) |
[apache/doris-kafka-connector](https://github.com/apache/doris-kafka-connector)
|
diff --git a/src/components/getting-started-card/style.scss
b/src/components/getting-started-card/style.scss
index bfd11d51479..60188ddbed6 100644
--- a/src/components/getting-started-card/style.scss
+++ b/src/components/getting-started-card/style.scss
@@ -14,6 +14,9 @@
border-color: var(--ifm-color-primary);
box-shadow: 0 4px 12px rgba(0, 0, 0, 0.08);
transform: translateY(-2px);
+ // the card lifts instead of underlining; without this the global
+ // a:hover underline propagates through the whole card text
+ text-decoration: none;
}
.card-icon {
diff --git a/src/scss/_variables.scss b/src/scss/_variables.scss
index 69fe69407e1..69144969616 100644
--- a/src/scss/_variables.scss
+++ b/src/scss/_variables.scss
@@ -34,6 +34,10 @@
--brand-ink: #0F1A14;
--brand-ink-rgb: 15 26 20;
--brand-ink-soft: #1B2A22;
+ // Prose link colour (docs, blog, release notes). Follows the brand
primary;
+ // themes whose primary is near-black override it below with a readable
+ // shade of their accent, otherwise links are indistinguishable from text.
+ --brand-link: var(--brand-primary);
--ifm-color-primary: var(--brand-primary);
--ifm-color-primary-dark: #2c39d4;
@@ -164,6 +168,7 @@ html[data-brand-theme='blue'] {
--brand-ink: #2C2C34;
--brand-ink-rgb: 44 44 52;
--brand-ink-soft: #3C3C46;
+ --brand-link: #007C9E; // deep Steel Cyan: the primary is near-black
--ifm-color-primary-dark: #27272E;
--ifm-color-primary-darker: #222229;
@@ -207,6 +212,7 @@ html[data-brand-theme='read'] {
--brand-ink: #121212;
--brand-ink-rgb: 18 18 18;
--brand-ink-soft: #282828;
+ --brand-link: #CC3A00; // deep lava: the primary is near-black
--ifm-color-primary-dark: #101010;
--ifm-color-primary-darker: #0D0D0D;
@@ -336,6 +342,7 @@ html[data-brand-theme='yellow-black'] {
--brand-ink: #111111;
--brand-ink-rgb: 17 17 17;
--brand-ink-soft: #292929;
+ --brand-link: #8A6D00; // deep gold: the primary is near-black
--ifm-color-primary-dark: #000000;
--ifm-color-primary-darker: #000000;
diff --git a/src/scss/components/markdown.scss
b/src/scss/components/markdown.scss
index 3e71bbbb1dc..b0852736cd7 100644
--- a/src/scss/components/markdown.scss
+++ b/src/scss/components/markdown.scss
@@ -194,8 +194,25 @@
font-weight: 400;
color: #1F1F26;
}
+ // Links read as links at rest (themed colour) and underline on hover.
+ // The hover rule stays at (0,1,1) via :where and takes its value from
+ // Infima's variable, so block links that opt out of the underline keep
+ // winning: Infima's .button:hover / DocCard's --ifm-link-hover-decoration
+ // and the card anchors styled inside community-badges /
contribute-to-doris.
a {
- color: var(--ifm-color-primary);
+ color: var(--brand-link);
+ text-decoration: none;
+ text-underline-offset: 0.15em;
+
+ &:where(:hover) {
+ text-decoration: var(--ifm-link-hover-decoration, underline);
+ }
+
+ // Inline code inside a link keeps the link colour instead of the grey
+ // `.markdown code` colour, so [`foo`](...) is recognisable too.
+ code {
+ color: inherit;
+ }
}
ul,
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
