Hexo 主题 Snippet 使用教程

2024-08-21 22:40:24作者：晏闻田Solitary

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

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

hexo-theme-snippet/
├── _config.yml
├── languages/
├── layout/
├── scripts/
├── source/
└── package.json

_config.yml: 主题的主配置文件。
languages/: 存放多语言支持的文件。
layout/: 存放主题的模板文件，如 index.ejs, post.ejs 等。
scripts/: 存放自定义脚本文件。
source/: 存放主题的静态资源文件，如 CSS, JavaScript, 图片等。
package.json: 项目的依赖管理文件。

2. 项目的启动文件介绍

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

_config.yml: 这是主题的核心配置文件，包含了主题的各种设置，如导航菜单、侧边栏、社交链接等。
layout/index.ejs: 这是主页的模板文件，定义了主页的布局和内容。
layout/post.ejs: 这是文章页的模板文件，定义了文章页的布局和内容。

3. 项目的配置文件介绍

Hexo 主题 Snippet 的配置文件主要是 _config.yml。以下是一些关键配置项的介绍：

# 基本配置
title: 网站标题
subtitle: 网站副标题
description: 网站描述
keywords: 网站关键词
author: 作者名
language: 语言
timezone: 时区

# 导航菜单
menu:
  Home: /
  Archives: /archives
  Categories: /categories
  Tags: /tags
  About: /about

# 侧边栏
sidebar:
  position: right
  display: post

# 社交链接
social:
  GitHub: https://github.com/yourusername
  Twitter: https://twitter.com/yourusername
  Email: mailto:yourname@example.com

title, subtitle, description, keywords, author, language, timezone: 这些是网站的基本信息。
menu: 定义导航菜单的链接和名称。
sidebar: 配置侧边栏的位置和显示方式。
social: 配置社交链接。