Hexo 主题 Minima 使用教程

Hexo 主题 Minima 使用教程

hexo-theme-minimaAn undoubtedly simple and lightweight dark/light theme for Hexo.js项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-minima

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

Hexo 主题 Minima 的目录结构如下：

hexo-theme-minima/
├── layout/
│   ├── _partial/
│   ├── category.ejs
│   ├── index.ejs
│   ├── page.ejs
│   ├── post.ejs
│   └── tag.ejs
├── source/
│   ├── css/
│   ├── images/
│   ├── js/
│   └── README.md
├── _config.yml
├── .gitignore
├── LICENSE
├── package.json
└── README.md

• layout/: 包含主题的模板文件，如文章、页面、分类、标签等。
• source/: 包含主题的静态资源，如 CSS、JavaScript、图片等。
• _config.yml: 主题的配置文件。
• .gitignore: Git 忽略文件。
• LICENSE: 主题的许可证文件。
• package.json: 主题的依赖管理文件。
• README.md: 主题的说明文档。

2. 项目的启动文件介绍

Hexo 主题 Minima 的启动文件主要是 _config.yml 和 layout/ 目录下的模板文件。

• _config.yml: 这是主题的主要配置文件，包含了主题的各种设置，如网站标题、描述、作者信息、导航菜单等。
• layout/: 这个目录包含了主题的所有模板文件，如首页、文章页、标签页等。这些模板文件使用 EJS 模板引擎编写，可以根据需要进行修改。

3. 项目的配置文件介绍

Hexo 主题 Minima 的配置文件是 _config.yml，以下是一些主要的配置项：

# Site
title: 网站标题
subtitle: 网站副标题
description: 网站描述
author: 作者名
language: 语言
timezone: 时区

# URL
url: 网站URL
root: 网站根目录

# Writing
new_post_name: :title.md # 新文章的文件名格式
default_layout: post

# Category & Tag
default_category: uncategorized
category_map:
tag_map:

# Archives
archive_generator:
  per_page: 10
  yearly: true
  monthly: true
  daily: false

# Pagination
per_page: 10
pagination_dir: page

# Extensions
theme: minima

# Deployment
deploy:
  type: git
  repo: 仓库地址
  branch: 分支名

• Site: 配置网站的基本信息，如标题、副标题、描述、作者等。
• URL: 配置网站的 URL 和根目录。
• Writing: 配置新文章的文件名格式和默认布局。
• Category & Tag: 配置默认分类和标签。
• Archives: 配置归档页面的生成规则。
• Pagination: 配置分页规则。
• Extensions: 配置使用的主题。
• Deployment: 配置网站的部署方式。

通过修改 _config.yml 文件，可以自定义主题的各种设置，以满足不同的需求。

hexo-theme-minimaAn undoubtedly simple and lightweight dark/light theme for Hexo.js项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-minima