Go 版本的 Pofile 解析器

Go 版本的 Gettext Pofile 解析器

前言

尝鲜派在2021年10月中旬开始支持多语言，最早的时候是通过小而美来和翻译者们沟通，每次发版本前都需要提前联系翻译者，且不方便多人协同翻译。到了2022年2月份的时候开始使用 Weblate 作为在线翻译平台，翻译者们只需要在平台上注册账号，即可协作翻译。但是因为前端语言插件的限制，按照默认的写法，只能每次编译前先从 Weblate 里下载 pofile，再编译上线，无法做到翻译在运行时修改，经过了一番改进，前端实现了 Runtime 从后端加载翻译，那么就需要将原来 pofile 通过 nodejs 的解析改为用 Go 进行解析，在搜索了一番开源社区后发现并没有满足我们要求的库，于是就有了 Pofile。

安装方式

go get github.com/0xJacky/pofile

或者从 Release 页面中下载编译好的二进制文件使用 CLI 模式进行解析。

功能特色

解析 Pofile 的头部参数到一个结构体，提供 Get 方法用于获取自定义的头部;
解析 Pofile 的元素，支持翻译者注释（Translator Comment），提取注释（Extracted Comment），Reference（引用），flags（标记），msgctxt, msgid，msgid_plural, msgstr 类型;
自动忽略标记中含有 fuzzy 的元素;
解析 pofile 为 map[string]interface{} 可以进一步解析为 JSON;
提供 CLI 模式用于解析 pofile(s)。

类型

Pofile

type Pofile struct {
	Header Header
	Items  []Item
}

Convert pofile to dict

func (p *Pofile) ToDict() (dict Dict)

Entry

func Parse(path string) (p *Pofile, err error)

Pofile Header Struct

type Header struct {
	ProjectIdVersion        string     `key:"Project-Id-Version"`
	ReportMsgBugsTo         string     `key:"Report-Msgid-Bugs-To"`
	POTCreationDate         *time.Time `key:"POT-Creation-Date"`
	PORevisionDate          *time.Time `key:"PO-Revision-Date"`
	LastTranslator          string     `key:"Last-Translator"`
	Language                string     `key:"Language"`
	LanguageTeam            string     `key:"Language-Team"`
	ContentType             string     `key:"Content-Type"`
	ContentTransferEncoding string     `key:"Content-Transfer-Encoding"`
	PluralForms             string     `key:"Plural-Forms"`
}

Visit custom header field

func (h *Header) Get(key string) interface{}

Profile item struct

type Item struct {
	TranslatorComments []string
	ExtractedComments  []string
	Reference          []string
	Flags              []string
	Msgctxt            string
	MsgId              string
	MsgIdPlural        string
	MsgStr             []string
}

CLI 模式

将单个 pofile 转换为 JSON

./pofile build --file <path-to-pofile>

转换目录下所有的 pofile 为一个 JSON

./pofile build --file <path-to-dir>