Gorazor 项目使用教程

1. 项目目录结构及介绍

Gorazor 是一个 Go 语言的模板引擎，其目录结构如下：

gorazor/
├── docs/              # 文档目录
├── examples/          # 示例代码目录
│   └── tpl/           # 模板文件目录
├── gorazor/           # Gorazor 的核心代码包
├── pkg/               # 编译后的包文件
├── tests/             # 测试代码目录
├── .gitignore         # Git 忽略文件
├── .travis.yml        # Travis CI 配置文件
├── LICENSE            # 许可证文件
├── Makefile           # Makefile 文件
├── README.md          # 项目说明文件
├── go.mod             # Go 模块定义文件
└── go.sum             # Go 模块校验文件

• docs/：存放项目文档。
• examples/：包含了一些使用 Gorazor 的示例代码。
• gorazor/：Gorazor 的核心代码。
• pkg/：编译后生成的包文件。
• tests/：包含单元测试代码。
• .gitignore：配置 Git 忽略规则。
• .travis.yml：配置 Travis CI 进行自动化测试。
• LICENSE：项目的许可证信息。
• Makefile：项目的 Makefile 文件，用于构建项目。
• README.md：项目的说明文档。
• go.mod 和 go.sum：Go 模块依赖管理文件。

2. 项目的启动文件介绍

Gorazor 的启动文件通常是 main.go 文件，它位于项目的根目录。以下是 main.go 文件的基本结构：

package main

import (
    "fmt"
    "github.com/sipin/gorazor"
)

func main() {
    // 初始化模板引擎
    tmpl, err := gorazor.New()
    if err != nil {
        panic(err)
    }

    // 加载模板
    if err := tmpl.Load("templates"); err != nil {
        panic(err)
    }

    // 执行模板
    if err := tmpl.Execute("index.html", data); err != nil {
        panic(err)
    }
}

在 main.go 文件中，首先导入必要的包，然后在 main 函数中初始化 Gorazor 引擎，加载模板文件，并执行模板。

3. 项目的配置文件介绍

Gorazor 的配置通常是直接在代码中完成的，而不是通过外部的配置文件。然而，你可以使用 Makefile 或者环境变量来控制一些编译时的行为。

例如，在 Makefile 中，你可以定义不同的编译目标：

.PHONY: build run

build:
	go build -o gorazor main.go

run:
	go run main.go

在这个 Makefile 文件中，build 目标会编译 main.go 生成可执行文件 gorazor，而 run 目标会直接运行 main.go 文件。

如果你需要更复杂的配置，你可能需要编写自己的配置加载逻辑，将这些配置存储在如 JSON、YAML 或 TOML 文件中，并在程序启动时加载它们。