📚Step1:新建页面
-
在 Hexo 项目根目录下执行命令
hexo new page 'xxx'
,会在 source 目录下自动生成xxx文件夹。
-
注意事项(这里以Keep主题为例,其他主题可能情况不同)
- 文件夹的命名:应当采用小写,不然后续本地查看正常,但部署后,链接不能正常跳转。
- 文件夹命名的修改:
- 直接修改文件夹命名不可取,应当删去原文件夹后,重新
hexo new page 'xxx'
。 - 且匪夷所思的是,当我希望把TED改为ted,每次部署到github后依旧显示TED文件夹,以致更新失败,即
hexo s
查看正常,hexo g -d
部署后就不正常!!! - 解决办法是新建文件夹命名改为
myted
。
- 直接修改文件夹命名不可取,应当删去原文件夹后,重新
- 短短几句注意事项当真是惨痛血泪啊o(╥﹏╥)o…
📚Step2:menu项配置
- 在 Keep 主题配置文件
_config.yml
的 menu 配置项下添加myted: /myted
,这里需要与文件夹名对应。
- 反思文件夹命名问题,Keep主题的menu栏最后默认是大写显示,小写链接,以至于用大写命名会造成识别紊乱问题。
- 这里
||
后对应的是图标配置,可在Font Awesome选取免费图标。
📚Step3:自定义页面渲染跳过
-
在
hexo new page 'xxx'
后,会在source 目录下自动生成xxx文件夹,且里边有初始index.md
文件,因为hexo会自动将md文件渲染为html,因此如果是单纯的说明类页面,直接在md中添加内容,部署后即会自动渲染。注意:自动生成md页前的 title 属性不要修改!不要删除!
-
但当我们的目的是把已经写好的带三件套的网页部署为自定义页面——
- Step1:将上述内容全部复制进之前建好的文件夹。
- Step2:将html页面重命名为
index.html
。 - Step3:检查css、js、images等导入路径是否正确。
- 这里又出现了一件匪夷所思的事情o(╥﹏╥)o,我的datas里的文件路径链接明明正确但最后部署后,json文件就是读取不出来,报错
Failed to load resource: the server responded with a status of 404 (Not Found)
(啊啊啊啊啊啊啊啊) - 解决办法是,把datas文件夹拆了,把相关的文件放到外边,并修改路径,就OK了(但我不知道为啥…)
- 到这一步,大概最后文件夹里长这样↓
- 这里又出现了一件匪夷所思的事情o(╥﹏╥)o,我的datas里的文件路径链接明明正确但最后部署后,json文件就是读取不出来,报错
- Step4:配置渲染跳过。在 Hexo 项目根目录下的
_config.yml
里找到skip_render
,添加希望跳过的路径,意思是告诉主题,这里的就不用劳烦你渲染了。
📚Step4:本地检验后部署
- 本地检验:
hexo s
- 部署:
hexo clean
+hexo g -d