docs: describe useSite/usePage runtime hooks (#2887)

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: SoonIter <[email protected]>

Author: Copilot

website/docs/en/ui/hooks/_meta.json

@@ -4,5 +4,7 @@
   "use-dark",
   "router-hooks",
   "use-i18n",
-  "use-page-data"
+  "use-page-data",
+  "use-page",
+  "use-site"
 ]

website/docs/en/ui/hooks/use-page.mdx

@@ -0,0 +1,20 @@
+# usePage
+
+`usePage` exposes metadata extracted from the current Markdown or MDX page.
+
+- **Type:** `() => { page: PageDataLegacy['page'] }`
+
+The `page` object contains parsed frontmatter and runtime details such as `title`, `toc`, `lang`, `version`, `routePath`, `pagePath`, `description`, `headingTitle`, `pageType`, and `lastUpdatedTime`, allowing you to build contextual UI for the active document.
+
+```tsx preview
+import { usePage } from '@rspress/core/runtime';
+
+export default function LastUpdated() {
+  const { page } = usePage();
+  return page.lastUpdatedTime ? (
+    <span>Updated: {page.lastUpdatedTime}</span>
+  ) : null;
+}
+```
+
+> Use `usePage` together with [`useSite`](./use-site) or `usePages` when you need both per-page metadata and global site information.

website/docs/en/ui/hooks/use-site.mdx

@@ -0,0 +1,18 @@
+# useSite
+
+`useSite` returns the normalized site configuration generated from your `rspress.config.ts`.
+
+- **Type:** `() => { site: SiteData }`
+
+The `site` object mirrors the normalized config, including base path, language/locales, theme configuration, search and markdown options, and multi-version settings.
+
+```tsx preview
+import { useSite } from '@rspress/core/runtime';
+
+export default function SiteTitle() {
+  const { site } = useSite();
+  return <span>{site.title}</span>;
+}
+```
+
+> Pair with [`usePage`](./use-page) to combine global config with the current page metadata.

website/docs/zh/ui/hooks/_meta.json

@@ -4,5 +4,7 @@
   "use-dark",
   "router-hooks",
   "use-i18n",
-  "use-page-data"
+  "use-page-data",
+  "use-page",
+  "use-site"
 ]

website/docs/zh/ui/hooks/use-page.mdx

@@ -0,0 +1,20 @@
+# usePage
+
+`usePage` 提供当前 Markdown 或 MDX 页面解析得到的元信息。
+
+- **类型：** `() => { page: PageDataLegacy['page'] }`
+
+`page` 包含解析出的 frontmatter 以及运行时信息，例如 `title`、`toc`、`lang`、`version`、`routePath`、`pagePath`、`description`、`headingTitle`、`pageType`、`lastUpdatedTime` 等，方便基于当前文档构建上下文 UI。
+
+```tsx preview
+import { usePage } from '@rspress/core/runtime';
+
+export default function LastUpdated() {
+  const { page } = usePage();
+  return page.lastUpdatedTime ? (
+    <span>Updated: {page.lastUpdatedTime}</span>
+  ) : null;
+}
+```
+
+> 当需要同时获取页面元信息和站点全局配置时，可结合 [`useSite`](./use-site) 或 `usePages` 使用。

website/docs/zh/ui/hooks/use-site.mdx

@@ -0,0 +1,18 @@
+# useSite
+
+`useSite` 返回根据 `rspress.config.ts` 归一化后的站点配置。
+
+- **类型：** `() => { site: SiteData }`
+
+`site` 包含已归一化的配置数据，包括基础路径、语言与多语言信息、主题配置、搜索与 Markdown 选项、多版本设置等。
+
+```tsx preview
+import { useSite } from '@rspress/core/runtime';
+
+export default function SiteTitle() {
+  const { site } = useSite();
+  return <span>{site.title}</span>;
+}
+```
+
+> 可以配合 [`usePage`](./use-page) 一起使用，同时获取全局站点配置和当前页面的元信息。