docs: add tip for pageType: doc-wide usage with outline: false (#3005)

SoonIter · web-flow · commit 8b7c0550c4fd · 2026-01-14T20:08:31.000+08:00
diff --git a/website/docs/en/api/config/config-frontmatter.mdx b/website/docs/en/api/config/config-frontmatter.mdx
@@ -231,6 +231,19 @@ sidebar: false
 ---
 ```
 
+:::tip
+`sidebar: false` only hides the sidebar, but the space originally occupied by the sidebar is still reserved. If you want the main content to occupy a wider screen space, you can use [`pageType: doc-wide`](#pagetype) with `sidebar: false`:
+
+```yaml
+---
+pageType: doc-wide
+sidebar: false
+---
+```
+
+This way, the main content area will automatically expand to occupy the space originally used by the sidebar.
+:::
+
 ## outline
 
 Whether to display the outline column on the right. By default, the `doc` page displays the outline column on the right. You can hide the outline column with the following config:
@@ -241,6 +254,19 @@ outline: false
 ---
 ```
 
+:::tip
+`outline: false` only hides the outline column, but the space originally occupied by the outline column is still reserved. If you want the main content to occupy a wider screen space, you can use [`pageType: doc-wide`](#pagetype) with `outline: false`:
+
+```yaml
+---
+pageType: doc-wide
+outline: false
+---
+```
+
+This way, the main content area will automatically expand to occupy the space originally used by the outline column.
+:::
+
 ## footer
 
 Whether to display the components at the bottom of the document (such as previous/next page). By default, the `doc` page will display the footer at the bottom. You can hide the footer with the following config:
diff --git a/website/docs/zh/api/config/config-frontmatter.mdx b/website/docs/zh/api/config/config-frontmatter.mdx
@@ -231,6 +231,19 @@ sidebar: false
 ---
 ```
 
+:::tip 提示
+`sidebar: false` 仅隐藏侧边栏，但原本侧边栏占据的空间仍然保留。如果你想让正文内容占据更宽的屏幕空间，可以使用 [`pageType: doc-wide`](#pagetype) 配合 `sidebar: false`：
+
+```yaml
+---
+pageType: doc-wide
+sidebar: false
+---
+```
+
+这样正文内容区域会自动扩展，占据原本侧边栏的空间。
+:::
+
 ## outline
 
 是否展示右侧的大纲栏。默认情况下，`doc` 页面会展示右侧的大纲栏。你可以通过下面的配置来隐藏大纲栏：
@@ -241,6 +254,19 @@ outline: false
 ---
 ```
 
+:::tip 提示
+`outline: false` 仅隐藏大纲栏，但原本大纲栏占据的空间仍然保留。如果你想让正文内容占据更宽的屏幕空间，可以使用 [`pageType: doc-wide`](#pagetype) 配合 `outline: false`：
+
+```yaml
+---
+pageType: doc-wide
+outline: false
+---
+```
+
+这样正文内容区域会自动扩展，占据原本大纲栏的空间。
+:::
+
 ## footer
 
 是否展示文档底部的组件（如上一页/下一页）。默认情况下，`doc` 页面会展示底部的 footer。你可以通过下面的配置来隐藏 footer：
