【Hexo】Hexo + NexT 常见问题解决
文章目录
1. 如何设置文章折叠隐藏
该痛点是文章较长,在博客首页展示的时候很不优雅,访客要翻很久才能翻到下一篇文章。
解决这个问题就是把文章给折叠起来,同时提供一个“阅读全文”按钮。访问如果想看该文章,就点击这个按钮。
-
解决方案一
在文章想要折叠的位置添加
<!--more-->
。例如:1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
蔡琴: 轻轻敲醒沉睡的心灵 慢慢张开你的眼睛 余天: 看看忙碌的世界 是否依然孤独的转个不停 <!--more--> 苏芮: 春风不解风情 吹动少年的心 潘越云: 让昨日脸上的泪痕 随记忆风干了
-
解决方案二
在文章顶部的
front-matter
中添加description
,重新生成后,将不再展示全文,而是展示description
设置的文章摘要。例如:1 2 3 4
title: 将Hexo站点一键部署至GitHub date: 2021-06-02 23:06:16 tags: description: 这是文章摘要,设置后,首页将仅展示该摘要,想看完整文章可点击“阅读全文”
-
解决方案三
如果嫌每个文章都需设置折叠或摘要太麻烦的话,可以通过修改主题配置来解决。
1 2 3 4
# 在主题配置文件中添加如下配置 auto_excerpt: enable: true length: 150
如果上述设置无效,说明使用的
NexT
是新版本,新版本中已经剔除了该选项,改为用插件来解决:npm install hexo-excerpt --save
,安装完插件后再进行上述设置即可。
上面三种解决方案中,方案一和方案二更为灵活,方案三较为省力,如果选择看具体需求和个人习惯。
2. 为站点开启“关于”页面
“关于”页面,也就是当前站点或者个人的一个介绍页面。开启该页面后,将在首页菜单栏展示对应图标和按钮。
第一步,先新建好对应页面,在当前站点根目录下执行命令: hexo new page about
。执行完成后,将创建一个 markdown 格式的文档: /source/about/index.md
。在此文档内完成“关于”页面的内容编辑。
第二步,在主题配置文件中,菜单设置下,开启该页面:
|
|
3. 为站点开启“标签”页面
每篇文章都可以设置多个标签,这些标签可以在一个“标签”页面查看。开启该页面后,将在首页菜单栏展示对应图标和按钮。
第一步,先新建好对应页面,在当前站点根目录下执行命令: hexo new page tags
。执行完成后,将创建一个 markdown 格式的文档: /source/tags/index.md
。该文件如下:
|
|
第二步,编辑该文件,修改title为汉字,且指定该页面为“标签”页面。
|
|
第三步,在主题配置文件中菜单设置下,开启该页面:
|
|
此时,重启服务或者重新生成后,可以发现首页已经可以看到“标签”菜单了。但是有个问题:当前页面是空的,没有一个标签。这是肯定的,目前只是搭好了舞台,但还没有表演者。这需要你在需要指定标签的文章里设置 tags
。例如:
指定单个:
|
|
指定多个标签:
|
|
为了便于记忆,可以都使用第二种方式设置标签。
4. 特殊符号转义
因为在写博客的过程中用到了<
和>
,在预览时发现尖括号内的内容都未显示出来,经排查因为尖括号为特殊符号,需要转义。
可参考:https://blog.csdn.net/github_38140984/article/details/83005899
文章作者 hongmao
上次更新 2021-06-06