Windows系统下基于github+hexo的个人Blog初步搭建
参考教程:
一、工具
1.Github账号
首先需要有一个Github账号,没有的在Github官网上注册一个GitHub · Build and ship software on a single, collaborative platform · GitHub
(ps:Github有时候可能会打不开或者加载速度慢,可以用Watt Toolkit加速)
2.NodeJS
NodeJS官方下载链接Node.js — 下载 Node.js® (nodejs.org)
NodeJS的安装过程可以查看这篇文章Node.js安装及环境配置之Windows篇 - 刘奇云 - 博客园 (cnblogs.com),最好是安装最新版的NodeJS
3.Git
Git官方下载链接Git - Downloads (git-scm.com)
后续我们对hexo进行部署需要用到Git,安装过程可以参考这篇Windows系统Git安装教程(详解Git安装过程) - 学为所用 - 博客园 (cnblogs.com),同样也是安装最新版的
4.Hexo
在安装hexo之前,我们先检测一下是否全部下载安装成功
管理员身份运行cmd,输入以下指令
1 | node -v |
若正常输出版本号则代表安装成功
接下来我们要下载安装hexo,在cmd中输入
1 | npm install hexo-cli g |
如果无法安装,则改为输入
1 | npx install hexo |
后续若还有npm报错的,一律改为npx
至此,已经完成了工具的准备
二、搭建仓库
接下来准备在Github中搭建用于存放静态页面的仓库
首先登录Github,在右上角点击加号,选择New repository
仓库名输入“用户名.github.io”
勾选Public,勾选add a readme file,然后Create创建
三、生成ssh key
电脑任意位置右键空白处,选择git bash here,输入
1 | ssh-keygen -t rsa -C "你的邮箱" |
敲4下enter
然后进入C:\Users\用户名,找到.ssh文件夹
:::color3
注意,用户文件夹名称必须是英文,不能包含中文!!
若用户文件夹名为中文,删除.ssh文件夹,修改文件夹名后再重复上面生成.ssh的步骤
具体修改用户文件夹名称的方法笔者没找到,更简便的方法是新建一个用户
:::
然后用记事本打开id_rsa.pub文件,全选文本内容复制
然后打开github,右上角点击个人头像,选择“Settings”
在左侧边栏找到“SSH and GPG keys”,新建一个ssh key,名称随意,在“Key”栏粘贴刚刚的文本内容
然后点击“Add SSH key”
接着我们测试一下是否创建成功
如果有开Watt Toolkit一类加速器先关闭,避免报错
在git bash中输入
1 | ssh -t git@github.com |
四、本地生成Blog内容
自选位置新建Blog文件夹,在文件夹中打开git bash,输入
1 | hexo init |
如果报错command not found,则改为输入
1 | npx hexo init |
然后输入
1 | hexo install |
接着依次输入
1 | hexo g |
现在我们就可以按住Ctrl键单击输出的链接访问我们的本地服务器了
关闭网站后记得Ctrl+C关闭本地服务器
五、上线Blog
进入Blog文件夹,用记事本打开_config_yml
拉到最底部,把deploy后面的全部删掉,复制粘贴这段
1 | type: git |
:::color3
注意缩进格式,每行前面两个空格不要删,冒号后的一个空格也不要删
:::
打开github,打开我们新建的仓库“用户名.github.io”,右上角点击Code,复制https链接
将其粘贴至我们的_config.yml文件中repository: 后面(冒号后面的空格不要删!!!)
保存后退出,在Blog文件夹打开git bash,输入以下指令安装自动部署发布工具
1 | npm install hexo-deployer-git --save |
然后依次输入
1 | hexo g |
:::color3
如果是第一次使用git的话需要配置
git config –global user.email “你的邮箱”
git config –global user.name “用户名”
配置完后再hexo d上传
在跳出来的窗口进行登录
:::
至此,个人Blog已初步搭建完成
在浏览器内输入“用户名.github.io”,就可以访问我们的个人Blog主页了!
