使用Hexo在GitHub上搭建个人博客网站

310 阅读3分钟

本篇文章详细介绍了如何使用 Hexo 在 GitHub 上搭建个人博客网站。

文章中:

“hexo 目录” 指的是你安装 hexo 的主目录,例:

一、安装 Node.js

nodejs官网下载程序。

安装步骤略过...

安装成功后打开 cmd,成功界面如下:

二、安装 Git

Git官网下载程序。

安装步骤略过...

鼠标右键,成功界面如下:

三、注册 GitHub 账户,新建项目

GitHub官网

注册步骤略过...

四、安装 Hexo

1、创建文件夹,通过命令进入该文件夹(这个文件夹就是你的 hexo 目录)。

例:

2、输入 npm install hexo -g ,开始安装 Hexo

若 npm 安装 hexo 失败,报如下错误:

npm WARN deprecated swig@1.4.2: This package is no longer maintained

解决方法:切换npm 源,使用淘宝的npm 源。

npm config set registry https://registry.npm.taobao.org
cnpm install -g hexo

五、检查是否安装成功

输入 hexo -v, 检查 Hexo 是否成功安装。

六、初始化

输入 hexo init , 初始化该文件夹。

出现 Start blogging with Hexo!,表示安装成功。

七、安装所需组件

输入 npm install , 安装所需组件。

八、生成主题

输入 hexo g , 生成主题。

九、开启服务器

输入 hexo s , 开启服务器,访问该网址。

如果页面一直无法跳转,可能端口被占用。

ctrl+c 停止服务器。

输入 "hexo server -p 端口号" ,改变端口号。

显示下图页面,成功!

十、将 Hexo 与 Github page 联系起来

1、设置 Git 的 user name 和 email

使用自己 Github 的 name 和 email。

2、输入 cd ~/.ssh,检查是否有 .ssh 的文件夹

3、接着输入 ls,列出该文件下的内容,下图说明存在:

4、生成秘钥

ssh-keygen -t rsa -C 加自己 Github 邮箱。

连续三个回车,生成密钥,最后得到了两个文件: id_rsa和id_rsa.pub(默认存储路径是:C:\Users\Administrator\ .ssh)。

5、添加秘钥

添加密钥到 ssh-agent。

6、添加生成的 SSH key 到 ssh-agent

再输入 ssh-add ~/.ssh/id_rsa ,添加生成的 SSH key 到 ssh-agent。

7、登录 Github ,点击头像下的 settings ,添加ssh

点击左侧 SSH and GPG keys, 再点击右上角 New SSH key。

添加秘钥,将 id_rsa.pub 文件里的内容复制上去。

8、测试添加 ssh 是否成功

如果看到 Hi 后面是你的用户名,就说明成功了。

9、配置 Deployment

在其文件夹中,找到_config.yml文件,修改repo值(在末尾)。

十一、在 Github 仓库中添加 README.md 文件

文件夹下打开命令窗口并执行:

echo "# username.github.io" >> README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin https://github.com/***/***.github.io.git
git push -u origin master

以上代码在 Github 中新建仓库时会有显示,可直接复制。

十二、新建博客

文件夹下打开命令窗口并执行:

hexo new post “博客名”。

依次打开 hexo 目录 → source → _posts,可以看到新建的文章。

十三、安装扩展

在生成以及部署文章之前,需要安装一个扩展:

npm install hexo-deployer-git --save

十四、生成及部署

每次修改配置或文章后,需要生成及部署,网站才会有更新。

生成及部署命令:

hexo d -g

期待您的关注!