Hugo Theme Diary 使用教程

1. 项目目录结构及介绍

hugo-theme-diary 是一个基于 Hugo 的博客主题，它提供了简洁、优雅的界面和丰富的自定义选项。以下是项目的目录结构及介绍：

hugo-theme-diary/
├── archetypes/             # 包含默认的 archetype 文件
├── assets/                # 存储静态资源，如 SCSS 文件
├── docs/                  # 文档目录
├── exampleSite/           # 主题的示例站点
├── i18n/                  # 国际化文件
├── images/                # 存储图片文件
├── layouts/               # 包含 Hugo 的布局文件
├── resources/             # 存储生成静态资源的脚本
├── static/                # 存储静态文件，如 CSS、JavaScript 等
├── theme.toml             # 主题配置文件
└── ...

• archetypes/: 包含了 Hugo 项目的默认 archetype 文件，用于创建新的内容文件。
• assets/: 存储 SCSS 文件，用于主题的样式定制。
• docs/: 主题的文档目录，包含了主题的相关说明和使用指南。
• exampleSite/: 主题的示例站点，展示了如何使用该主题创建一个 Hugo 站点。
• i18n/: 国际化文件，用于支持不同语言的显示。
• images/: 存储主题使用的图片文件。
• layouts/: 包含了 Hugo 的布局文件，定义了页面的结构和内容。
• resources/: 包含生成静态资源的脚本。
• static/: 存储静态文件，如 CSS、JavaScript 等。
• theme.toml: 主题的配置文件，用于定义主题的元数据。

2. 项目的启动文件介绍

要启动 Hugo 主题，你需要在 Hugo 站点的根目录下运行以下命令：

git submodule add https://github.com/AmazingRise/hugo-theme-diary.git themes/diary

这将添加主题作为子模块到你的 Hugo 站点中。然后，你可以使用以下命令启动 Hugo 服务器：

hugo server --themesDir ./themes

这将在本地启动 Hugo 服务器，并使用 themes/diary 目录下的主题。

3. 项目的配置文件介绍

主题的配置文件是 theme.toml，位于主题的根目录。以下是配置文件的示例：

homepage = "https://amazingrise.net/"
tags = ["blog"]
features = ["mobile", "elegant"]
min_version = "0.59.0"

• homepage: 主题的官方主页。
• tags: 主题的关键字标签。
• features: 主题的主要特性。
• min_version: Hugo 的最低版本要求。

此外，你可以在 exampleSite/config.toml 文件中找到更多关于如何配置主题的示例。这个文件包含了所有可配置的选项，包括侧边栏、评论系统、分析工具等。你需要根据你的需求修改这个配置文件，并将其复制到你的 Hugo 站点的根目录下。

# exampleSite/config.toml

[params]
# 主题名称
title = "我的博客"
# 网站描述
description = "这里是我的博客，分享我的思考和见解。"
# 网站关键字
keywords = ["博客", "技术", "思考"]
# ...

确保在修改配置后重新启动 Hugo 服务器，以应用新的配置设置。