Hexo搭建Github Pages及Coding Pages博客操作指南

凡事请先阅读官方教程。
此处不包含官方教程所包含内容。

目录结构

1
2
3
4
5
6
7
8
9
10
11
.
├── .deploy
├── public
├── scaffolds
├── scripts
├── source
| ├── _drafts
| └── _posts
├── themes
├── _config.yml
└── package.json
  • .deploy:执行hexo deploy命令部署到相关Pages 服务商上的内容目录
  • public:执行hexo generate命令,输出的静态网页内容目录
  • scaffolds:layout模板文件目录,其中的md文件可以添加编辑
  • scripts:扩展脚本目录,这里可以自定义一些javascript脚本
  • source:文章源码目录,该目录下的markdown和html文件均会被hexo处理。该页面对应repo的根目录,404文件、favicon.ico文件,CNAME文件等都应该放这里,该目录下可新建页面目录。
  • _drafts:草稿文章
  • _posts:发布文章
  • themes:主题文件目录
  • _config.yml:全局配置文件,大多数的设置都在这里
  • package.json:应用程序数据,指明hexo的版本等信息,类似于一般软件中的关于按钮

Hexo命令

  • Hexo下,通过 _config.yml 设置博客,可以想象成我们用的软件里的设置一样,只是它通过一个文件列出这些参数,然后让我们填写和修改。

  • 全局设置
    在你博客目录下有一个文件名_config.yml,打开可以配置信息。

  • 局部页面
    在你博客目录下 \themes\你使用的主题\_config.yml

  • 写博客相关命令

1
2
3
4
5
6
7
Hexo常用命令:
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'退出server)
hexo deploy #将.deploy目录部署到相关Pages 服务商

相关命令简写:

1
2
3
4
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

同时也支持复合命令:

1
hexo clean && hexo g && hexo d

有时候生成的网页会报错,生成的rss因为没有清除,一般情况下用已下命令,重新生成即可。

1
$ hexo clean

添加README.md文件及添加不想被解析渲染的页面

想要README.md文件不被解析渲染,只需在博客根目录下的配置文件_config.yml中配置”skip_render”选项:

1
skip_render: README.md

其他页面也是添加到此处即可,多值参照数组形式排列:

1
skip_render: [README.md,xxx]