Hexo 主题 Hollow 使用教程

Hexo 主题 Hollow 使用教程

hexo-theme-hollowA pure and elegant theme for Hexo.项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-hollow

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

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

hexo-theme-hollow/
├── _config.yml
├── languages/
├── layout/
│   ├── _partial/
│   ├── _widget/
│   ├── archive.ejs
│   ├── category.ejs
│   ├── index.ejs
│   ├── page.ejs
│   ├── post.ejs
│   └── tag.ejs
├── scripts/
├── source/
│   ├── css/
│   ├── fonts/
│   ├── images/
│   └── js/
└── package.json

目录结构介绍

• _config.yml: 主题的配置文件。
• languages/: 存放多语言支持的文件。
• layout/: 存放页面布局文件，包括部分模板和页面模板。
• scripts/: 存放自定义脚本文件。
• source/: 存放静态资源文件，如 CSS、字体、图片和 JavaScript 文件。
• package.json: 项目的依赖管理文件。

2. 项目的启动文件介绍

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

_config.yml

这是主题的主要配置文件，包含了主题的各种设置，如网站标题、描述、作者信息、导航菜单、侧边栏设置等。

layout/ 目录

• layout/index.ejs: 首页的模板文件。
• layout/post.ejs: 文章页的模板文件。
• layout/page.ejs: 页面页的模板文件。
• layout/archive.ejs: 归档页的模板文件。
• layout/category.ejs: 分类页的模板文件。
• layout/tag.ejs: 标签页的模板文件。

这些模板文件定义了网站各个页面的布局和内容。

3. 项目的配置文件介绍

_config.yml

_config.yml 是 Hexo 主题 Hollow 的核心配置文件，包含了以下主要配置项：

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

# URL
url: 网站URL
root: 网站根路径

# Directory
source_dir: 源文件目录
public_dir: 生成文件目录
tag_dir: 标签目录
archive_dir: 归档目录
category_dir: 分类目录
code_dir: 代码目录
i18n_dir: 国际化目录
skip_render: 跳过渲染的文件或目录

# Writing
new_post_name: 新文章的文件名格式
default_layout: 默认布局
titlecase: 标题是否转换为标题格式
external_link: 外部链接设置
filename_case: 文件名大小写转换
render_drafts: 是否渲染草稿
post_asset_folder: 是否启用资源文件夹
relative_link: 是否使用相对链接
future: 是否发布未来的文章
highlight: 代码高亮设置

# Category & Tag
default_category: 默认分类
category_map: 分类映射
tag_map: 标签映射

# Date / Time format
date_format: 日期格式
time_format: 时间格式

# Pagination
per_page: 每页文章数
pagination_dir: 分页目录

# Extensions
theme: 主题名称

# Deployment
deploy: 部署设置

通过修改 _config.yml 文件，可以自定义网站的各种设置，包括基本信息、URL 设置、目录结构、写作设置、分类和标签设置、日期和时间格式、分页设置以及部署设置等。

以上是 Hexo 主题 Hollow 的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地使用和定制 Hexo 主题 Hollow。

hexo-theme-hollowA pure and elegant theme for Hexo.项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-hollow