hexo与github/gitee配置个人博客

Hexo + Github/Gitee搭建个人博客

安装Hexo

安装hexo需要安装以下应用：

  • Node.js(建议使用12.14.0版本，过高会报错)
  • Git

安装Node.js

  • 通过Node.js官网下载安装

  • 通过nvm下载安装：可以方便的切换版本

    1.下载nvm

    ​ 推荐选择nvm-setup.zip

    ​ 下载完成后解压得到nvm-setup.exe，运行即可

    • 运行nvm出现版本及提示信息

    2.配置淘宝镜像

    ​ 打开nvm安装路径中的setting.txt,加入下面内容:

    1
    2
    node_mirror: https://npm.taobao.org/mirrors/node/	
    npm_mirror: https://npm.taobao.org/mirrors/npm/

    3.安装node

    ​ 获得所有node版本 

    1
    nvm list available

    ​ 安装指定版本

    1
    nvm  install version

    ​ 获得当前已安装版本

    1
    nvm list

    ​ 切换版本

    1
    nvm  use  version

    4.检测是否安装成功

    ​ 依次执行如下命令，获得版本

    1
    2
    node -v
    npm -v

安装Git

  • 通过Git官网下载安装

安装Hexo

​ 输入如下命令：

1
npm install -g hexo-cli

搭建博客

创建仓库

首先你需要一个Github账号，没有的话去注册一个

  • 创建新仓库

    点击右上角 + 号，选择New repository

  • 创建名为你的用户名.github.io的仓库

    注意，必须用自己的用户名，否则无效

配置Git

设置用户名及邮箱

1
2
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

配置SSH Key

提交代码需要github权限，但直接使用用户名及密码不安全，所以使用ssh key来解决本地与服务器连接的问题

  • 配置ssh key

    • 输入如下语句：
    1
    ssh-keygen -t rsa -C "你的GitHub邮箱"
    • 获得公钥：

    ​ 打开用户目录，找到.ssh\id_rsa.pub文件，记事本打开并复制里面的内容

    • github配置

      打开你的github主页，进入个人设置 -> SSH and GPG keys -> New SSH key，将刚刚的内容复制到key中，title可以随便填

  • 检测是否配置成功

    输入如下语句：

    1
    ssh -T git@github.com # 注意邮箱地址不用改

    若提示Are you sure you want to continue connecting (yes/no)?，输入yes，然后会看到：

    1
    Hi yourname! You've successfully authenticated, but GitHub does not provide shell access.

    说明配置成功

使用Hexo写博客

初始化博客

进入hexo所在文件夹，输入如下语句：

1
hexo init

之后hexo会自动下载一些文件，之后输入：

1
2
hexo g  #生成界面
hexo s  #启动服务

之后就可以在http://localhost:4000本地看到内容了。若一直转圈不加载，说明该端口被占用。

部署Hexo到Github

  • 安装hexo-deployer-git插件（可选）

    1
    npm install hexo-deployer-git --save

  • 在_config.yml文件末尾添加如下内容：

    1
    2
    3
    4
    deploy:
      type: git
      repo: <GitHub库的地址> # 例如：https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
      branch: master

    注意每个冒号后都有空格，否则会报错。

    若未安装hexo-deployer-git插件，则输入如下语句：

    1
    2
    3
    4
    deploy:
      type: git
      repository: git@github.com:liuxianan/liuxianan.github.io.git
      branch: master

  • 部署到Github

    1
    2
    hexo clean #最好在每次hexo d之前用一下
    hexo deploy

    若部署后没有改变，通常为缓存问题，等待一会即可

主题设置

参考这篇文章的配置

常用语句

1
2
3
4
5
6
7
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本

写博客

在hexo目录下输入：

1
hexo new '博客名字'

hexo会自动在 /source/_post/目录下生成.md文件，格式为

1
2
3
4
5
6
7
8
9
---
title: postName #文章页面上的显示名称，一般是中文
date: 2013-12-02 15:30:16 #文章生成时间，一般不改，当然也可以任意修改
categories: 默认分类 #分类
tags: [tag1,tag2,tag3] #文章标签，可空，多标签请用格式，注意:后面有个空格
description: 附加一段文章摘要，字数最好在140字以内，会出现在meta的description里面
---

以下是正文

绑定域名

ping获得网站的ipv4地址，输入到购买的域名那里

在github选择setting-pages，输入域名

在github的项目中新建一个叫CNAME的文件，输入域名

其他
hexo

本博客所有文章除特别声明外，均采用 CC BY-SA 4.0 协议 ，转载请注明出处！