Hexo是一个快速、简洁且高效的博客框架,而Github是一个免费的代码托管工具,利用Github Page可以免费创建一个静态网站。下面将介绍如何使用Hexo和Github,在win10环境下搭建一个静态的博客。
安装和配置Hexo及Github
安装Hexo
安装Hexo前,需要安装以下:
- Node.js
- Git
如果已经安装完成以上程序,打开Git-bash或者cmd,输入
npm install -g hexo-cli
即可完成Hexo的安装。
使用Hexo进行本地建站
选择一个本地的文件夹,如
D:\hexo。
输入
hexo init D:\hexo
cd D:\hexo
npm install
如果hexo安装成功,则在D:\hexo文件夹下的文件目录为
.
├── _config.yml // 网站的配置信息,你可以在此配置大部分的参数。
├── package.json
├── scaffolds // 模板文件夹。当你新建文章时,Hexo会根据scaffold来建立文件。
├── source // 存放用户资源的地方
| ├── _drafts
| └── _posts
└── themes // 存放网站的主题。Hexo会根据主题来生成静态页面。
详细文件或文件夹的具体含义见 Hexo官方文档之建站https://hexo.io/zh-cn/docs/setup.html
为了测试本地建站是否成功,输入
hexo s
如果显示如下
则说明本地建站成功,访问本地地址可以看到Hexo默认主题的效果。
至此,Hexo的安装和本地建站完成,如需更加深入全面地了解Hexo,可访问Hexo官方文档。
创建Github账号
如果已经注册Github,可跳过此步骤。否则,访问Github官网进行注册,下面假设你注册Github账号名为MyGithub。
创建与账号同名的Repository
注册并登陆Github官网成功后,点击页面右上角的+
,选择 New repository
。
在Repository name
中填写你的Github账号名.github.io
,这里是MyGithub.github.io
。Description
中填写对此repository的描述信息(可选,但建议填写,如Personal website
)。
点击Create repository
,完成创建。
配置SSH
(1) 生成SSH
检查是否已经有SSH Key,打开Git Bash,输入
cd ~/.ssh
如果没有这个目录,则生成一个新的SSH,输入
ssh-keygen -t rsa -C "your e-mail"
其中,your e-mail是你注册Github时用到的邮箱。
然后接下来几步都直接按回车键,最后生成如下(这里要特别注意:在哪个路径下,输入哪个命令)
(2) 复制公钥内容到Github账户信息中
打开~/.ssh/id_rsa.pub
文件,复制里面的内容;
打开Github官网,登陆后进入到个人设置(点击头像->setting
),点击右侧的SSH Keys
,点击Add SSH key
;填写title之后,将之前复制的内容粘贴到Key框中,最后点击Add key
即可。
(3) 测试SSH是否配置成功
输入
ssh -T git@github.com
如果显示以下,则说明ssh配置成功。
Hi username! You’ve successfully authenticated, but GitHub does not
provide shell access.
将网站发布到Github的同名repository中
打开D:\Hexo
文件夹中的_config.yml
文件,找到如下位置,填写
deploy:
type: git
repository: git@github.com:MyGithub/MyGithub.github.io,master
注: (1) 其中MyGithub
替换成你的Github账户; (2) 注意在yml文件中,:
后面都是要带空格的。
此时,通过访问http://MyGithub.github.io
可以看到默认的Hexo首页面(与之前本地测试时一样)。