Pugo 项目启动与配置教程

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

Pugo 是一个用 Go 语言编写的静态站点生成器。以下是 Pugo 项目的主要目录结构及其介绍：

pugo/
├── cmd/             # 包含 main 应用程序代码
│   └── pugo/         # pugo 命令的主入口
├── docs/            # 项目文档
├── internal/        # 包含项目内部模块，如处理页面、模板等
│   ├── engine/       # 核心逻辑，包括网站生成和处理
│   ├── middleware/  # 中间件，用于处理 HTTP 请求
│   ├── models/       # 数据模型
│   └── router/       # 路由处理
├── scripts/         # 脚本文件，用于构建、测试等
├── test/            # 测试代码
├── themes/          # 主题目录，包含多个主题
├── tools/           # 辅助工具
├── web/             # 网页静态资源，如 CSS、JavaScript 和图片
├── go.mod            # Go 依赖管理文件
└── README.md        # 项目说明文件

2. 项目的启动文件介绍

Pugo 项目的启动文件位于 cmd/pugo/main.go。以下是启动文件的主要内容：

package main

import (
    "flag"
    "os"
    "os/signal"
    "syscall"

    "github.com/go-xiaohei/pugo/internal/pugo"
)

func main() {
    // 解析命令行参数
    flag.Parse()

    // 创建并启动 Pugo 服务器
    p := pugo.New()
    if err := p.Run(); err != nil {
        os.Exit(1)
    }

    // 处理信号
    c := make(chan os.Signal, 1)
    signal.Notify(c, syscall.SIGINT, syscall.SIGTERM)
    <-c
    p.Close()
}

该文件主要做了以下几件事：

• 解析命令行参数
• 创建并启动 Pugo 服务器实例
• 处理系统信号，如中断和终止信号

3. 项目的配置文件介绍

Pugo 项目的配置文件通常位于项目根目录下的 config.yaml。以下是配置文件的一个示例：

site:
  title: "我的博客"
  description: "这是我的个人博客，分享技术心得。"
  theme: "default"
  languageCode: "zh-CN"
  baseURL: "https://www.example.com"

server:
  port: 4000
  timeout: 60
  staticDir: "web"

build:
  permalink: ":year/:month/:day/:title.html"
  paginate:
    page_size: 5

media:
  images:
    - name: "example.jpg"
      src: "path/to/example.jpg"

配置文件主要包括以下部分：

• site：网站的基本信息，如标题、描述、主题、语言代码和基本 URL。
• server：服务器设置，包括端口号、超时时间和静态资源目录。
• build：构建设置，包括文章的永久链接格式和分页大小。
• media：媒体设置，可以添加图片等资源。