欢迎访问我的站点: https://rchardzhu.github.io/
一、在github上创建一个代码库
在github上创建一个代码库,名字为:xxx.github.io, xxx为你的github账号名
如我的代码库地址为:https://github.com/rchardzhu/rchardzhu.github.io
参考:Quickstart for GitHub Pages - GitHub Docs
二、安装nodejs和hexo
由于github只支持静态网页,需要使用hexo。hexo是基于nodejs打造的一个博客框架,用于快速创建项目、页面、编译、部署 Hexo 博客。
- 先安装nodejs
npm install hexo
, 然后把hexo的目录放到PATH目录下。或者使用-g 安装到全局目录,但需要管理员权限
三、运行hexo
创建blog项目,
$hexo init blog
blog目录文件夹下就会出现 Hexo 的初始化文件,包括 themes、scaffolds、source 等文件夹进入blog目录,生成静态文件:
$ cd blog && hexo generate
可以看到输出结果里面包含了 js、css、font 等内容,并发现它们都在项目根目录下的 public 文件夹下面了本地预览查看:
$hexo serve
可以看到一个默认的hello world页面。部署到github:
$ hexo deploy
编辑_config.yml文件,编辑deploy部分,参考如下
在新创建的blog目录下安装hexo-deployer-git,命令如下: $npm install hexo-deployer-git --save
更多信息参考:部署
如果出现如下错误:”ERROR Deployer not found: git”,表明hexo-deployer-git安装的目录不对,记住需要在新创建的目录下npm install。
四、写博客
- 新建文章 :
$ hexo new "about"
创建的文章会出现在 source/_posts 文件夹下,是 MarkDown 格式。
更多信息参考:写作
然后正常使用markdown格式去写文章就好了。
- 生成静态文件并更新到github上即可
1
2
3$hexo clean
$hexo generate
$ hexo deploy