使用 Python 進行文件註釋：兩種經驗證的文件標記方法

# ❌ This approach WILL NOT work
import os
import sys

# Load coreclr first
from pythonnet import load
load("coreclr")

import clr

# Add folder with the library and dependencies to the system path
dll_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "dlls"))
sys.path.append(dll_dir)

# Add reference to the library
clr.AddReference("GroupDocs.Annotation")
# Import the license class
from GroupDocs.Annotation import License
lic = License()
lic.SetLicense("license.lic")

// C# Wrapper Implementation (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 Usage (add_annotation_wrapper.py)
import os
import sys
import clr

# Add the dlls directory to the path
dll_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "dlls"))
sys.path.append(dll_dir)

# Load coreclr
from pythonnet import load
load("coreclr")

# Add reference to the wrapper
clr.AddReference("GroupDocs.Annotation.Wrapper")

# Import the wrapper class
from GroupDocs.Annotation.Wrapper import SimpleWrapper

# Use the simplified API
SimpleWrapper.AddAnnotation("files/resume.docx", "files/annotated.docx")

# Manual Type Resolution (add_annotation_manual.py)
import os
import sys
import clr

# Add the dlls directory to the path
dll_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "dlls"))
sys.path.append(dll_dir)

# Load coreclr
from pythonnet import load
load("coreclr")

# Add reference to the wrapper (for dependency resolution)
clr.AddReference("GroupDocs.Annotation.Wrapper")

# Now add reference to the main library
clr.AddReference("GroupDocs.Annotation")

# Import System for reflection
import System
from System import Type, Activator, Array

# Get the Annotator type using reflection
annotator_type = Type.GetType("GroupDocs.Annotation.Annotator, GroupDocs.Annotation")

# Create annotator instance
input_path = "files/resume.docx"
annotator_instance = Activator.CreateInstance(annotator_type, input_path)

# Get annotation types
area_annotation_type = Type.GetType("GroupDocs.Annotation.Models.AnnotationModels.AreaAnnotation, GroupDocs.Annotation")
rectangle_type = Type.GetType("GroupDocs.Annotation.Models.Rectangle, GroupDocs.Annotation")

# Create rectangle for annotation
rectangle_instance = Activator.CreateInstance(rectangle_type, 100, 100, 200, 50)

# Create area annotation
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 annotation
add_method = annotator_type.GetMethod("Add")
add_method.Invoke(annotator_instance, [area_annotation])

# Save annotated document
save_method = annotator_type.GetMethod("Save")
save_method.Invoke(annotator_instance, ["files/annotated_manual.docx"])

print("Manual annotation added successfully!")

# Advanced annotation with custom styling
def advanced_annotation_example():
    # Get TextAnnotation type
    text_annotation_type = Type.GetType("GroupDocs.Annotation.Models.AnnotationModels.TextAnnotation, GroupDocs.Annotation")
    text_annotation = Activator.CreateInstance(text_annotation_type)
    
    # Configure text annotation properties
    text_annotation.Box = rectangle_instance
    text_annotation.Text = "Important note"
    text_annotation.FontColor = 16711680  # Red color
    text_annotation.FontSize = 14
    text_annotation.FontFamily = "Arial"
    text_annotation.CreatedOn = System.DateTime.Now
    text_annotation.Message = "Custom styled annotation"
    
    # Add multiple annotation types
    add_method.Invoke(annotator_instance, [text_annotation])
    
    # Create arrow 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  # Green color
    arrow_annotation.StrokeWidth = 2
    
    add_method.Invoke(annotator_instance, [arrow_annotation])
    
    return annotator_instance

# Create Python 3.11 virtual environment
py -3.11 -m venv venv311

# Activate virtual environment (Windows)
venv311\Scripts\activate

# Verify Python version
python --version

# Upgrade pip and essential tools
python -m ensurepip --upgrade
python -m pip install --upgrade pip setuptools wheel

# Install pythonnet 3.0.5
python -m pip install pythonnet==3.0.5

# Install project requirements
pip install -r requirements.txt

# Navigate to wrapper directory
cd wrapper

# Build and publish the wrapper
dotnet publish -c Release -r win-x64 --self-contained false -o ./../dlls

# Return to root directory
cd ..

# Activate virtual environment (if not already active)
.venv\Scripts\activate

# Run wrapper-based approach
python add_annotation_wrapper.py

# Run manual type resolution approach
python add_annotation_manual.py