Node的安装

  • 打开Node官网，下载和自己系统相匹配的Node安装程序。官网下载地址：https://nodejs.org/en/download
  • 安装选择默认即可。安装目录安装完后，

注册Github

  • 进入官网https://github.com/
  • 点击Sign up进行注册
  • 填写自己的相关信息，验证邮箱完成注册
  • 注册完，登录之后，点击右上角（头像旁边的+），选择New repository，创建一个 <用户名>.github.io 的仓库
  • 填写描述，添加Add a README file，点击Create repository

安装Git

Git中绑定Github账号

  • 打开”Git Bash”，在命令行输入
1
2
3
git config --global user.name "your name"
git config --global user.email "email@example.com"
#其中your name 和email@example.com分别是Github中注册的用户名和邮箱

检查安装环境

1
2
3
4
git version
node -v
npm -v

安装Hexo

  • 在Git Bash中输入以下命令：
1
npm install -g hexo-cli

  • 安装完Hexo后，在指定文件夹下打开“Git Bash”，在执行以下命令，Hexo将会在指定文件夹中创建多需要的文件：

    1
    2
    3
    hexo init myblog(自己的博客项目名)
    cd myblog
    npm install

  • 初始化项目后，myblog有如下结构：

    【node_modules】：依赖包
    【scaffolds】：生成文章的一些模板
    【source】：用来存放你的文章
    【themes】：主题
    【.npmignore】：发布时忽略的文件（可忽略）
    【_config.landscape.yml】：主题的配置文件
    【config.yml】：博客的配置文件
    【package.json】：项目名称、描述、版本、运行和开发等信息

  • 若上面的命令都没有报错的话，那就说明你成功了捏！输入hexo s（hexo server）启动项目

  • 打开浏览器，输入URL：http://localhost:4000，就能看到最基本的博客画面了

将博客部署到Github上

  • 配置SSH key，要使用git
1
ssh-keygen -t rsa -C "绑定的邮箱"

  • 首次使用还需确定并添加主机到SSH可信列表，若返回Hi xxx！You‘ve successfully authenticated，but Github does not provide shell access的内容，则为添加成功

    1
    ssh -T git@github.com

  • 登录Github上添加刚刚生成的SSH key。点击右上头像->setting->SSH and GPG keys,再点击New SSH key。

  • 取个title名称，将根目录下的~/.ssh/id_rsa.pub的内容全部复制到，Key的输入框中，或者在Git中执行以下命令复制

    1
    cat ~/.ssh/id_rsa.pub

  • 安装一个部署插件Hexo-deployer-git，打开“Git Bash”，输入如下指令：

    1
    npm install hexo-deployer-git --save

  • 修改之前建立的自己博客项目中的_config.yml 文件

    在最后几行找到deploy，将deploye的内容改成以下内容

    1
    2
    3
    4
    deploy:
    	type: git
    	repository: https://github.com/Github用户名/Github用户名.github.io.git
    	branch: master

  • 配置好后，在Git Bash中输入

    1
    hexo clean;hexo g;hexo d

  • 出现Deploy done，就说明部署成功

  • 打开浏览器输入：https://用户名.github.io就可以看到之前在http://localhost:4000，一样的内容了

注意

在部署过程中，可能会遇到：

1
2
3
4
5
Recv failure: Connection was reset
#或者
HTTP/2 stream 1 was not closed cleanly before end of the underlying stream
#或者
Failed to connect to github.com port 443 after 21101 ms: Couldn't connect to server

以上问题都是由于没连接上Github服务器导致的，国内网连接Github服务器不稳定，时好时坏

  • 如果出现的是第三种情况，那么可以在C:\Windows\System32\drivers\etc的hosts文件中添加：140.82.113.3 github.com
  • 你可以过段时间，半小时、一小时、一天等再尝试
  • 或者，使用科学上网

安装其他主题

  • 进入hexo官网主题页面：https://hexo.io/themes/

  • 选择你喜欢的主题，点击主题的蓝色名称，便可进入主题的GIthub仓库，将

  • 进入仓库之后，点击绿色的Code按钮，将URL复制

  • 在Git Bash中输入一下内容（进入主题仓库，克隆此仓库）

    1
    2
    cd theme
    git clone 复制的URL

  • 具体的主题配置，可以参考主题官方文档即README.md有详细的说明

  • 再打开博客项目下的_config.yml找到

    1
    2
    3
    4
    # Extensions
    ## Plugins: https://hexo.io/plugins/
    ## Themes: https://hexo.io/themes/
    theme:

    在theme的后面填写主题名称——clone下来的文件夹名称

  • 在Git Bash中输入，进行部署

    1
    hexo clean;hexo g;hexo d

写一篇文章

  • 输入命令
1
hexo new "文章名"

  • 执行完命令后在/source/_post下面看到文章名.md就是文章文件了

  • 然后部署到博客上

    1
    hexo g;hexo d

  • 详细内容可以参考官方文档：https://hexo.io/docs/