# Univer PDFs の概要

> Univer PDFs は、永続化可能なドキュメントデータ、Facade API、インポートとエクスポート、共同編集、印刷に対応したブラウザー向け PDF ビューアーおよびエディターです。

- Human documentation: [https://docs.univer.ai/ja-JP/guides/pdfs](https://docs.univer.ai/ja-JP/guides/pdfs)

- Agent Markdown: [https://docs.univer.ai/ja-JP/guides/pdfs.md](https://docs.univer.ai/ja-JP/guides/pdfs.md)

- Requested language: `ja-JP`

- Content language: `ja-JP`

- Documentation version: `1.2.0`

- Source: [pdfs/index.ja-JP.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/index.ja-JP.mdx)

---

## Univer PDFs とは

Univer PDFs は Univer Office SDK の PDF 製品です。PDF を正式な `UNIVER_PDF` ユニットとして表現し、インポートされたソースドキュメントを保持しながら、確定した編集を独立した永続編集レイヤーに保存します。ブラウザー UI は、両方のレイヤーを一続きのドキュメントとしてレンダリングします。

Univer Office SDK は、埋め込みエディターとヘッドレスのコンテンツ処理を提供する [Web SDK](https://docs.univer.ai/ja-JP/guides/sheets.md)、共同編集とファイルのインポート・エクスポートを提供する [Server SDK](https://docs.univer.ai/ja-JP/server.md)、エージェントのワークフローを提供する [AI SDK](https://docs.univer.ai/ja-JP/ai.md) で構成されます。

PDF の作成や表示、編集可能なコンテンツの追加、インポートした PDF の忠実度維持、変更の共同編集、結果のエクスポート、アクティブなドキュメントのブラウザー印刷が必要なアプリケーションで Univer PDFs を使用します。

> [!WARNING: プラグインモードのみ]
> PDF のプリセットパッケージはありません。PDF モデル、UI、必要な機能プラグインを明示的に登録してください。

## ブラウザ互換性

Web SDK は Chrome 88 をターゲットとしてコンパイルされていますが、これはすべての主流環境を完全にサポートすることを保証するものではありません。Web SDK が以下のブラウザおよび Node.js 環境で問題なく動作するよう努めています。

| Edge | Firefox | Chrome | Safari | Electron |
| ---- | ------- | ------ | ------ | -------- |
| >=88 | >=90    | >=88   | >=14.1 | >=12     |

> [!WARNING]
> Web SDK は `Intl.Segmenter`
> に依存しています。お使いのブラウザまたはランタイム環境でこれがサポートされていない場合は、先に対応するポリフィルを追加してください。`@formatjs/intl-segmenter`
> の利用を推奨します。

互換性に関する問題が発生した場合、まずは適切なポリフィルを使用して解決を試みてください。それでも問題が解決しない場合は、[Issue の提出](https://github.com/dream-num/univer/issues/new/choose) をご検討ください。

## Node.js 互換性

> [!注意事項]
> 注意：これは Web SDK を Node.js 環境で実行する場合にのみ適用され、Node.js
> ベースのビルドツールを使ってブラウザで実行する場合には該当しません。

Web SDK は Node.js 環境でも動作可能で、v18.17.0 以降のバージョンをサポートしています。

## 主な機能

* **PDF Unit モデル**：ソース文書、ページ構造、リソース、永続的な編集内容を `IPdfUnitData` に保存します。
* **ページと要素の操作**：ページの移動と挿入に加え、テキスト、リスト、表、画像、区切り線、注釈を編集できます。
* **ブラウザーワークベンチ**：PDF ページの描画、サムネイル、選択、編集コントロール、クリップボード、インスペクター UI を提供します。
* **コマンドパイプライン**：確定した変更を永続的なコマンドとミューテーションバッチで適用し、保存、元に戻す、やり直しで同じモデルを使用します。
* **Facade API**：PDF、ページ、要素、ネイティブテキストの各オブジェクトから PDF Unit を作成、検索、編集、保存できます。

## ドキュメントの読み方

画面左側にドキュメントのナビゲーションがあります。ページは基礎から応用へ順に構成されているため、その順で進めてもよいですし、必要な章だけを選んで読むこともできます。サイドバー上部で Univer PDFs のドキュメントに切り替えることもできます。

画面右側には現在ページの目次が表示されます。目的のページを素早く見つけたい場合は、上部の検索バーや検索ショートカット（Ctrl+K または Cmd+K）を利用してください。

まずは [クイックスタート](https://docs.univer.ai/ja-JP/guides/pdfs/getting-started/installation.md) から始めることをおすすめします。

## 前提知識

ドキュメントは初心者にも分かりやすく設計していますが、Web SDK に集中できるよう、読み始める前にいくつかの基礎知識があることを前提としています。

効率よく理解するために、JavaScript とそのエコシステムの基本的な理解をおすすめします。

Node.js 上で Web SDK を動かしたい場合は、Node.js の基礎知識も必要です。

共同編集、共有履歴やコメント、ファイル変換が必要な場合は、[Univer Server SDK](https://docs.univer.ai/ja-JP/server.md) の必要なモジュールをアプリのバックエンドに組み込みます。認証、権限、ストレージ、デプロイはアプリ側で用意します。ブラウザー内の編集だけなら、これらのサービスは不要です。

## Univer PDFs を拡張する

Web SDK は拡張性を重視して設計されているため、ニーズに合わせて自由にカスタマイズできます。

- [クイックスタート](https://docs.univer.ai/ja-JP/guides/pdfs/getting-started/installation.md)

- [ライセンス設定](https://docs.univer.ai/ja-JP/server/license.md)

- [機能一覧](https://docs.univer.ai/ja-JP/guides/pdfs/features/core.md)

- [API リファレンス](https://docs.univer.ai/ja-JP/reference/classes/univer.md)