跳至內容
Fumadocs

Flux 版面配置

極致精簡的文件版面配置

一款極簡、潔淨到近乎不切實際的文件版面配置,最初是為了實驗用途而打造。

Flux Layout

Install via Fumadocs CLI

For advanced customization that supported options cannot suffice.

npx @fumadocs/cli@latest customize

使用方式

透過 fumadocs-ui/layouts/flux 啟用 Flux 版面配置。

layout.tsx
import { DocsLayout } from 'fumadocs-ui/layouts/flux'; 
import { baseOptions } from '@/lib/layout.shared';
import { source } from '@/lib/source';
import type { ReactNode } from 'react';

export default function Layout({ children }: { children: ReactNode }) {
  return (
    <DocsLayout {...baseOptions()} tree={source.getPageTree()}>
      {children}
    </DocsLayout>
  );
}

請記得一併更新頁面中的匯入:

page.tsx
import { ... } from 'fumadocs-ui/layouts/docs/page'; 
import { ... } from 'fumadocs-ui/layouts/flux/page'; 

須知事項

  • 建議搭配靜態/本機搜尋使用,透過文件搜尋來瀏覽會更有效率。
  • 它以主觀美感為優先,而非使用者體驗。
  • 它的設計較為固定,若需要自訂,請改用 Fumadocs CLI。

設定

選項繼承自文件版面配置,但有些許差異:

  • Flux 版面配置是用戶端元件,因此您無法從伺服器元件傳入無法序列化的 props。
  • 新增 renderNavigationPanel prop,可用來自訂底部的導覽面板。
  • 不提供 tocPopover 選項。

How is this guide?

最後更新於