Pythonで文書に注釈を付ける: 文書マークアップのための2つの実証済み手法

# ❌ このアプローチは動作しません
import os
import sys

# coreclr を先にロード
from pythonnet import load
load("coreclr")

import clr

# ライブラリと依存関係があるフォルダーをシステムパスに追加
dll_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "dlls"))
sys.path.append(dll_dir)

# ライブラリへの参照を追加
clr.AddReference("GroupDocs.Annotation")
# ライセンスクラスをインポート
from GroupDocs.Annotation import License
lic = License()
lic.SetLicense("license.lic")

// C# ラッパー実装 (SimpleWrapper.cs)
using GroupDocs.Annotation.Models;
using GroupDocs.Annotation.Options;
using GroupDocs.Annotation.Models.AnnotationModels;

namespace GroupDocs.Annotation.Wrapper;

public static class SimpleWrapper
{
    public static void AddAnnotation(string inputPath, string outputPath)
    {
        Console.WriteLine("Start adding area annotation...");

        using (var annotator = new Annotator(inputPath))
        {
            var areaAnnotation = new AreaAnnotation
            {
                Box = new Rectangle(100, 100, 200, 50),
                BackgroundColor = 65535,
                CreatedOn = DateTime.Now,
                Message = "Sample annotation"
            };

            annotator.Add(areaAnnotation);
            annotator.Save(outputPath);
        }

        Console.WriteLine("Annotation added successfully!");
    }
}

# Python での使用例 (add_annotation_wrapper.py)
import os
import sys
import clr

# dlls ディレクトリをパスに追加
dll_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "dlls"))
sys.path.append(dll_dir)

# coreclr をロード
from pythonnet import load
load("coreclr")

# ラッパーへの参照を追加
clr.AddReference("GroupDocs.Annotation.Wrapper")

# ラッパークラスをインポート
from GroupDocs.Annotation.Wrapper import SimpleWrapper

# 簡易 API を使用
SimpleWrapper.AddAnnotation("files/resume.docx", "files/annotated.docx")

# 手動型解決 (add_annotation_manual.py)
import os
import sys
import clr

# dlls ディレクトリをパスに追加
dll_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "dlls"))
sys.path.append(dll_dir)

# coreclr をロード
from pythonnet import load
load("coreclr")

# 依存関係解決用にラッパーを参照追加
clr.AddReference("GroupDocs.Annotation.Wrapper")

# 本体ライブラリを参照追加
clr.AddReference("GroupDocs.Annotation")

# リフレクション用に System をインポート
import System
from System import Type, Activator, Array

# Annotator 型をリフレクションで取得
annotator_type = Type.GetType("GroupDocs.Annotation.Annotator, GroupDocs.Annotation")

# Annotator インスタンスを作成
input_path = "files/resume.docx"
annotator_instance = Activator.CreateInstance(annotator_type, input_path)

# 注釈型を取得
area_annotation_type = Type.GetType("GroupDocs.Annotation.Models.AnnotationModels.AreaAnnotation, GroupDocs.Annotation")
rectangle_type = Type.GetType("GroupDocs.Annotation.Models.Rectangle, GroupDocs.Annotation")

# 注釈用矩形を作成
rectangle_instance = Activator.CreateInstance(rectangle_type, 100, 100, 200, 50)

# エリア注釈を作成
area_annotation = Activator.CreateInstance(area_annotation_type)
area_annotation.Box = rectangle_instance
area_annotation.BackgroundColor = 65535
area_annotation.CreatedOn = System.DateTime.Now
area_annotation.Message = "Manual annotation"

# 注釈を追加
add_method = annotator_type.GetMethod("Add")
add_method.Invoke(annotator_instance, [area_annotation])

# 文書を保存
save_method = annotator_type.GetMethod("Save")
save_method.Invoke(annotator_instance, ["files/annotated_manual.docx"])

print("Manual annotation added successfully!")

# カスタムスタイル付き高度な注釈例
def advanced_annotation_example():
    # TextAnnotation 型を取得
    text_annotation_type = Type.GetType("GroupDocs.Annotation.Models.AnnotationModels.TextAnnotation, GroupDocs.Annotation")
    text_annotation = Activator.CreateInstance(text_annotation_type)
    
    # テキスト注釈のプロパティを設定
    text_annotation.Box = rectangle_instance
    text_annotation.Text = "Important note"
    text_annotation.FontColor = 16711680  # 赤色
    text_annotation.FontSize = 14
    text_annotation.FontFamily = "Arial"
    text_annotation.CreatedOn = System.DateTime.Now
    text_annotation.Message = "Custom styled annotation"
    
    # 複数の注釈タイプを追加
    add_method.Invoke(annotator_instance, [text_annotation])
    
    # 矢印注釈を作成
    arrow_annotation_type = Type.GetType("GroupDocs.Annotation.Models.AnnotationModels.ArrowAnnotation, GroupDocs.Annotation")
    arrow_annotation = Activator.CreateInstance(arrow_annotation_type)
    arrow_annotation.StartPoint = System.Drawing.Point(50, 50)
    arrow_annotation.EndPoint = System.Drawing.Point(150, 100)
    arrow_annotation.StrokeColor = 65280  # 緑色
    arrow_annotation.StrokeWidth = 2
    
    add_method.Invoke(annotator_instance, [arrow_annotation])
    
    return annotator_instance

# Python 3.11 仮想環境を作成
py -3.11 -m venv venv311

# 仮想環境を有効化 (Windows)
venv311\Scripts\activate

# Python バージョンを確認
python --version

# pip と必須ツールを最新化
python -m ensurepip --upgrade
python -m pip install --upgrade pip setuptools wheel

# pythonnet 3.0.5 をインストール
python -m pip install pythonnet==3.0.5

# プロジェクトの要件をインストール
pip install -r requirements.txt

# ラッパーディレクトリへ移動
cd wrapper

# ラッパーをビルド・公開
dotnet publish -c Release -r win-x64 --self-contained false -o ./../dlls

# ルートディレクトリに戻る
cd ..

# 仮想環境を再度有効化 (必要なら)
.venv\Scripts\activate

# ラッパー方式を実行
python add_annotation_wrapper.py

# 手動型解決方式を実行
python add_annotation_manual.py