hexo构建+github pages托管 的操作日志

hexo使用笔记

大前提是要安装好Nodejs,操作忽略可参考这里

以下的操作都是在Nodejs

hexo 全局安装

1
$ npm install hexo-cli -g

初始化博客目录

1
$ hexo init ../techBlog

安装依赖

1
$ npm install

新建一篇文章

1
$ hexo new post "test first post"

新建一篇草稿

1
$ hexo new draft testFirst

编译生成静态站

1
$ hexo g

启动本地服务器预览

1
$ hexo s

启动本地服务器预览草稿

1
$ hexo s --draft

gitHub pages 托管

方式有2种

  1. user pages托管
  2. project pages托管
  • 因为网上大多介绍的是第一种,所以这里介绍第二种,理论上可以开无数个博客。
  1. gitHub注册用户

  2. 建立2个仓库。(我这里一个叫tblog,一个叫tblogDeploy)

    建立仓库

  3. tblog只是用来存放博客的原始资料,gitHub上不用做任何设置。

  4. tblogDeploy是公开博客的,对其进行如下设置

    设置

    分枝设定

  5. 在自己的域名管理(买域名的地方)里面添加CNAME的映射,映射到【username】.github.io

  6. techBlog/source 下添加CNAME文件,无扩展名。打开后在里面写入你的域名。

  7. 修改 _config.yml 使Hexo可以把生成好的静态博客自动发布到tblogDeploy仓库的gh-pages分枝,修改如下

1
2
3
4
5
6
7
url: https://tblog.xfutian.com
root: /
# 中间略
deploy:
type: git
repo: https://github.com/yourName/tBlogDeploy.git
branch: gh-pages

之后运行发布命令

1
$ hexo deploy -g

发布成功

大功告成! 祝你玩的开心

追加:sitemap生成,rototstxt生成

1
2
npm install hexo-generator-seo-friendly-sitemap --save
npm install hexo-generator-robotstxt --save

追记:Win10 执行 hexo g 命令出错 (2020-08-29)

1
2
3
4
5
6
hexo : このシステムではスクリプトの実行が無効になっているため、ファイル C:\Program Files\nodejs\hexo.ps1 を読み込むことができません。詳細については、「a 
bout_Execution_Policies」(https://go.microsoft.com/fwlink/?LinkID=135170) を参照してください。
発生場所 行:1 文字:1
+ hexo g
+ ~~~~
+ CategoryInfo : セキュリティ エラー: (: ) []、PSSecurityException

解决方法是,用管理员权限启动PowerShell后执行下面3行

1
2
3
$ PowerShell Set-ExecutionPolicy RemoteSigned
$ cd "C:\Program Files\nodejs\" #你hexo.ps1所在文件夹,错误信息里可以看到
$ PowerShell .\hexo.ps1