hexo系列教程(一)安装

hexo介绍

hexo官方主页:官网
hexo官方文档中已经对hexo有了详细的介绍和说明,在这里我就不在继续阐述了,总结一下几点:

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

目录

一、在本地建立Nodejs和Git环境.
二、安装hexo程序
三、生成网站并本地预览
四、注册Github账号并将hexo部署到Github上

一、本地建立Nodejs和Git环境

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

二、安装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,即可进入预览网站.
 title=

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

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

1.注册GitHub账号

  • 点击此处进入Github官网
  • 注册账号后点击 Start aprojext,然后在项目框填写,请按照 账户名.github.io格式填写,否则会出现页面404
  • 输入完成后点击 Create repository选项提交

2.连接 hexoGitHub

  • 博客文件夹右击打开 Git Bash Here
  • 输入以下命令生成ssh密匙,注意:如果重装系统或者更换电脑,需要重复此项操作!
  ssh-keygen -t rsa -C “你注册GitHub的电子邮箱”
  • 输入代码后你需要敲三次回车,最后可能询问你是否继续,输入yes回车,最终你会得到两份文件 id_rsaid_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

本文章结束,现在,你已经拥有了一个hexo博客,不信?访问注册时填写的后缀为github.io的网址吧!

 title=

评论区
头像