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 -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
,然后在项目框填写,请按照账户名.github.io
格式填写,否则会出现页面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
文件夹下的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
- 此时不能执行hexo d命令,否则会报错:
Deployer not found: github
或者Deployer not found: git
原因是需要安装一个插件,命令如下:
npm install hexo-deployer-git --save
- 然后打开你的
Git bash
,输入hexo d
即可将代码提交.
如果解析自己的域名,则每次提交之前都需要将自己的CNAME、README.md
文件放在blog
文件夹下的public
内