Published on

用 Hexo 构建个人博客

具体步骤如下：

注册 Github 账号

略 记录下你的 GitHub 用户名，以下用 username 代表你的 Github 用户名。

在 Github 上创建仓库

此仓库必须命名为 username.github.io。

安装 git

略。 PS：Mac 下安装 git 前保证你已经安装了 Xcode，不然会影响编译。

安装 Node.js

略。

安装&&配置 Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

文档：摸我

安装

  • windows 下：npm install -g hexo-cli
  • mac 下：sudo npm install hexo --no-optional

Hexo 基本使用

cd git
hexo init [name]       #初始化名为[name]的hexo目录。不加[name]则在当前路径下初始化。
cd [name]
npm install            #安装依赖
hexo generate(hexo g)  #自动根据当前目录下文件,生成静态网页（简写hexo g）
hexo server(hexo s)    #运行本地服务,打开localhose:4000 即可访问。

hexo new "name"        #新建文章,name为文章标题

主题配置

#以配置Hexo Yilia主题为例
cd ~/git/[name]  #进入博客根目录
git clone [email protected]:litten/hexo-theme-yilia.git themes/yilia
#在./_config.yml文件中，修改theme: yilia

Hexo 博客目录结构

├── .deploy       #需要部署的文件
├── node_modules  #Hexo插件
├── public        #生成的静态网页文件
├── scaffolds     #模板
├── source        #博客正文和其他源文件, 404 favicon CNAME 等都应该放在这里
|   ├── _drafts   #草稿
|   └── _posts    #文章
├── themes        #主题
├── _config.yml   #全局配置文件
└── package.json

配置 SSH

由于之前已经在 mac 上安装过 Github 客户端，检查到已经存在 SSH，在Github SSH 配置页 也已经存在 SSHkey，于是直接测试是否配置成功，结果顺利通过测试，所以这步我直接就跳过了。

不过在这里还是把步骤贴过来：

  • 检查是否存在 SSH 文件 上传文件需要配置 ssh key，不然无法上传。 首先先检查一下本地是否已经存在 ssh key,在 Git Bash 输入以下指令，检查是否已经存在了 SSH keys。 ls -al ~/.ssh 如果不存在就没有关系，如果存在的话，直接删除.ssh 文件夹里面所有文件。 PS：此段存疑，可能之前有配置过，或者 Github 客户端已经帮你配置过就不用删除，可直接拿来使用。
  • 设置 name 和 email git config --global user.name "<your name>" git config --global user.email "<your email>" 需要注意的是这里的 name 是随意的，邮箱是你的联系邮箱，与 github 上的邮箱没有什么联系。
  • 生成 ssh 密钥 输入以下指令（邮箱就是你注册 Github 时候的邮箱）后，回车： ssh-keygen -t rsa -C "[email protected]" 一路回车即可，如果设置了密码请记住。 这一步在~/.ssh/下生成了两个文件 id_rsa 和 id_rsa.pub。
  • 获取 Key $ cat ~/.ssh/id_rsa.pub 然后拷贝 key
  • 在 Github 上添加 SSH 密钥 在Github SSH 配置页 下添加新的 SSH key 然后 title 随便取个名字，key 就是上面我们拷贝的内容，
  • 测试是否配置成功 输入以下命令： ssh [email protected] 成功的话会显示以下内容：

The authenticity of host 'github.com (192.30.252.128)' can't be established. RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added 'github.com,192.30.252.128' (RSA) to the list of known hosts. Hi xxxx! You've successfully authenticated, but GitHub does not provide shell access. Connection to github.com closed.

将博客部署到 Github

安装 hexo-deploy npm install hexo-deploy-git --save

修改_config.yml 配置文件

deploy:
  type: git
  repo: ssh://[email protected]/username/username.github.io
  branch: master
  message: [message]

参数简介： repo：库（Repository）地址 branch：分支名称。如果您使用的是 GitHub 或 GitCafe 的话，程序会尝试自动检测。 message：提交信息 (默认为 Site updated: 当前时间)

执行部署：hexo deploy

访问页面

到此已经初步成功，可以通过https://username.github.io/访问你的新博客了。

绑定个人域名

如果你不想用 github.io 域名的话，可以绑定个人域名，步骤如下：

  • 购买个人域名：
    • 购买：GoDaddy，也可选择其他域名提供商。
    • 国外域名提供商不用备案，方便。
  • 配置域名解析服务：
    • 到DNSPod注册账号，使用域名解析功能来对你购买的新域名进行解析。
    • 配置略。
  • 在项目的 source 目录下增加 CNAME 文件，里面填上的域名。

到此域名配置已经完成，一段时间后即可通过自定义域名访问博客。（域名解析需要一定时间）

Table Of Contents