golangdoc/local 新接口设计

local.md

package local

// Default is the translations dir.
const (
	DefaultDir = "translations"     // 默认: $(RootFS)/translations
	DefaultEnv = "GODOC_LOCAL_ROOT" // 优先取环境变量, 支持多个目录
)

// Init initialize the translations environment.
func Init(goroot, gopath, translations string) {
	// goroot 和 translations 支持zip, 自动识别
}

// RootFS return root filesystem.
//
// RootFS:
//	/lib/godoc
//	/doc
//	/src
//	/blog
//	/talks
//	/tour
//	...
//
// Package:
//	/src/.../xxx_zh_CN.go
//	/src/...
//
// Blog:
//	/blog/content
//	/blog/static
//	/blog/template
//
// Talks:
//	/talks/content
//	/talks/static
//	/talks/template
//
// Tour:
//	/tour/content
//	/tour/static
//	/tour/template
func RootFS(lang string) vfs.FileSystem {
	// 固定了目录结构, godoc可以直接使用
	// 内部会屏蔽一些垃圾目录, 比如 src 目录下的 talks 目录
	// pkg 翻译追加到 src 目录, 可以直接查看 doc_zh_CN.go 文件
}

// Package translate Package doc.
func Package(lang, importPath string, pkg *doc.Package) *doc.Package {
	return nil
}