# 第一步 Hexo 搭建本地静态网页
一、Hexo 的环境配置——安装 Node.js
1.登录网址为 https://nodejs.org/en/download/;找到 Download 板块。
2.根据本机类型,选择相应的版本下载; 注:如何确定自己电脑的类型呢?解决办法:计算机->右键->属性,本机是64位架构 。因此,我这里做如下选择:
3.安装下载的 node-v10.16.3-x86 文件,一路 next,即可完成安装。 注:nodejs 默认的安装中会包含环境变量的配置和 npm 工具的安装。
4.检验是否安装成功:在“开始”菜单中输入 cmd,打开命令行窗口
(1) 输入 node –v,若显示版本号,则 nodejs 安装成功;
(2) 输入 npm -v,若显示版本号,则 npm 安装成功;
5.至此,Hexo 的环境配置已经全部完成。
二、Hexo 的安装
1.使用 npm 命令安装 Hexo 客户端,输入:npm install -g hexo-cli
上图表示我们已经成功安装了 Hexo 客户端,且版本号为 2.0.0。
2.确定自己博客(撰写/更新)的文件夹在本机位置:例如,可以在 D 盘新建一个 blog 的文件夹,然后将命令行切换到这个目录下
3.将该文件夹初始化为 hexo 网页框架所在位置,输入 hexo init:
不难发现,命令执行失败,因为它需要从 github 上下载程序,因此我们首先需要下载 Git 工 具。
4.登录 git 的 windows 版本下载页面:https://git-scm.com/download/win。根据自己 系统类型,选择性安装。我这里是安装 Git-2.23.0-64-bit 文件。
在安装过程中有如下两个页面要注意选择,其他一路 Next.
5.检测 git 工具是否安装成功:在新打开的 cmd 窗口输入 git 指令,如果出现下图, 表明 git 安装成功。
6.切换到博客文件夹路径下面后,重新输入 hexo init,若出现下图,表明 blog 初始化 成功。
7.生成 public 静态资源:输入 hexo g 注:g=generate
可以看到生成了很多.html 网页文件、png 和 git 图片文件等等。
8.启动本地服务器:输入 hexo s 注:s=server
图中语句表示 Hexo 运行在上述网址上。
9.检查网站雏形:在浏览器输入 http://localhost:4000 ,即可查看通过 hexo 部署的 本地静态网页效果。很多人会碰到浏览器一直在转圈但是就是加载不出来的问题,一般 情况下是因为端口占用的缘故,因为 4000 这个端口太常见了此时我们 ctrl+c 停止服务 器,接着输入“hexo server -p 端口号”来改变端口号。如果搭建成功,应该可在上述网 址上看到如下页面:
三、开写第一篇博客文章
1.上述网站中出现的 Hello World 文章其实在 blog\source_posts 文件目录下默认创建 的,因此我们可以直接在该文件目录下创建自己的博客内容。
2.新建第一篇博客文件。在 blog 文件下使用命令:hexo new 文件名。这样 hexo 就 会帮我们在 blog\source_posts 下自动生成制定名称的文件,后缀名为.md。用这个命令的好 处是帮我们自动生成了时间。
3.打开、撰写、保存新文件: 可以使用 txt 操作,打开文件后输入以下内容: hello 你好啊,并以 UTF-8 格式来保存。
注意:有的文件后缀默认会省略掉,需要设置电脑的相关选项
刷新下网页即可看到如下页面
4.页面优化:如果我希望自己的页面上有 Hello World 这篇博文的效果,则可以采用 markdown 格式语法。例如,在上文中添加如下内容:
生成页面如下如所示
# 第二步 搭建 Github 网页仓库
1.创建一个新的仓库:登录官网后,点击Sign in 标签后输入用户名、密码。然后创 建一个新的仓库。注意,下图两个红色覆盖区域的名称要相同。最后点击“create repository”
2.完成后,可以点击该仓库,进入仓库的配置界面
鼠标拖动纵向进度条到中央位置,发现如下消息:
这时表明,我们新建的仓库被发布在了上述这个网页上。
3.登录上述网址,发现内容和该仓库中的 README.md 文件中的内容一模一样。
# 第三步 关联 Github 网页仓库和本地 Hexo 博客
一、配置 SSH key(这个操作似乎只能在 git bash 中完成)
为什么要配置这个呢?因为你提交代码肯定要拥有你的 github 权限才可以,但是直接 使用用户名和密码太不安全了,所以我们使用 ssh key 来解决本地和服务器的连接问题。
1.创建 ssh key: 第一条指令是查看本机中是否存在 ssh key;如果存在就可以直接使 用;若不存在,则需要先生成。第二条指令就是用来生成 ssh key,输入:输入 ssh-keygen -t rsa -C “github 邮箱名称”
然后连续 3 次回车,最终会生成一个文件在用户目录下,打开用户目录,找 到.ssh\id_rsa.pub 文件,记事本打开并复制里面的内容,打开你的 github 主页,进入个人设 置 -> SSH and GPG keys -> New SSH key,将复制的内容粘贴至其中。
2.测试本机是否可以通过 ssh 连接到自己的 github 仓库。输入:
ssh -T git@github.com # 注意邮箱地址不用改
然后输入 yes
看到这个信息说明 SSH 已配置成功!
3.修改 blog_config.yml 文件,将最后一部分修改为如下内容
deploy:
type: git
repo: git@github.com:用户名/用户名.github.io.git
branch: master
注:repo 后面的内容拷贝自下图;注意修改内容的空格和缩进;
4.安装一个用于关联 hexo 和 git 的小插件: npm install hexo-deployer-git –save
5.将 hexo 部署至自己的 github 仓库上:输入 hexo d 指令 注:d-deoly。
6.根据错误提示消息,输入两条 git 的配置指令:
7.在浏览器中输入我们的仓库地址,发现网页更新为本地的静态网页,同时仓库中多 了很多文件。但这时候发现只有我们的第一篇默认的 hello world 博文!因为我们新建的那 篇 helloccit 文件没有使用命令生成静态资源!
8.最后输入
(1) hexo g
(2) hexo d
第一条指令的作用是更新 public 下的 index 文件。第二条指令是再次部署。
9.在浏览器中输入自己的 github 仓库网址(见第二部的第 2 小步中的图片):
https://用户名.github.io