本章教程适合windows10系列,win8及以下系统因为结构问题,安装npm后生成的hexo会经常报错,win10顺利切正常!!!

hexo介绍

hexo官方主页:官网

hexo官方文档中已经对hexo有了详细的介绍和说明,在这里我就不在继续阐述了.

  • hexo是基于node.js制作的一个静态页面生成系统
  • hexo生成的网站不需要我们部署到独立的服务器里面,不需要格外购买服务器,hexo生成的页面,我们可以上传到静态托管网站,比如国外的GitHub和国内的Gitee.
  • hexo是使用Markdown语法发文章的,关于Markdown语法可以参考本站中的语法介绍.

目录

一、在本地建立Nodejs和Git环境.

二、安装hexo程序

三、生成网站并本地预览

四、注册Github账号并将hexo部署到Github上

一、本地建立Nodejs和Git环境

可以百度下载,也可以和我下载一样的版本,下载地址我放在文章末尾。安装程序很简单,一直下一步即可。

安装成功后右击菜单会出现Git的命令行

二、安装hexo程序

右击鼠标,点击Git Bash Here,此时会跳出来一个类似与cmd的黑框框,输入

npm install -g hexo-cli
不使用特殊工具,安装hexo时间可能较长

代码跑完后,再次输入hexo -v验证安装

hexo -v

如果安装程序正常,则会显示版本信息,如下:

hexo: 3.4.2
hexo-cli: 1.0.4
os: Windows_NT 6.1.7601 win32 x64
http_parser: 2.7.0
node: 8.9.1
v8: 6.1.534.47
uv: 1.15.0
zlib: 1.2.11
ares: 1.10.1-DEV
modules: 57
nghttp2: 1.25.0
openssl: 1.0.2m
icu: 59.1
unicode: 9.0
cldr: 31.0.1
tz: 2017b

如果正常显示,那就进入下一步

生成网站并本地预览.

随便找一个地方新建blog文件夹,右击打开Git Bash Here并输入:

hexo init
代码意思为在当前文件夹生成博客
npm install
安装所需要的组件
hexo g
生成本地静态页面
hexo s
在本地4000端口打开预览

如果生成顺利,则会显示链接地址,浏览器输入http://localhost:4000,即可进入预览网站.

图片实例

四、注册Github账号并将网页托管到Github上

说明:Github是全球最大的代码开源共享网站,有静态页面托管功能,但是Github是国外网站,国内访问速度过慢,如果你有备案过的域名,可以使用国内的gitee(码云),功能和操作方式大同小异.

1.注册GitHub账号

  • 点击此处进入Github官网
  • 注册账号后点击Start aprojext,然后在项目框填写,请按照下方格式示例填写,否则会出现页面404

账户名.github.io

  • 输入完成后点击Create repository选项提交

2.连接hexo与GitHub

  • 博客文件夹右击打开Git Bash Here
  • 输入以下命令生成ssh密匙,注意:如果重装系统或者更换电脑,需要重复此项操作!!!

ssh-keygen -t rsa -C “你注册GitHub的电子邮箱”

  • 输入代码后你需要敲三次回车,最后可能询问你是否继续,输入yes回车,最终你会得到两份文件id_rsaid_rsa.pub
  • 文件默认存储地址是C:Users你的系统账户.ssh 如果没有,则需要开启显示隐藏文件夹,不会的请百度.
  • 将.ssh文件夹下的id_rsa.pub文件使用记事本打开,将里面的代码全部复制
  • 点击GitHub主页面头像下的settings,点击 SSH and GPG keys ,点击 New SSH key,将id_rsa.pub文件里的内容复制上去后点击下面Add SSH Key以添加密匙。

3.存放博客的地方右击打开Git Bash,并执行:

git config —global user.name “Your Name”
git config —global user.email “email@example.com”

Your name为你注册GitHub的账户名称,email@example.com则为你注册时候的电子邮箱

完成之后,打开cmd或者PowerShell输入ssh -T git@github.com验证链接,如果成功,则会显示你的用户名,如下所示:

链接成功所示

至此,你的电脑与GitHub已经建好连接

4.blog目录下_config.yml文件有关deploy的部分:

  • 打开你博客存放的文件夹,根目录有一个_config.yml 文件,修改Deployment,写法如下:

deploy:
type: git
repository: git@github.com:yourname/username.github.io.git


- **yourname**为你的用户名**username**为你刚才创建的项目名
- 此时不能执行**hexo d**命令,否则会报错:

Deployer not found: github 或者 Deployer not found: git

- 原因是需要安装一个插件,命令如下:
```npm install hexo-deployer-git --save  ```
- 然后打开你的**Git bash**,输入**hexo d**即可将代码提交.
5.如果解析自己的域名,则每次提交之前都需要将自己的CNAME、README.md文件放在blog文件夹下的**public**内.
### 本文章结束,现在,你已经拥有了一个hexo博客,不信?访问注册时填写的后缀为github.io的网址吧!
Last modification:April 20th, 2020 at 09:13 pm
如果觉得我的文章对你有用,请随意赞赏