一个简洁的 Hexo 主题,支持博客写作和分级文档。
- 📝 博客功能 - 文章列表、归档、标签云
- 📚 分级文档 - 树形侧边栏目录,适合技术文档
- 🔍 本地搜索 - 基于 JSON 索引的全文搜索
- 📊 字数统计 - 显示字数和预估阅读时间
- 🏷️ 标签系统 - 文章标签分类
- 🖼️ 图片支持 - 图片懒加载、灯箱效果
- 🌓 深色模式 - 支持浅色/深色主题切换
- 📱 响应式 - 完美适配移动端
将主题文件夹复制到 Hexo 的 themes 目录:
cd your-hexo-site
git clone https://github.com/nijich/hexo-theme-starter.git themes/starter修改 Hexo 根目录的 _config.yml:
theme: starter复制主题配置文件到 Hexo 根目录(推荐):
cp themes/starter/_config.yml _config.starter.yml或直接编辑 themes/starter/_config.yml。
menu:
首页: /
归档: /archives
标签: /tags
文档: /docs/
关于: /aboutsocial:
github: https://github.com/username
twitter: https://twitter.com/username
email: mailto:your@email.com默认自动扫描,也可以手动指定
docs:
- title: 快速开始
path: /docs/getting-started
- title: 指南
children:
- title: 安装
path: /docs/guide/installation
- title: 配置
path: /docs/guide/configuration
- title: 部署
path: /docs/guide/deployment
- title: API 参考
children:
- title: 核心 API
path: /docs/api/core
- title: 插件 API
path: /docs/api/pluginssearch:
enable: true
fields:
- title
- content
- tags
excerpt_length: 100post:
word_count: true # 显示字数
reading_time: true # 显示阅读时间
words_per_minute: 300 # 每分钟阅读字数hexo new page tags编辑 source/tags/index.md:
---
title: 标签
layout: tags
---hexo new page docs/getting-started编辑 source/docs/getting-started/index.md:
---
title: 快速开始
layout: doc
---
你的文档内容...---
title: 文章标题
date: 2024-01-01 12:00:00
updated: 2024-01-02 12:00:00
tags:
- 标签1
- 标签2
categories:
- 分类
cover: /images/cover.jpg # 封面图
toc: true # 是否显示目录
---Markdown 标准语法:
支持 Hexo 资源文件夹:
{% asset_img example.jpg 图片描述 %}主题使用 Hexo 内置的代码高亮,确保 Hexo 配置中启用:
# _config.yml
highlight:
enable: true
line_number: true
auto_detect: true
wrap: true可以通过 CSS 变量自定义主题色彩:
/* source/css/custom.css */
:root {
--primary-color: #your-color;
}- Chrome(推荐)
- Firefox
- Safari
- Edge
- 移动端浏览器
MIT License