LibreOffice ドキュメントツールキット

# LibreOffice ドキュメントツールキット

LibreOfficeの統一されたワークフローを通じて、Writer、Calc、Impressドキュメントの作成、編集、自動化を行います。

## 前提条件

- **LibreOffice**がインストールされていること（7.x以降を推奨）
- UNO APIアクセスするためにLibreOfficeが**リスニングモード**で実行されている必要があります：
  ```bash
  soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore
  ```
- **Python 3**と`uno`モジュールがインストールされていること（ほとんどのシステムではLibreOfficeにバンドルされています）
- 対応プラットフォーム：Linux、macOS、Windows（LibreOffice + UNOはこれら3つすべてで利用可能です）

### クイック環境チェック

```bash
# LibreOfficeがインストールされていることを確認
soffice --version

# ヘッドレスリスナーを起動（バックグラウンド）
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &

# UNO接続を確認
python3 -c "import uno; print('UNO available')"
```

`import uno`が失敗する場合は、PythonパスにLibreOfficeのsite-packagesが含まれていることを確認してください（例：`/usr/lib/libreoffice/program/`）。

## このプラグインできること

3つのコアLibreOfficeアプリケーション向けの3つのスキル：

| スキル | フォーマット | 機能 |
|-------|--------|-------------|
| **Writer** | .odt | テキスト挿入、表、画像、メタデータ、段落スタイル |
| **Calc** | .ods | セル操作、数式、書式設定、グラフ、名前付き範囲、データ検証 |
| **Impress** | .odp | スライド、コンテンツ配置、表、グラフ、メディア、ノートマスターページ |

## 完全な例：週次レポートパイプライン

チームが金曜日のレポートワークフローを自動化します—データをスプレッドシートに集約し、書かれたサマリーを生成し、プレゼンデッキを作成します。

### ステップ1：Calc — 週次指标的集計

```
新しいCalcスプレッドシート「weekly-metrics.ods」を作成します。
シート1「Revenue」：月～金のサンプルデータを持つDate、Product、Units、Revenue列。
シート2「Summary」：SUMIF数式を使用して製品ごとの収益を合計します。
シート2に製品別の収益を可視化する棒グラフを追加します。
ヘッダー行を青背景の太字で書式設定します。
```

### ステップ2：Writer — 書面レポートの生成

```
Writerドキュメント「weekly-report.odt」を作成します。
タイトル：「Weekly Report — March 10, 2026」
セクション1：エグゼクティブサマリー（スプレッドシートからの指標を要約した2段落）。
セクション2：主なハイライト（トップ3の達成事項の箇条書きリスト）。
セクション3：来週の優先事項（番号付きリスト）。
スプレッドシートからの合計を含む表を挿入。
フォントをLiberation Serif 12pt、見出しを16pt太字に設定。
```

### ステップ3：Impress — プレゼンデッキの作成

```
Impressプレゼンテーション「weekly-deck.odp」を作成します。
スライド1：タイトルスライド — 「Weekly Review Q1 W10」と日付のサブタイトル。
スライド2：指標の概要 — 製品別収益の表を挿入。
スライド3：ハイライト — トップ達成事項の箇条書き。
スライド4：次のステップ — 番号付きの優先事項。
スライド5：謝辞スライド。
スライド2～4にトークポイントのスピーカーノートを追加。
```

**結果：** 3つの調整されたドキュメント（スプレッドシート、レポート、デック）が、単一のワークフローから生成されます—手動の書式設定やアプリ間のコピペは不要です。

## エラー処理と障害回復

### LibreOfficeが実行されていない場合

UNOソケット接続が失敗した場合：
```
Error: could not connect to socket on localhost:2002
```
**修正：** ヘッドレスリスナーを起動：
```bash
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &
```

### UNOモジュールが見つからない場合

```
ModuleNotFoundError: No module named 'uno'
```
**修正：** LibreOffice Pythonをパスに追加：
```bash
# Linux
export PYTHONPATH=/usr/lib/libreoffice/program:$PYTHONPATH

# macOS
export PYTHONPATH="/Applications/LibreOffice.app/Contents/Frameworks/:$PYTHONPATH"
```

### テンプレートまたはファイルが見つからない場合

テンプレートファイルが参照されているが見つからない場合、スキルは代わりに新しい空白のドキュメントを作成します。テンプレートパスが作業ディレクトリに対して絶対パスまたは相対パスであることを確認してください。

### 保存時の権限エラー

出力ディレクトリが書き込み不可の場合、保存操作は失敗します。ドキュメント生成を実行する前に書き込み権限を確認してください：
```bash
test -w ./output/ || mkdir -p ./output/
```

### 同時アクセス

LibreOffice UNOは同時接続を十分にサポートしていません。複数のスクリプトが同じリスナーを同時に使用しようとすると、操作が失敗したり、出力が破損したりすることがあります。一度に1つの接続を使用するか、異なるポートで別々のヘッドレスインスタンスを起動してください。