本篇文章详细介绍了如何使用 Hexo 在 GitHub 上搭建个人博客网站。
文章中:
“hexo 目录” 指的是你安装 hexo 的主目录,例:
一、安装 Node.js
去 nodejs官网下载程序。
安装步骤略过...
安装成功后打开 cmd,成功界面如下:
二、安装 Git
去 Git官网下载程序。
安装步骤略过...
鼠标右键,成功界面如下:
三、注册 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