一个简洁的主题，主要功能是 “树状导航” + “树状目录”，可选配“评论”和“阅读量”功能，支持基于搜索引擎的全站搜索。通过 fancybox 支持图片点击放大。
有问题欢迎及时 issues
下载主题(可选择 release 版本)到 hexo 根目录中 themes 目录下
git clone https://github.com/wujun234/hexo-theme-tree.git themes/tree
修改 hexo 根目录的 _config.yml
theme: tree
为了将 个人配置 跟 主题更新 解耦，目前将之前放在 themes/tree/_config.yml 的的配置项移到了 hexo 根目录中的 _config.yml 文件。
旧版：无感升级，因为 themes 下的配置是继承 hexo config 的
请复制粘贴下面默认配置到 hexo 根目录中的 _config.yml 文件中(或者新建 _config.tree.yml 文件)，后续可以根据自己需求更改配置
########## The following are all optional #########
####### footer bar #####
# footer, author name
author: your name
# footer, author name link
website: /
# footer, copyright start year, default this year
#siteStartYear: 2018
# favicon, replaceable
favicon: /favicon.ico
####### header bar #####
# before set to true, please maker sure you've created hexo tags\categories\about pages
tags: false
categories: false
about: false
links:
# GitHub links，start with http、https or //
github: https://github.com/wujun234
# normal links，support multiple
custom:
- name: Tree
URL: https://github.com/wujun234/hexo-theme-tree
- name: UidGenerator
URL: https://github.com/wujun234/uid-generator-spring-boot-starter
####### sidebar #####
sidebar:
# name for left sidebar post list. true: title name; false: file name
usePostTitle: true
####### plug-in #####
# optional, giscus comment
# get generated configurations from https://giscus.app/
# when enable is true, full out your repo、repo_id、category_id
giscus:
enable: false
repo:
repo_id:
category_id:
reactions_enabled: "1"
emit_metadata: "0"
input_position: "top"
theme: "preferred_color_scheme"
lang: "en"
# optional, valine
valine:
enableComment: false
enableCounter: false
# valine appID
appID:
# valine appKey
appKey:
placeholder: Please enter a comment
avatar: retro
#optional, busuanzi, statistics of visits
busuanzi: false
####### Off-page search #####
# If the site is [included by a search engine]
# searchEngine：default google, can replace with other searchEngine
#searchEngine: https://www.baidu.com/s?wd=
searchEngine: https://www.google.com/search?q=
# homeHost：target domain, default current page domain
homeHost: wujun234.com
替换themes/tree/source 路径下的favicon.ico 文件
- 导航栏：配置化，需要在
hexo根目录中的_config.yml，需要修改links相关配置
# optional
links:
# github links，start with http、https or //
github: https://your github link
# normal links，support multiple
custom:
- name:
URL:
- name:
URL:
在 source 路径下，与 _posts 文件夹平行，建立一个 about 页
执行
hexo new page --path about/index "About"
参考：https://hexo.io/zh-cn/docs/commands.html#new
修改 hexo 根目录中的 _config.yml，添加
about: true
在 source 路径下，与 _posts 文件夹平行，建立一个 tags 页
执行
hexo new page "tags"
编辑 source/tags/index.md
---
title: tags
date: 2021-02-26 16:36:55
type: "tags"
layout: "tags"
---
修改 hexo 根目录中的 _config.yml，添加
tags: true
如果想让 tags 页展示在一列，可以添加配置
style:
tags:
# support line, list; default list
display: line
在 source 路径下，与 _posts 文件夹平行，建立一个 categories 页
执行
hexo new page "categories"
编辑 source/tags/index.md
---
title: categories
date: 2021-02-26 16:36:55
type: "categories"
layout: "categories"
---
修改 hexo 根目录中的 _config.yml，添加
categories: true
如果想让 categories 页展示在一列，可以添加配置
style:
categories:
# support line, list; default list
display: line
页面左侧的文章树是根据 source 文件夹里的文章和文件夹生成的
修改 hexo 根目录的 _config.yml, sidebar.usePostTitle 可以控制目录树中展示文件名还是文章名
# name for left side bar post list
sidebar:
# ture: title name; false: file name
usePostTitle: true
- 如果要使用
giscus评论系统，需要在hexo根目录中的_config.yml，填写giscus配置 - 配置页面：https://giscus.app
- 默认是不使用，false
# optional, giscus comment
# get generated configurations from https://giscus.app/
# when enable is true, full out your repo、repo_id、category_id
giscus:
enable: false
repo:
repo_id:
category_id:
reactions_enabled: "1"
emit_metadata: "0"
input_position: "top"
theme: "preferred_color_scheme"
lang: "zh-CN"
- 如果要使用
valine的评论及阅读量功能，需要在hexo根目录中的_config.yml文件中，填写自己申请的leancloud账户下面的appID和appKey，并且分别设置为 true - 默认是不使用，false
# optional, valine
valine:
enableComment: false
enableCounter: false
# valine appID
appID:
# valine appKey
appKey:
placeholder: Please enter a comment
avatar: retro
修改 hexo 根目录的 _config.yml
站点如果【被搜索引擎收录】，可以配置通过搜索引擎全站搜索
- searchEngine: 你选择的搜索引擎搜索 url，默认谷歌，例如"https://www.baidu.com/s?wd="、"https://www.google.com/search?q="
- homeHost: 你的域名，默认当前页面的域名
####### Off-page search #####
# If the site is [included by a search engine]
# searchEngine：default google, can replace with other searchEngine
#searchEngine: https://www.baidu.com/s?wd=
searchEngine: https://www.google.com/search?q=
# homeHost：target domain, default current page domain
homeHost: wujun234.com
主题默认支持了 pjax 跳转，但是在网速慢的时候，pjax 因为没有页面刷新的交互，可能会让人误以为点击没响应。
如果要去掉 pjax 特性，注释掉主题 'source/js/main.js' 文件中的 'pjaxLoad()' 方法就好。
默认注释了，需要打开的就去掉注释
$(document).ready(function () {
hljs.initHighlightingOnLoad();
clickTreeDirectory();
serachTree();
// pjaxLoad();
showArticleIndex();
switchTreeOrIndex();
scrollToTop();
pageScroll();
wrapImageWithFancyBox();
});- 国际化：需要在
hexo根目录的_config.yml，需要修改language相关配置 - 小试牛刀，目前就搜索框和导航栏有文字
# support language
# default en， can select from [en, zh-Hans, tr]
language: zh-Hans
最开始将图片放在 source 中，使用 github 的相对地址，但是本地 md 编辑器不能识别这样的图片，
后续选择了 picgo，用 github 做图床：https://picgo.github.io/PicGo-Doc/
以下插件都是 hexo 的，跟 Tree 主题无关
- 渲染器：hexo-renderer-markdown-it
- 流程图：hexo-filter-mermaid-diagrams
- 通用 sitemap: hexo-generator-sitemap
- 百度 sitemap：hexo-generator-baidu-sitemap
- 一键部署: hexo-deployer-git
我自己用的是百度统计 https://tongji.baidu.com ，很简单，注册后在 'head' 里加一个 '<script>' 块就行了
现在改用 Cloudflare 了，免费，接入 DNS，会有统计，还有分析。