搭建hexo博客并部署到Github

前言

之前博客是用vuepress搭建的，但我觉得并不是我喜欢的类型。无意之间发现一个我喜欢的主题的博客，使用hexo搭建的，于是前段时间花了一下午也搭建起了自己的博客。

安装hexo

安装前提

安装 Hexo 相当简单，只需要先安装下列应用程序即可：

• Node.js (Node.js 版本需不低于 10.13，建议使用 Node.js 12.0 及以上版本)
• Git

如果您的电脑中已经安装上述必备程序，那么恭喜您！你可以直接前往 安装 Hexo 步骤。

安装 Git

• Windows：下载并安装 git.
• Mac：使用 Homebrew, MacPorts 或者下载 安装程序。
• Linux (Ubuntu, Debian)：sudo apt-get install git-core
• Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core

Mac 用户

如果在编译时可能会遇到问题，请先到 App Store 安装 Xcode，Xcode 完成后，启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。

Windows 用户

对于中国大陆地区用户，可以前往 淘宝 Git for Windows 镜像 下载 git 安装包。

安装 Node.js

Node.js 为大多数平台提供了官方的 安装程序。对于中国大陆地区用户，可以前往 淘宝 Node.js 镜像 下载。

其它的安装方法：

• Windows：通过 nvs（推荐）或者nvm 安装。
• Mac：使用 Homebrew 或 MacPorts 安装。
• Linux（DEB/RPM-based）：从 NodeSource 安装。
• 其它：使用相应的软件包管理器进行安装，可以参考由 Node.js 提供的 指导

对于 Mac 和 Linux 同样建议使用 nvs 或者 nvm，以避免可能会出现的权限问题。

Windows 用户

使用 Node.js 官方安装程序时，请确保勾选 Add to PATH 选项（默认已勾选）

For Mac / Linux 用户

如果在尝试安装 Hexo 的过程中出现 EACCES 权限错误，请遵循 由 npmjs 发布的指导 修复该问题。强烈建议 不要 使用 root、sudo 等方法覆盖权限

Linux

If you installed Node.js using Snap, you may need to manually run npm install in the target folder when initializing a blog.

安装 Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

$ npm install -g hexo-cli

初始化项目

新建一个文件夹，然后进入到该文件夹下

hexo init
npm install

执行这两个命令后就初始化好了

可以使用下面的命令本地运行

hexo s

项目初始化后，目录下有：

• node_modules: 依赖包
• public：存放生成的页面
• scaffolds：生成文章的一些模板
• source：用来存放你的文章
• themes：主题
• _config.yml: 博客的配置文件

部署到GitHub

GitHub创建一个仓库

登录GitHub账号，new 一个 repository

生成SSH添加到GitHub

在博客根目录下打开cmd

git config --global user.name "yourname"
git config --global user.email "youremail"

这里的yourname输入你的GitHub用户名，youremail输入你GitHub的邮箱。

然后创建SSH，一路回车即可

ssh-keygen -t rsa -C "youremail"

在控制台提示的生成目录下找到 id_rsa.pub，把里面的信息复制，然后回到GitHub，在头像->settings->SSH and GPG keys->new ssh key，把id_rsa.pub复制的信息复制到key里面，title随便取一个就行。

然后可以在cmd中查看是否成功

ssh -T git@github.com

部署hexo到仓库

打开博客根目录下的 _config.yml

deploy:
  type: git
  repo: https://github.com/YourgithubName/YourgithubName.github.io.git
  branch: master

repo就是你的仓库网址

然后安装depoly-git

npm install hexo-deployer-git --save

然后

hexo clean
hexo deploy

其中 hexo clean清除了你之前生成的东西，也可以不加。
hexo deploy 部署文章，可以用hexo d缩写

注意deploy时可能要你输入username和password。

过一会儿就可以在http://yourname.github.io 这个网站看到你的博客了!

设置个人域名

在阿里云注册一个域名，然后添加CNAME解析，解析值是yourname.github.io

登录GitHub，在仓库的settings->options->GitHub Pages->Custom domain 设置你的域名

然后在博客source文件夹下新建一个名为CNAME的文件，不要后缀，内容为你的个人域名。

最后再次部署

hexo clean
hexo deploy

过一会就可以用自己的域名访问了！

发表于：2020-09-26 16:06:18