Hexo博客框架的Next主题配置

主要的功能及配置可以参考:

本文主要说明上述文档没有提及的点。


一、菜单项的设置

新建页面

例如新建标签菜单选项:hexo new page 'tags'

此时会在hexo > source文件夹中会生成一个tags文件夹。

文件夹内有index.md文件,即我们点击“标签”菜单项所弹出的页面,我们可以自己编辑。
修改index.md文件:

1
2
3
4
5
6
---
title: tags
date: 2019-10-26 23:50:36
type: "tags"
comments: false #关闭评论
---

修改主题的配置文件

$ vim themes/next/_config.yml
在menu选项中设定你需要的菜单项:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# ---------------------------------------------------------------
# Menu Settings
# ---------------------------------------------------------------

# When running the site in a subdirectory (e.g. domain.tld/blog), remove the leading slash from link value (/archives -> archives).
# Usage: `Key: /link/ || icon`
# Key is the name of menu item. If translate for this menu will find in languages - this translate will be loaded; if not - Key name will be used. Key is case-senstive.
# Value before `||` delimeter is the target link.
# Value after `||` delimeter is the name of FontAwesome icon. If icon (with or without delimeter) is not specified, question icon will be loaded.
menu:
home: /||home
tags: /tags/|| tags
#categories: /categories/|| th
#archives: /archives/|| archive
#schedule: /schedule/|| calendar
#sitemap: /sitemap.xml|| sitemap
commonweal: /404.html/|| heartbeat
about: /about||user

# Enable/Disable menu icons.
menu_icons:
enable: true

注意是Key: /link/|| icon之后就不用再menu_icons中设置了。||前没有空格,与官方设定不同,若按官方设定会进不到指定页面。按官方文档设置会丢失icon图标。

二、图片存放位置

所有图片都放在了themes/next/source/uploads,博客文章的图片路径可以直接用:
/uploads/图片全名
因为主题文件夹source文件内的所有文件都会放在发布的public文件夹内,因此404.html也要放在themes/next/source/内,自动生成到public文件夹内。
也就是说,上传到服务器的文件夹public包含的是根目录的source文件夹内所有文件和主题目录的source文件夹内所有文件。

三、站点首页不显示文章全文

可以通过在文章使用<!-- more -->标志来精确控制文章的摘要预览,比如这篇文章就是在这个段落的末尾添加了该标志,所以本文在首页的预览就会显示到这个段落为止。

四、Markdown编写的latex公式无法显示

参考:Hexo 的 Next 主题中渲染 MathJax 数学公式

您的支持是我创造源源不断地动力