OFD Converter

一个用于将 OFD 文件转换为 PDF、纯文本和图像格式的 Go 语言工具包。

功能特性

类别	功能
文档转换	OFD 转 PDF、纯文本和 PNG/JPG 等图像格式
页面处理	支持多文档体、多页面转换，按文档体顺序合并并使用全局页码
灵活配置	支持自定义 DPI、背景颜色和页面选择
OFD 校验	提供基于 OFD-Schema 的 ZIP、XML、引用和 XSD 校验命令
处理性能	基于 Go 语言开发，支持高效处理

安装

go get github.com/zc310/ofd

命令行程序打包

根目录 Makefile 可以将命令行程序分别编译并打包为独立 ZIP 文件。ofd-thumbnailer 仅编译 Linux 版本：

# 生成 dist/ofd-viewer-linux-amd64.zip
# 生成 dist/ofd-converter-linux-amd64.zip
# 生成 dist/ofd-thumbnailer-linux-amd64.zip
make package

单独构建 OFD 校验工具：

make package-validator

Linux 下会生成四个 ZIP；Windows 和 macOS 下会生成 ofd-viewer、ofd-converter 和 ofd-validator 三个 ZIP，不会编译 ofd-thumbnailer。

每个 ZIP 包都包含对应的二进制文件和 README。ofd-thumbnailer 的安装包还包含 ofd.thumbnailer；Linux 安装包额外包含 install.sh，解压后可执行：

cd ofd-thumbnailer
sudo ./install.sh

可以通过 GOOS、GOARCH 和 CGO_ENABLED 指定目标平台，例如：

GOOS=linux GOARCH=amd64 CGO_ENABLED=1 make package

Windows 交叉编译示例：

# Debian/Ubuntu
sudo apt install gcc-mingw-w64-x86-64

GOOS=windows CGO_ENABLED=1 GOARCH=amd64 make package

Windows 目标必须使用 MinGW-w64，不能使用 Linux 的 gcc。如果交叉编译器不在默认路径，可以显式指定：

CC=x86_64-w64-mingw32-gcc GOOS=windows CGO_ENABLED=1 GOARCH=amd64 make package

Fyne 查看器需要目标平台的图形开发库。Windows 版查看器使用 -H=windowsgui 编译，不显示命令行窗口。

Flatpak

仓库根目录包含 io.github.zc310.ofd.json 及其桌面集成文件，可用于构建 OFD Viewer 的 Flatpak 包。构建依赖已通过 go.mod.json 和 modules.txt 固定，避免 Flatpak 构建阶段联网下载 Go 模块。

flatpak run org.flatpak.Builder --user --install --force-clean --disable-rofiles-fuse build-dir io.github.zc310.ofd.json
flatpak run io.github.zc310.ofd

正式提交 Flathub 前，需要将 manifest 中的源码 commit 更新为包含当前 Flatpak 文件的 v0.0.5 发布 commit，并在本机安装 flatpak-builder、appstreamcli 后完成元数据检查。

Flatpak 版本以只读方式访问真实的 ~/.local/share/fonts 用户字体目录和宿主机系统目录（host-os），用于渲染未内嵌字体的 OFD 文档。

快速开始

OFD 文件校验

校验工具位于 cmd/ofd-validator。它检查 OFD ZIP 容器、XML 命名空间、包内文件引用、语义 ID、摘要， 并使用通过 go:embed 内置的 OFD-Schema XSD。运行时不依赖 xmllint、外部模式文件或网络：

go run ./cmd/ofd-validator --format text test/testdata/helloworld.ofd

报告支持文本、Markdown、JSON 和 PDF 四种格式：

go run ./cmd/ofd-validator --format json --pretty test/testdata/helloworld.ofd > report.json
go run ./cmd/ofd-validator --format markdown -o report.md test/testdata/helloworld.ofd
go run ./cmd/ofd-validator --format pdf --font /path/to/SimSun.ttf \
  -o report.pdf test/testdata/helloworld.ofd

默认使用 strict 模式；compat 模式会将 XSD 错误降级为警告，structural 模式跳过 XSD。 使用 --skip-xsd 等价于 structural 模式。报告正文和 CLI 提示使用中文，JSON 同时保留机器可读 的英文枚举和 *_zh 中文字段。退出码 0 表示没有错误，1 表示存在校验错误（使用 --fail-on-warning 时警告也会导致退出码 1），2 表示工具配置或输入错误。

OFD 文件可以包含多个文档体。转换器和查看器按 DocBody 出现顺序合并页面，Page(n) 和命令行 -page n 使用合并后的全局页码。

OFD 转 PDF

package main

import (
    "os"
    "github.com/zc310/ofd/pkg/converter"
)

func main() {
    output, _ := os.Create("output.pdf")
    defer output.Close()
    
    err := converter.PDF("input.ofd", output)
    if err != nil {
        panic(err)
    }
}

OFD 转图像

转换为 PNG

err := converter.Image("input.ofd",
    converter.Writer(func(page int) (io.WriteCloser, error) {
        return os.Create(fmt.Sprintf("output_%d.png", page))
    }),
    converter.BgColor(color.White),
    converter.PNG(),
)

OFD 转纯文本

纯文本转换只提取文字内容，不保留字体、颜色和页面布局。不同文字对象按行输出，不同页面使用分页符分隔。

import "bytes"

var output bytes.Buffer
err := converter.Text("input.ofd", &output)

转换为 JPG

err := converter.Image("input.ofd",
    converter.Writer(func(page int) (io.WriteCloser, error) {
        return os.Create(fmt.Sprintf("output_%d.jpg", page))
    }),
    converter.BgColor(color.White),
    converter.JPG(),
    converter.Page(3),        // 指定全局第 3 页
    converter.DPI(300),       // 设置输出分辨率
)

注意事项

• 背景颜色默认为白色，可根据需要调整
• 支持效果见 input.ofd 转换结果
• 不支持 OFD 文件内字体
• 不支持 GBT 33190-2016 很多标准😅。。。

特别感谢

本项目的开发离不开以下开源项目的启发和帮助：

• 国家标准化管理委员会发布的 GB/T 33190-2016 标准
• https://github.com/GreenYun/OFD-Schema
• https://github.com/itlabers/ofd-go-reference
• https://github.com/itlabers/ofd-go
• https://github.com/xiaoqidun/ofdgo

感谢所有为开源社区做出贡献的开发者！