Go-Fitz 项目教程

1. 项目的目录结构及介绍

Go-Fitz 是一个 Golang 包装器，用于 MuPDF 的 Fitz 库。以下是项目的目录结构及其介绍：

go-fitz/
├── LICENSE
├── README.md
├── fitz.go
├── fitz_cgo.go
├── fitz_content_types.go
├── go.mod
├── go.sum
└── examples/
    ├── convert.go
    ├── extract.go
    └── thumbnail.go

• LICENSE: 项目的许可证文件，采用 AGPL-3.0 许可证。
• README.md: 项目的介绍和使用说明。
• fitz.go: 主文件，包含主要的 API 接口。
• fitz_cgo.go: CGO 相关的代码文件。
• fitz_content_types.go: 处理内容类型的文件。
• go.mod 和 go.sum: Go 模块文件，用于依赖管理。
• examples/: 示例代码目录，包含转换、提取和生成缩略图的示例。

2. 项目的启动文件介绍

项目的启动文件是 fitz.go，它包含了主要的 API 接口，用于与 Fitz 库进行交互。以下是 fitz.go 文件的部分代码示例：

package fitz

/*
#cgo pkg-config: mupdf
#include "fitz-internal.h"
*/
import "C"
import (
	"errors"
	"runtime"
	"unsafe"
)

type Document struct {
	ctx    *C.struct_fz_context_s
	doc    *C.struct_fz_document_s
	stream []byte
}

func New(filename string) (*Document, error) {
	var ctx *C.struct_fz_context_s
	var doc *C.struct_fz_document_s
	var stream []byte

	ctx = C.fz_new_context(nil, nil, C.FZ_STORE_UNLIMITED)
	if ctx == nil {
		return nil, errors.New("cannot create context")
	}

	C.fz_register_document_handlers(ctx)

	cfilename := C.CString(filename)
	defer C.free(unsafe.Pointer(cfilename))

	doc = C.fz_open_document(ctx, cfilename)
	if doc == nil {
		C.fz_drop_context(ctx)
		return nil, errors.New("cannot open document")
	}

	return &Document{ctx: ctx, doc: doc, stream: stream}, nil
}

3. 项目的配置文件介绍

Go-Fitz 项目主要依赖于 go.mod 文件进行依赖管理。以下是 go.mod 文件的内容示例：

module github.com/gen2brain/go-fitz

go 1.15

require (
	github.com/gen2brain/go-fitz v1.23.7
)

go.mod 文件定义了模块的名称和所需的依赖版本。通过这个文件，Go 工具链可以自动管理项目的依赖关系。

---

以上是 Go-Fitz 项目的教程，包含了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你更好地理解和使用 Go-Fitz 项目。