プロフェッショナルDOCX市場レポート

# 使用ガイド

## 概要

プロフェッショナルDOCX市場レポートは、洗練されたWord市場調査レポートの作成を自動化する強力なプラグインです。プロフェッショナルなカバーページ、自動生成される目次、適切に構造化されたセクション、書式設定済みの表、結論、ページ番号を備えた完全なドキュメントを生成し、プレゼンテーションや追加編集にすぐ使える状態にします。

## 主な機能

- **カバーページ**: レポートのタイトル、サブタイトル、日付、作成者を含むカバーページを自動生成します。
- **目次 (TOC)**: すべての見出しを反映する自動更新TOCを挿入します。
- **スタイル設定済みセクション**: プロフェッショナルな見た目にするため、一貫した見出しスタイル（Heading 1、Heading 2など）を適用します。
- **表**: データ表示用に、見やすくスタイル設定された表を作成します。
- **結論**: 要約テキストを含む結論セクションを追加します。
- **ページ番号**: フッターにページ番号を含めます。

## 使用方法

1. **プラグインをインストールする**
   - `docx-official` skill（プラグインに含まれています）にアクセスできることを確認してください。
   - 環境でプラグインを読み込みます（例: package manager経由、または直接import）。

2. **基本的なレポート生成**
   必要なパラメータを指定してメイン関数を呼び出します:
   - `title` (string): レポートタイトル（例: "Global EV Market Analysis 2025"）
   - `author` (string): 作成者名
   - `date` (string): 日付文字列（例: "January 2025"）
   - `sections` (array): セクションオブジェクトのリスト。各オブジェクトには以下を含めます:
       - `heading`: セクションタイトル
       - `content`: 段落テキスト（**bold** のようなmarkdown風の書式をサポート）
       - `tables` (optional): 表の配列。各表は `rows`（`cells` 配列を持つ行オブジェクトの配列）を含むオブジェクトです。
   - `conclusion` (string): 結論セクションのテキスト。

   例:
   ```javascript
   const report = await createMarketReport({
     title: "Q4 Market Trends",
     author: "Jane Doe",
     date: "October 2024",
     sections: [{
       heading: "Market Overview",
       content: "The market grew by **12%** this quarter.",
       tables: [
         {
           rows: [
             { cells: ["Region", "Revenue", "Growth"] },
             { cells: ["North America", "$5B", "10%"] },
             { cells: ["Europe", "$3B", "8%"] }
           ]
         }
       ]
     }],
     conclusion: "Overall, the market shows strong momentum."
   });
   // report is a buffer or file path to the generated .docx
   ```

3. **カスタマイズ**
   任意パラメータを渡して出力を変更することもできます:
   - `filename` (string): カスタム出力ファイル名。
   - `coverPageImage` (string): カバーページ用画像へのパス。
   - `tocSettings` (object): TOCの深さ、書式などを制御します。

4. **レポートの保存**
   出力はDOCXファイルです。標準的なファイルI/Oを使用して保存します:
   ```javascript
   const fs = require('fs');
   fs.writeFileSync('market_report.docx', report);
   ```

## ベストプラクティス

- セクションは簡潔に保ってください。各セクションは主要な見出しに対応します。
- 比較データを提示するには、セクション内の `tables` 配列を使用してください。
- 最終化する前に、プレースホルダーデータでサンプルを生成してレポートをテストしてください。
- 大規模なレポートでは、データを複数のセクションに分割することを検討してください。

## トラブルシューティング

- **TOCが更新されない場合** WordでTOCを右クリックし、"Update Field" を選択してください。
- **スタイル設定済みの見出しが表示されない場合** 正しい見出しレベル（セクションタイトルにはHeading 1）を使用していることを確認してください。
- **表の位置がずれる場合** 各行のセル数が同じであることを確認してください。

## 結論

プロフェッショナルDOCX市場レポートは、プロフェッショナルな市場調査ドキュメントの作成を効率化し、時間を節約しながら一貫性を確保します。シンプルなAPIにより、関係者レビューや公開にすぐ使える洗練されたレポートをプログラムで生成できます。