# 列印

- Human documentation: [https://docs.univer.ai/zh-TW/guides/docs/features/print](https://docs.univer.ai/zh-TW/guides/docs/features/print)

- Agent Markdown: [https://docs.univer.ai/zh-TW/guides/docs/features/print.md](https://docs.univer.ai/zh-TW/guides/docs/features/print.md)

- Requested language: `zh-TW`

- Content language: `zh-TW`

- Documentation version: `1.2.0`

- Source: [docs/features/print.zh-TW.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/docs/features/print.zh-TW.mdx)

---

#### Package metadata

```json
{
  "preset": [
    {
      "client": "@univerjs/preset-docs-advanced",
      "locale": "@univerjs/preset-docs-advanced/locales/zh-TW",
      "style": "@univerjs/preset-docs-advanced/lib/index.css"
    }
  ],
  "plugins": [
    {
      "client": "@univerjs-pro/docs-print",
      "locale": "@univerjs-pro/docs-print/locale/zh-TW"
    }
  ],
  "license": true,
  "server": false
}
```

列印功能允許使用者將文件內容列印為紙質文件或匯出為 PDF 格式，便於離線檢視和分享。

## 外掛模式

### 安裝

#### npm

```bash
npm install @univerjs-pro/docs-print
```

#### pnpm

```bash
pnpm add @univerjs-pro/docs-print
```

#### yarn

```bash
yarn add @univerjs-pro/docs-print
```

#### bun

```bash
bun add @univerjs-pro/docs-print
```

### 使用

```typescript
import { UniverDocsPrintPlugin } from '@univerjs-pro/docs-print' // [!code ++]
import DocsPrintPluginZhTW from '@univerjs-pro/docs-print/locale/zh-TW' // [!code ++]
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'

import '@univerjs-pro/docs-print/lib/index.css' // [!code ++]

const univer = new Univer({
  locale: LocaleType.ZH_TW,
  locales: {
    [LocaleType.ZH_TW]: mergeLocales(
      DocsPrintPluginZhTW, // [!code ++]
    ),
  },
})

univer.registerPlugin(UniverDocsPrintPlugin) // [!code ++]
```

如果你擁有 Univer 的商業許可證，請參考[在客戶端使用許可證](https://docs.univer.ai/zh-TW/server/license.md#in-plugin-mode)進行配置。

## 預設模式

列印功能被包含在 `@univerjs/preset-docs-advanced` 預設中。

### 安裝

> [!NOTE]
> @univerjs/preset-docs-advanced 的 `UniverDocsAdvancedPreset` 預設在執行時依賴 `UniverDocsDrawingPreset` 預設，請先安裝 @univerjs/preset-docs-drawing。

#### npm

```bash
npm install @univerjs/preset-docs-drawing @univerjs/preset-docs-advanced
```

#### pnpm

```bash
pnpm add @univerjs/preset-docs-drawing @univerjs/preset-docs-advanced
```

#### yarn

```bash
yarn add @univerjs/preset-docs-drawing @univerjs/preset-docs-advanced
```

#### bun

```bash
bun add @univerjs/preset-docs-drawing @univerjs/preset-docs-advanced
```

### 使用

```typescript
import { UniverDocsAdvancedPreset } from '@univerjs/preset-docs-advanced' // [!code ++]
import UniverPresetDocsAdvancedZhTW from '@univerjs/preset-docs-advanced/locales/zh-TW' // [!code ++]
import { UniverDocsCorePreset } from '@univerjs/preset-docs-core'
import UniverPresetDocsCoreZhTW from '@univerjs/preset-docs-core/locales/zh-TW'
import { UniverDocsDrawingPreset } from '@univerjs/preset-docs-drawing' // [!code ++]
import UniverPresetDocsDrawingZhTW from '@univerjs/preset-docs-drawing/locales/zh-TW' // [!code ++]
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'

import '@univerjs/preset-docs-core/lib/index.css'
import '@univerjs/preset-docs-drawing/lib/index.css' // [!code ++]
import '@univerjs/preset-docs-advanced/lib/index.css' // [!code ++]

const { univerAPI } = createUniver({
  locale: LocaleType.ZH_TW,
  locales: {
    [LocaleType.ZH_TW]: mergeLocales(
      UniverPresetDocsCoreZhTW,
      UniverPresetDocsDrawingZhTW, // [!code ++]
      UniverPresetDocsAdvancedZhTW, // [!code ++]
    ),
  },
  presets: [
    UniverDocsCorePreset(),
    UniverDocsDrawingPreset(), // [!code ++]
    UniverDocsAdvancedPreset(), // [!code ++]
  ],
})
```

如果你擁有 Univer 的商業許可證，請參考[在客戶端使用許可證](https://docs.univer.ai/zh-TW/server/license.md#in-preset-mode)進行配置。