[204_30] 修复欢迎文档的版本号部分在深色模式下的颜色问题 (#3087)

Author: MoonL79

TeXmacs/doc/about/mogan/stem.en.tmu

@@ -51,9 +51,9 @@
     <item>Mogan STEM is the community edition of <hlink|Liii STEM|https://liiistem.cn/docs/about-what-is-liiistem.html?from=app>, permanently free and open source. If you wish to support us, please consider purchasing Liii STEM.
   </enumerate-numeric>
 
-  <with|framed-color|pastel magenta|ornament-border|0ln|ornament-color|pastel yellow|<\ornamented>
+  <\version-notice>
     You are using <strong|v<Xmacs-version>>. The current latest stable version is <strong|v<include|https://liiistem.cn/mogan_latest_version.tm>>. Visit the official website <hlink|https://mogan.app|https://mogan.app/en/?from=app> to download the latest stable version.
-  </ornamented>>
+  </version-notice>
 
   <section*|Example Documents: What can I do with Mogan STEM?>
 

TeXmacs/doc/about/mogan/stem.zh.tmu

@@ -45,9 +45,9 @@
     <item>Mogan STEM是<hlink|Liii STEM|https://liiistem.cn/docs/about-what-is-liiistem.html?from=app>的社区版，永久免费且开源，如果您想支持我们，欢迎购买Liii STEM。
   </enumerate-numeric>
 
-  <with|framed-color|pastel magenta|ornament-border|0ln|ornament-color|pastel yellow|<\ornamented>
+  <\version-notice>
     您正在使用<strong|v<Xmacs-version>>，当前最新稳定版是<strong|v<include|https://liiistem.cn/mogan_latest_version.tm>>，可访问官网<hlink|https://mogan.app/zh|https://mogan.app/zh?from=app>下载最新稳定版。
-  </ornamented>>
+  </version-notice>
 
   <section*|示例文档：我能用墨干做什么？>
 

TeXmacs/packages/themes/dark/dark.ts

@@ -116,11 +116,15 @@
 
   <assign|src-length|<macro|body|<with|mode|src|color|#2aadad|<arg|body>>>>
 
+  <assign|version-notice-bg-color|#6b5600>
+
+  <assign|version-notice-fg-color|#fff4cc>
+
   \;
 </body>
 
 <\initial>
   <\collection>
     <associate|preamble|true>
   </collection>
-</initial>
+</initial>

TeXmacs/styles/documentation/Mogan/tmudoc.ts

@@ -52,6 +52,20 @@
 
   <assign|html-head-javascript-src|https://www.texmacs.org/javascript/texmacs_functions.js>
 
+  <assign|version-notice-bg-color|pastel yellow>
+
+  <assign|version-notice-fg-color|black>
+
+  <assign|version-notice-border|0ln>
+
+  <assign|version-notice|<\macro|body>
+    <\with|ornament-border|<value|version-notice-border>|ornament-color|<value|version-notice-bg-color>|color|<value|version-notice-fg-color>>
+      <\ornamented>
+        <arg|body>
+      </ornamented>
+    </with>
+  </macro>>
+
   <\active*>
     <\src-comment>
       Sections, subsections and subsubsections.
@@ -140,4 +154,4 @@
 </body>
 
 <initial|<\collection>
-</collection>>
+</collection>>

devel/204_30.md

@@ -47,6 +47,29 @@
 3. 切换文档主题为深色
 4. 自动重启后文档直接变为黑色底，不需要二次打开
 
+测试项九：版本提示块在浅色和深色模式下都清晰可读
+1. 在浅色主题下打开 `TeXmacs/doc/about/mogan/stem.zh.tmu` 或 `TeXmacs/doc/about/mogan/stem.en.tmu`
+2. 确认版本提示块保持原来的浅黄色背景，文字为深色，视觉效果与修改前一致
+3. 切换软件主题为深色，自动重启
+4. 重新打开上述文档，确认版本提示块变为深色背景、浅色文字，且文字与背景对比清晰
+5. 在深色主题和浅色主题之间重复切换，确认版本提示块会随主题变化，且浅色模式下颜色不发生额外变化
+
+## 2026/04/01 版本提示块抽出宏，深色模式单独覆盖前景和背景色
+
+### What
+将关于页面中“当前版本/最新稳定版”的提示块从文档内联的 `with + ornamented` 写法，抽成 Mogan 文档样式中的 `version-notice` 宏。
+浅色模式继续保持原来的浅黄色背景和黑色文字；深色模式通过主题变量覆盖，改为深色背景和浅色文字。
+
+### Why
+此前提示块在文档里直接写死了 `ornament-color|pastel yellow`，而深色主题会将 decoration 的正文颜色设为白色，导致黄色底与白色字在深色模式下对比度不足。
+由于背景色是在文档调用点显式写死的，只改 dark 主题的全局默认值无法覆盖这个局部设置，因此需要先把这类提示块收敛到统一宏，再由深色主题覆写对应变量。
+
+### How
+TeXmacs/styles/documentation/Mogan/tmudoc.ts 添加 `version-notice-bg-color`、`version-notice-fg-color`、`version-notice-border` 和 `version-notice` 宏，默认值保持浅色模式原样不变
+TeXmacs/packages/themes/dark/dark.ts 添加 `version-notice-bg-color` 和 `version-notice-fg-color` 的深色主题覆盖值
+TeXmacs/doc/about/mogan/stem.zh.tmu 将版本提示块改为调用 `version-notice`
+TeXmacs/doc/about/mogan/stem.en.tmu 将版本提示块改为调用 `version-notice`
+
 ## 2026/04/01 导出PDF只允许浅色
 
 ### What