[216_30] File 页面简化为单一新建空白文档入口 (#3212)

Author: Yuki-Nagori

TeXmacs/misc/themes/liii-night.css

@@ -1167,11 +1167,12 @@ QLabel#startup-tab-recent-path {
 }
 
 QWidget#style-card {
-  border: 1px solid #4b5560;
+  border: 1px solid #3c3c3c;
+  border-radius: 8px;
 }
 
-QWidget#style-card[selected="true"] {
-  border: 2px solid #2791ad;
+QWidget#style-card:hover {
+  border: 1px solid #2791ad;
 }
 
 QLabel#style-card-icon {
@@ -1183,10 +1184,6 @@ QLabel#style-card-name {
   color: #e2e8ee;
 }
 
-QLabel#style-card-badge {
-  color: #ffffff;
-}
-
 /****************************************************************************
 * PDF Preview Widget 样式
 ****************************************************************************/

TeXmacs/misc/themes/liii.css

@@ -1169,11 +1169,12 @@ QLabel#startup-tab-recent-path {
 }
 
 QWidget#style-card {
-  border: 1px solid #d4dde6;
+  border: 1px solid #cfcfcf;
+  border-radius: 8px;
 }
 
-QWidget#style-card[selected="true"] {
-  border: 2px solid #2791ad;
+QWidget#style-card:hover {
+  border: 1px solid #2791ad;
 }
 
 QLabel#style-card-icon {
@@ -1185,10 +1186,6 @@ QLabel#style-card-name {
   color: #2b3b45;
 }
 
-QLabel#style-card-badge {
-  color: #ffffff;
-}
-
 /****************************************************************************
 * PDF Preview Widget 样式
 ****************************************************************************/

TeXmacs/plugins/lang/dic/en_US/zh_CN.scm

@@ -503,6 +503,7 @@
 ("count lines" "统计行数")
 ("count words" "统计单词数")
 ("create" "创建")
+("Create a new blank document" "创建一个新的空白文档")
 ("create a new document" "新建文档")
 ("create context macro" "创建上下文宏")
 ("create preamble" "生成导言")
@@ -1519,6 +1520,7 @@
 ("Network error, please log in later." "网络有误，请稍后登录")
 ("never" "从不")
 ("new account" "新建账号")
+("New Blank Document" "新建空白文档")
 ("new buffer" "")
 ("new column" "添加一行")
 ("new document" "新建文档")

devel/216_30.md

@@ -0,0 +1,48 @@
+# 216_30 File 页面简化为单一新建空白文档入口
+
+## 如何测试
+
+1. 编译：`xmake b stem`
+2. 启动 Mogan，打开启动页 **File** 页面。
+3. 确认仅显示 **1 个** "New Blank Document" 卡片，不再显示 Beamer / Book 等旧卡片。
+4. 确认卡片尺寸变大，中央显示 **`+`** 号图标，无 "Default" 蓝色徽标。
+5. Hover 时边框变为青色（`#2791ad`），点击无选中边框，点击可正常新建空白文档。
+6. 分别验证亮色/暗色主题下卡片边框和 Hover 效果正常。
+7. 切换中文，确认显示 "新建空白文档"。
+
+## 2026/04/23 实现说明
+
+### What
+
+将 File 页面的多类型文档卡片（Generic/Beamer/Book/Exam/Letter/Article）精简为单一 "New Blank Document" 入口，同时放大卡片尺寸、优化视觉层级，并将样式控制权从 C++ 收归 CSS 主题文件。
+
+#### 修改文件
+
+**src/Plugins/Qt/qt_file_page.cpp**
+- `styles_` 从 6 项缩减为 1 项，仅保留 `generic`。
+- 卡片尺寸放大：`100×120` → `160×256`，图标 `64` → `96`，`+` 号字号 `48px`。
+- 布局由 `AlignTop` 改为 `AlignCenter`。
+- 移除 "Default" 徽标（`badgeLabel_`）和硬编码 `border-radius`。
+- 简化 `paintEvent`，移除手动选中边框绘制，交互效果完全由 CSS 接管。
+
+**TeXmacs/misc/themes/liii.css / liii-night.css**
+- `QWidget#style-card`：边框色改为 `#cfcfcf` / `#3c3c3c`，新增 `border-radius: 8px`。
+- 移除 `[selected="true"]` 规则，改为 `:hover` 边框 `#2791ad`。
+- 移除 `QLabel#style-card-badge` 选择器。
+
+**TeXmacs/plugins/lang/dic/en_US/zh_CN.scm**
+- 新增 "New Blank Document" / "Create a new blank document" 中文翻译。
+
+### Why
+
+1. **功能重叠**：File 页面的多类型卡片与 Template Center 功能重叠，精简为单一入口职责更清晰。
+2. **视觉优化**：旧卡片 `100×120` 过小，放大后更符合首屏核心操作入口定位。
+3. **样式解耦**：移除 C++ 硬编码样式，改由 CSS 统一管理，便于主题维护。
+4. **交互轻量**：仅剩一个卡片时，"Default" 徽标和选中状态失去意义，统一为 Hover 反馈更简洁。
+
+### How
+
+- 缩减 `styles_` 列表为单一项，其他模板引导至 Template Center。
+- 等比放大卡片和图标，使用 `+` 号表达"新建"语义。
+- 移除 `setStyleSheet` 硬编码，CSS 统一控制边框、圆角、Hover 效果。
+- 删除 `badgeLabel_`，简化 `paintEvent` 仅保留背景绘制。

src/Plugins/Qt/qt_file_page.cpp

@@ -46,18 +46,18 @@ static const int MAX_GLOBAL_RECENT_DOCS= 25;
 namespace {
 constexpr int kMainMargin         = 32;   // 主内容区外边距
 constexpr int kMainSpacing        = 24;   // 主纵向布局间距
-constexpr int kStyleCardWidth     = 100;  // 样式卡片宽度
-constexpr int kStyleCardHeight    = 120;  // 样式卡片高度
-constexpr int kStyleIconSize      = 64;   // 样式卡片图标尺寸
+constexpr int kStyleCardWidth     = 160;  // 样式卡片宽度
+constexpr int kStyleCardHeight    = 256;  // 样式卡片高度
+constexpr int kStyleIconSize      = 96;   // 样式卡片图标尺寸
 constexpr int kStyleCardTopPadding= 12;   // 样式卡片顶部内边距
 constexpr int kStyleCardMargin    = 8;    // 样式卡片内边距
 constexpr int kStyleCardSpacing   = 4;    // 样式卡片内部控件间距
 constexpr int kStyleCardsSpacing  = 16;   // 样式卡片横向间距
 constexpr int kStyleCardRadius    = 8;    // 样式卡片圆角
 constexpr int kStyleIconRadius    = 8;    // 样式图标圆角
 constexpr int kSectionTitleFontPx = 16;   // 分区标题字号
-constexpr int kStyleIconFontPx    = 18;   // 样式图标字母字号
-constexpr int kStyleNameFontPx    = 12;   // 样式名称字号
+constexpr int kStyleIconFontPx    = 48;   // 样式图标字母字号
+constexpr int kStyleNameFontPx    = 14;   // 样式名称字号
 constexpr int kStyleBadgeFontPx   = 10;   // Default 徽标字号
 constexpr int kStyleBadgeRadius   = 8;    // Default 徽标圆角
 constexpr int kStyleBadgePadY     = 1;    // Default 徽标纵向内边距
@@ -89,8 +89,6 @@ StyleCard::StyleCard (const DocStyle& style, QWidget* parent)
   int iconSize= DpiUtils::scaled (kStyleIconSize);
 
   setFixedSize (width, height);
-  setStyleSheet (QString ("border-radius: %1px;")
-                     .arg (DpiUtils::scaled (kStyleCardRadius)));
   setCursor (Qt::PointingHandCursor);
   setFocusPolicy (Qt::NoFocus);
   setToolTip (style.description);
@@ -101,17 +99,20 @@ StyleCard::StyleCard (const DocStyle& style, QWidget* parent)
                               DpiUtils::scaled (kStyleCardMargin),
                               DpiUtils::scaled (kStyleCardMargin));
   layout->setSpacing (DpiUtils::scaled (kStyleCardSpacing));
-  layout->setAlignment (Qt::AlignTop);
+  layout->setAlignment (Qt::AlignCenter);
 
   // 预览图占位（使用 QLabel 作为图标容器）
   iconLabel_= new QLabel (this);
   iconLabel_->setFixedSize (iconSize, iconSize);
   iconLabel_->setAlignment (Qt::AlignCenter);
   iconLabel_->setObjectName ("style-card-icon");
-  iconLabel_->setStyleSheet (QString ("border-radius: %1px;")
-                                 .arg (DpiUtils::scaled (kStyleIconRadius)));
-  // 显示样式ID的首字母作为占位
-  iconLabel_->setText (style.id.left (1).toUpper ());
+
+  if (style.id == "generic") {
+    iconLabel_->setText ("+");
+  }
+  else {
+    iconLabel_->setText (style.id.left (1).toUpper ());
+  }
   QFont iconFont= DpiUtils::scaledFont (iconLabel_->font (), kStyleIconFontPx);
   iconFont.setBold (true);
   iconLabel_->setFont (iconFont);
@@ -124,23 +125,6 @@ StyleCard::StyleCard (const DocStyle& style, QWidget* parent)
   DpiUtils::applyScaledFont (nameLabel_, kStyleNameFontPx);
   layout->addWidget (nameLabel_, 0, Qt::AlignCenter);
 
-  // "默认"标签
-  if (style.isDefault) {
-    badgeLabel_= new QLabel (qt_translate ("Default"), this);
-    badgeLabel_->setObjectName ("style-card-badge");
-    badgeLabel_->setAttribute (Qt::WA_StyledBackground, true);
-    badgeLabel_->setAlignment (Qt::AlignCenter);
-    DpiUtils::applyScaledFont (badgeLabel_, kStyleBadgeFontPx);
-    badgeLabel_->setStyleSheet (
-        QString ("background-color: #2791ad; border: 1px solid transparent; "
-                 "border-radius: %1px; "
-                 "padding: %2px %3px;")
-            .arg (DpiUtils::scaled (kStyleBadgeRadius))
-            .arg (DpiUtils::scaled (kStyleBadgePadY))
-            .arg (DpiUtils::scaled (kStyleBadgePadX)));
-    layout->addWidget (badgeLabel_, 0, Qt::AlignCenter);
-  }
-
   setObjectName ("style-card");
 }
 
@@ -157,7 +141,6 @@ StyleCard::setSelected (bool selected) {
 
 void
 StyleCard::enterEvent (QEnterEvent* event) {
-  // 悬停时选中
   emit hovered ();
   QWidget::enterEvent (event);
 }
@@ -175,21 +158,10 @@ StyleCard::paintEvent (QPaintEvent* event) {
   QPainter painter (this);
   painter.setRenderHint (QPainter::Antialiasing);
 
-  // 绘制背景
   QStyleOption opt;
   opt.initFrom (this);
-  style ()->drawPrimitive (QStyle::PE_Widget, &opt, &painter, this);
 
-  // 绘制选中边框
-  if (isSelected_) {
-    painter.setPen (
-        QPen (opt.palette.highlight (), DpiUtils::scaled (kSelectedBorderPx)));
-    painter.setBrush (Qt::NoBrush);
-    const int inset = DpiUtils::scaled (kSelectedInset);
-    const int radius= DpiUtils::scaled (kSelectedRadius);
-    painter.drawRoundedRect (rect ().adjusted (inset, inset, -inset, -inset),
-                             radius, radius);
-  }
+  style ()->drawPrimitive (QStyle::PE_Widget, &opt, &painter, this);
 }
 
 /******************************************************************************
@@ -199,19 +171,8 @@ StyleCard::paintEvent (QPaintEvent* event) {
 QtFilePage::QtFilePage (QWidget* parent) : QWidget (parent) {
   eval_scheme ("(use-modules (startup-tab startup-tab-file))");
 
-  // 初始化样式列表
-  styles_= {
-      {"generic", qt_translate ("Generic"),
-       qt_translate ("General purpose document"), true},
-      {"beamer", qt_translate ("Beamer"), qt_translate ("Presentation slides"),
-       false},
-      {"book", qt_translate ("Book"), qt_translate ("Book format"), false},
-      {"exam", qt_translate ("Exam"), qt_translate ("Examination paper"),
-       false},
-      {"letter", qt_translate ("Letter"), qt_translate ("Letter format"),
-       false},
-      {"article", qt_translate ("Article"), qt_translate ("Article format"),
-       false}};
+  styles_= {{"generic", qt_translate ("New Blank Document"),
+             qt_translate ("Create a new blank document"), true}};
 
   setupUI ();
   loadRecentDocs ();