コンバータ
Aspose.Words FOSS for Python は、内部ドキュメントモデルを出力形式に変換するための専門的なコンバータクラスを使用します。ParagraphConverter はテキストと書式設定を処理し、TableConverter はテーブル構造を処理し、ListHandler はリスト書式設定を管理します。
段落コンバータ
ParagraphConverter は文書の段落をターゲット出力形式に変換します。段落の書式設定、ランレベルのスタイリング、インラインコンテンツを検査します。
| メソッド | 説明 |
|---|
ParagraphConverter.get_paragraph_info() | 段落から書式情報を抽出する |
ParagraphConverter.get_run_formatting() | テキストランの書式詳細を取得する |
ParagraphConverter.format_text() | テキストコンテンツに書式を適用する |
テーブル コンバータ
TableConverter は、ドキュメントのテーブルを対象フォーマット（Markdown テーブルなど）に変換します。
| メソッド | 説明 |
|---|
TableConverter.convert() | テーブル要素を出力形式に変換する |
リスト ハンドラ
ListHandler は文書変換中にリストの状態を管理し、リストの入れ子、マーカー、および書式設定を追跡します。
| メソッド | 説明 |
|---|
ListHandler.set_reader() | リストコンテキスト用にドキュメントリーダーを設定する |
ListHandler.reset() | リストのトラッキング状態をリセットする |
ListHandler.get_list_info() | 段落のリスト項目詳細を取得する |
ListHandler.format_list_item() | マーカーとインデントを使用してリスト項目をフォーマットする |
ListHandler.break_list() | リストシーケンスの終了を示す |
ヒントとベストプラクティス
- コンバータはエクスポートパイプライン内部で使用されます — ほとんどの開発者は代わりに
Document.save()とやり取りします ParagraphConverter.format_text() はコードブロックのコンテキストを尊重し、コードスパン内でインライン書式が適用されるのを防ぎますListHandler は連続するリスト段落間で状態を保持します — 新しいドキュメントセクションを開始する際はreset() を呼び出してください
一般的な問題
| 問題 | 原因 | 修正 |
|---|
| テーブル列のずれ | 入力テーブルに結合セルがある | TableConverter はシンプルなテーブルを処理します；結合セルは予期しない出力になる可能性があります |
| リスト番号が壊れる | セクション間でリスト状態がリセットされていない | セクション境界で ListHandler.reset() を呼び出す |
API リファレンス概要
| Class / Method | Description |
|---|
ParagraphConverter.get_paragraph_info() | 段落の書式設定を抽出 |
ParagraphConverter.get_run_formatting() | ランレベルの書式設定を取得 |
ParagraphConverter.format_text() | テキストに書式設定を適用 |
TableConverter.convert() | テーブルを出力形式に変換 |
ListHandler.set_reader() | ドキュメントリーダーのコンテキストを設定 |
ListHandler.get_list_info() | リスト項目の詳細を取得 |
ListHandler.format_list_item() | リスト項目を書式設定 |
