Hexo是一款基于Node.js的静态博客框架,依赖少易于安装使用,可以方便的生成静态网页托管在GitHub上。以下步骤操作简单,只需先自行安装好node.js和git,剩余2~3小时大概就可完成。
所需工具
- node.js
- git
安装配置步骤
- 安装node.js和git之后安装hexo:
npm install -g hexo-cli
安装完成之后使用npm -v
查看是否安装成功 - 创建hexo项目
在本地新建一个blog的文件夹
在这个文件右键进入git bash模式
命令模式下执行hexo init
初始化博客 - 生成SSH密钥
打开Git Bash,使用以下命令配置gitgit config --global user.name "你的github用户的名字"
git config --global user.email "你的github账户邮箱"
cd ~/.ssh
ssh-keygen -t rsa -C "你的github账户邮箱"
连续三个回车eval "$(ssh-agent -s)"
,添加密钥到ssh-agentssh-add ~/.ssh/id_rsa
,添加生成的SSH key到ssh-agentcat ~/.ssh/id_rsa.pub
复制此时显示的内容,内容应该是以ssh-rsa开头 - Github新建一个仓库,并配置SSH密钥
Ctrl+C退出后,在GitHub上新建一个新的仓库,仓库名随意,不过需要记录下来,我这里起名叫blog,最下面的Initialize this repository with a README要勾选上,然后保存即可。进入这个仓库后选择Settings,在左侧选项卡Options中翻到下面,GItHub Pages这项,Source选择master branch,选择save后,会在这部分的标题处写明这个仓库的url,这就是你博客的url了。还是页面的左侧的选项卡,Deploy 选择Add deploy key,添加密钥。
Title随意,我设置为了blog
Key粘贴我们刚才复制的那一段。
最下面Allow write access要打勾.
选择Add Key即可。
然后在Git Bash中使用
ssh -T git@github.com
测试,如果看到Hi后面是你的用户名,就说明成功了。 - 使用
npm install
安装需要的组件 - 使用
npm install hexo-deployer-git --save
安装插件 - 修改hexo配置文件
打开本地博客的根目录,找到_config.yml文件,
在文件的开头处,第二部分,url改成自己Github仓库的地址,root改为自己/自己本地仓库名/,如下所示:1
2
3
4
5
6# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: https://github.com/bjutliuyan/blog
root: /blog/
permalink: :year/:month/:day/:title/
permalink_defaults:再在最下面添加如下片段,repository这项,应该去GitHub里面新建的那个叫blog的仓库里面找。进入仓库主页后,点击右侧绿色的按钮Clone or download,在新弹出的窗口右上角选择Use SSH,然后将下面的文字复制粘贴到此处。
修改完配置文件后保存退出即可。1
2
3
4
5
6# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repository: git@github.com:Davidham3/blog.git
branch: master
- 生成博客
hexo g
- 发布博客
hexo d
- 本地预览博客
hexo s
通过localhost:4000可以本地预览