Mindre 主题配置指南

1. 项目目录结构及介绍

mindre-theme 的目录结构如下：

mindre-theme/
├── assets/          # 存放静态资源，如图片、样式表、脚本等
│   ├── css/
│   ├── img/
│   └── js/
├── layouts/         # 主题的布局文件，定义了页面的基本结构
│   ├── default.html # 默认布局
│   └── ...
├── templates/       # 页面模板文件，用于生成具体的页面内容
│   ├── index.html   # 主页模板
│   └── ...
├── themes/          # 主题自定义样式和脚本
│   ├── css/
│   └── js/
├── config.toml      # 项目的配置文件
└── ...

• assets/：包含所有的静态资源，如CSS文件、JavaScript文件以及图片等。
• layouts/：包含主题的布局文件，这些HTML文件定义了页面结构，可以在其中嵌入不同的页面模板。
• templates/：包含主题的模板文件，这些文件定义了页面的具体内容，如文章列表、单个文章页面等。
• themes/：包含主题的自定义样式和脚本，用于进一步个性化主题。

2. 项目的启动文件介绍

mindre-theme 的启动主要通过配置文件 config.toml 来完成。该文件定义了项目的各种设置，包括网站的基本信息、主题设置、菜单、侧边栏等。

在 config.toml 文件中，你可以设置如下内容：

title = "Mindre Theme"
description = "An elegant theme for Hugo"
languageCode = "zh-CN"
paginate = 5

[params]
    theme = "mindre"
    ...

以上示例设置了网站标题、描述、语言代码以及每页文章数量等基本配置。

3. 项目的配置文件介绍

config.toml 文件是项目的配置文件，以下是常见配置项的介绍：

• title：网站标题，显示在浏览器标签和网站首页等位置。
• description：网站描述，通常用于SEO优化。
• languageCode：网站使用的语言代码，如 "zh-CN" 表示简体中文。
• paginate：每页显示的文章数量。
• [params]：自定义参数，用于设置主题的特定选项，如主题名称。

在配置文件中，你还可以定义菜单、侧边栏、社交媒体链接等，以下是一个扩展的配置文件示例：

title = "Mindre Theme"
description = "An elegant theme for Hugo"
languageCode = "zh-CN"
paginate = 5

[menu]
  [[menu.main]]
    name = "首页"
    url = "/"
    weight = 1

  [[menu.main]]
    name = "文章"
    url = "/posts/"
    weight = 2

  [[menu.main]]
    name = "关于"
    url = "/about/"
    weight = 3

[params]
    theme = "mindre"
    author = "Your Name"
    social = ["twitter", "github", "linkedin"]
    ...

通过配置文件，你可以轻松地定制化你的 mindre-theme 网站，以适应你的需求。