Hexo 主题 Shoka 使用教程
1. 项目的目录结构及介绍
Hexo 主题 Shoka 的目录结构如下:
hexo-theme-shoka/
├── _config.yml
├── languages/
├── layout/
├── scripts/
├── source/
└── package.json
_config.yml
: 主题的配置文件。languages/
: 存放多语言支持的文件。layout/
: 存放主题的模板文件。scripts/
: 存放主题的脚本文件。source/
: 存放主题的静态资源文件,如 CSS、JavaScript 和图片等。package.json
: 项目的依赖管理文件。
2. 项目的启动文件介绍
Hexo 主题 Shoka 的启动文件主要是 _config.yml
和 package.json
。
_config.yml
: 这是主题的主要配置文件,包含了主题的各种设置,如网站标题、描述、导航菜单等。package.json
: 这个文件定义了项目的依赖包和其他元数据,如项目名称、版本、作者等。
3. 项目的配置文件介绍
Hexo 主题 Shoka 的配置文件是 _config.yml
,以下是一些关键配置项的介绍:
# Site
title: 网站标题
subtitle: 网站副标题
description: 网站描述
keywords: 网站关键词
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:
type: 部署类型
以上是 Hexo 主题 Shoka 的基本配置介绍,具体配置项可以根据实际需求进行调整。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考