本章教程适合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环境
可以百度下载,也可以和我下载一样的版本,下载地址我放在文章末尾。安装程序很简单,一直下一步即可。
二、安装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
- 输入完成后点击Create repository选项提交
2.连接hexo与GitHub
- 博客文件夹右击打开Git Bash Here
- 输入以下命令生成ssh密匙,注意:如果重装系统或者更换电脑,需要重复此项操作!!!
ssh-keygen -t rsa -C “你注册GitHub的电子邮箱”
- 输入代码后你需要敲三次回车,最后可能询问你是否继续,输入yes回车,最终你会得到两份文件id_rsa和id_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的网址吧!