Web Analytics

hwpers

⭐ 179 stars Simplified Chinese by Indosaram

hwpers

Crates.io Documentation CI License

一个用于解析韩国韩文文字处理器（HWP）文件的 Rust 库，支持完整的布局渲染。

功能

解析器（读取 HWP 文件）

写入器（创建 HWP 文件）- v0.3.0+

快速开始

将以下内容添加到你的 Cargo.toml：

[dependencies]
hwpers = "0.3"

基本用法

use hwpers::HwpReader;
// Parse an HWP file
let document = HwpReader::from_file("document.hwp")?;
// Extract text content
let text = document.extract_text();
println!("{}", text);
// Access document properties
if let Some(props) = document.get_properties() {
    println!("Pages: {}", props.total_page_count);
}
// Iterate through sections and paragraphs
for (i, section) in document.sections().enumerate() {
    println!("Section {}: {} paragraphs", i, section.paragraphs.len());
    
    for paragraph in §ion.paragraphs {
        if let Some(text) = ¶graph.text {
            println!("  {}", text.content);
        }
    }
}

可视布局渲染

use hwpers::{HwpReader, render::{HwpRenderer, RenderOptions}};
let document = HwpReader::from_file("document.hwp")?;
// Create renderer with custom options
let options = RenderOptions {
    dpi: 96,
    scale: 1.0,
    show_margins: false,
    show_baselines: false,
};
let renderer = HwpRenderer::new(&document, options);
let result = renderer.render();
// Export first page to SVG
if let Some(svg) = result.to_svg(0) {
    std::fs::write("page1.svg", svg)?;
}
println!("Rendered {} pages", result.pages.len());

创建文档（v0.3.0+）

use hwpers::writer::HwpWriter;
use hwpers::model::hyperlink::Hyperlink;
// Create a new document
let mut writer = HwpWriter::new();
// Add formatted text
writer.add_aligned_paragraph(
    "제목",
    hwpers::writer::style::ParagraphAlignment::Center
)?;
// Add hyperlinks
let link = Hyperlink::new_url("Rust", "https://rust-lang.org");
writer.add_paragraph_with_hyperlinks(
    "Visit Rust website",
    vec![link]
)?;
// Configure page layout
writer.set_custom_page_size(210.0, 297.0, // A4 size
    hwpers::model::page_layout::PageOrientation::Portrait)?;
writer.set_page_margins_mm(20.0, 20.0, 20.0, 20.0);
// Add header and footer
writer.add_header("Document Header");
writer.add_footer_with_page_number("Page ", 
    hwpers::model::header_footer::PageNumberFormat::Numeric);
// Save the document
writer.save_to_file("output.hwp")?;

高级格式访问

// Access character and paragraph formatting
for section in document.sections() {
    for paragraph in §ion.paragraphs {
        // Get paragraph formatting
        if let Some(para_shape) = document.get_para_shape(paragraph.para_shape_id as usize) {
            println!("Indent: {}, Alignment: {}", 
                para_shape.indent, 
                para_shape.get_alignment()
            );
        }
        
        // Get character formatting runs
        if let Some(char_shapes) = ¶graph.char_shapes {
            for pos_shape in &char_shapes.char_positions {
                if let Some(char_shape) = document.get_char_shape(pos_shape.char_shape_id as usize) {
                    println!("Position {}: Size {}, Bold: {}", 
                        pos_shape.position,
                        char_shape.base_size / 100,
                        char_shape.is_bold()
                    );
                }
            }
        }
    }
}

支持的功能

文档结构

内容类型

布局和渲染

高级功能

命令行工具

该库包含一个用于检查HWP文件的命令行工具：

# Install the tool
cargo install hwpers
Inspect an HWP file

hwp_info document.hwp

格式支持

本库支持 HWP 5.0 格式文件。对于更早版本的 HWP 格式，建议先使用格式转换工具。

写入器功能（v0.3.0+）

HWP 写入器功能得到了显著提升，支持全面的功能特性：

✅ 完全实现

❌ 尚未实现

🔧 已知问题

贡献

欢迎贡献！请随时提交 Pull Request。对于重大更改，请先开启 issue 以讨论您想要更改的内容。

许可证

本项目授权协议为以下任意一种

由您选择。

致谢

--- Tranlated By Open Ai Tx | Last indexed: 2026-03-13 ---

Original README: View on GitHub

Translated by OpenAiTx | Last updated: 2026-03-13