odt

ODT ドキュメントスキル

.odt ファイルは、XML ファイルとアセットを含む ZIP パッケージです。可能な場合は高水準のライブラリを使用し、複雑な書式、変更履歴、または正確な制御が必要な場合は、生の XML を使用してください。

参照ファイル

トピック	ファイル
パッケージ構造	references/odt-structure.md
変更履歴	references/odt-change-tracking.md
言語／ロケール	references/odt-language.md
XML パターン	references/odf-xml.md
odfdo ライブラリ	references/odfdo.md
ODTDocument API	references/odt-document.md
スキーマ検証	references/odf-schemas.md
ツールの概要	references/tools.md

プロンプトの例

• 「この ODT からすべてのテキストを抽出し、見出しと表を要約してください。」
• 「変更履歴を適用して、取り消し線を維持したまま、これらの語句を置き換えてください。」
• 「すべての段落スタイルに、クメール語の言語／ロケールとフォントを設定してください。」
• 「この ODT パッケージを検証し、不足しているファイルを報告してください。」
• 「展開して content.xml を編集し、スタイルを壊さずに再パッケージしてください。」

ワークフローの判断表

タスク	方法
テキストの読み取り／抽出	pandoc または odfdo-markdown を使用
新しいドキュメントの作成	references/odfdo.md を読み、odfdo ライブラリを使用
簡単な編集	references/odfdo.md を読み、odfdo ライブラリを使用
変更履歴／注釈	references/odt-document.md を読み、ODTDocument API を使用
複雑な XML 編集	references/odf-xml.md を読み、XML を直接編集

主な操作

テキストの抽出

pandoc document.odt -o document.md      # Convert to Markdown
odfdo-markdown document.odt > out.md    # Alternative

展開／再パッケージのワークフロー

python scripts/unpack_odt.py <file.odt> <dir>   # Unpack
# ... edit XML files ...
python scripts/pack_odt.py <dir> <file.odt>     # Repack

ODTDocument ライブラリの使用

ODTDocument を使用するスクリプトでは、PYTHONPATH にスキルのルートを設定する必要があります。リポジトリのルートから実行する場合は、スキルのフォルダーを明示的に指定してください。

PYTHONPATH=/path/to/repo/skills/odt python your_script.py
# example from repo root
PYTHONPATH=skills/odt python your_script.py

odfdo でのドキュメント作成

最初に references/odfdo.md を読んでください。基本的な例：

from odfdo import Document, Paragraph
doc = Document('text')
doc.body.append(Paragraph('Hello'))
doc.save('output.odt')

生の XML の編集

最初に references/odf-xml.md を読んでください。主なファイル：

• content.xml — ドキュメントの本文
• styles.xml — ドキュメントのスタイル
• META-INF/manifest.xml — パッケージマニフェスト（ファイル追加時に更新）

変更履歴のワークフロー

構造の詳細については、references/odt-change-tracking.md を読んでください。主な原則：

• 変更をまとめる：デバッグしやすいよう、関連する変更を1回につき3～10件まとめます
• 最小限のマーキング：実際に変更されるテキストのみをマークします

ワークフロー：

1. Markdown に変換します：pandoc doc.odt -o doc.md
2. 変更を特定し、バッチにまとめます
3. ODTDocument.suggest_replacement() ／ suggest_insertion() ／ suggest_deletion() を使用します
4. 検証します：python scripts/validate_changes.py content.xml
5. 再パッケージし、LibreOffice で確認します

言語サポート（クメール語、タイ語、アラビア語など）

references/odt-language.md を参照してください。ヘルパースクリプト：

python scripts/set_language.py styles.xml --lang km --country KH --font "Khmer OS System"

ODT から PDF／画像への変換

soffice --headless --convert-to pdf document.odt    # ODT → PDF
pdftoppm -jpeg -r 150 document.pdf page             # PDF → images

依存関係

必須

• odfdo：pip install odfdo（ODT の作成／編集）
• defusedxml：pip install defusedxml（安全な XML 解析）

任意

• pandoc：brew install pandoc（Markdown への変換）
• LibreOffice：brew install --cask libreoffice（ODT → PDF）
• jing：validate_rng.py 用 Relax NG バリデーター
• Poppler：brew install poppler（PDF → 画像変換用の pdftoppm）

検証スクリプト

python scripts/validate_odt.py <dir> --original <file.odt>     # Package validation
python scripts/validate_changes.py <dir>/content.xml           # Change tracking
python scripts/validate_rng.py <dir>/content.xml               # RNG schema (needs jing)
python scripts/smoke_test.py <file.odt> <work_dir>             # Full roundtrip