hexo搭建个人博客

本文主要基于window系统以及Hexo3版本,其他系统除了软件的安装方式和命令有些差异,其他基本一样。一般hexo都是托管在github上,但是毕竟github是国外的网站,访问速度上还是有点慢,所以就将博客部署在国内的托管平台coding上。

前置步骤

所需软件:

  • node.js :因为Hexo是一款基于Node.js的静态博客框架,所以我们还需要node.js来创建Hexo博客框架。
  • git :将本地的Hexo内容提交至git中

如果已经安装好了上述必备程序,那么接下来只需要使用npm命令完成hexo的安装。

1
npm install -g hexo -cli

建站

接下来我们需要用Hexo初始化一个博客,然后更改一些自定义的配置,或者加上自己喜欢的主题,写上第一篇文章,然后发布到自己的个人coding网站(userName.coding.me)。

创建博客

将下面的userName替换成你自己的昵称,执行成功后会在指定文件夹中新建所需要的文件。

1
hexo init userName.coding.me

新建完成后,指定文件夹目录如下:

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| └── _posts
└── themes
| └── landscape

为了使博客更加美观,我们为博客安装一个双栏博客主题,切换至刚刚生成的hexo目录

1
cd userName.coding.me

安装Hexo主题yelee

1
git clone https://github.com/MOxFIVE/hexo-theme-yelee.git themes/yelee

执行完毕后会看到主题已经安装到对应目录,再修改Hexo根目录对应配置文件_config.yml,即可切换到Yelee主题

1
theme: Yelee

执行以下命令预览当前主题,测试服务启动,你可以在浏览器中输入https://localhost:4000 进行访问了。

1
hexo clean && hexo s

主题配置文件在userName.coding.me/themes/yelee/_comfig.yml中修改,本文略过,具体可查看 主题配置文档

发布博客

Coding上进行注册,然后在Coding上创建一个项目,在本地浏览自己的博客没问题后,我们就需要把博客部署到到Coding上,现在根目录下找到_config.yml文件,并进入编辑。我们找到deploy这项,具体修改如下:

1
2
3
4
5
6
7
8
9
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
#我们是使用 git 来部署的。
type: git
# git 仓库的地址,userName为coding的用户名,projectName为创建的项目名称
repo: https://git.coding.net/userName/projectName.git
#分支名称
branch: master

注意事项:修改配置文件时,必须严格按照特定的格式,必须是这个格式,type,repo,branch前两个空格,“:”后面一个空格。
按照上面的修改好_config.yml配置文件过后,还需要安装自动部署发布工具(hexo-deployer-git)才能够使用部署命令将博客部署到Coding上。

1
npm install hexo-deployer-git --save

执行config命令配置用户名和邮箱:

1
2
git config -–global user.name "xxx"
git config –-global user.email "xxx@xxx.com"

测试没问题后,就可以使用如下命令将生成的静态网页文件发布到Coding上:

1
hexo clean && hexo g && hexo d

把代码push到Coding上之前,终端会让你输入邮箱和密码,正确输入后,稍等片刻,就会将博客上传至Coding上。以后每次博客有更新,都可以使用该条命令进行发布。

Pages演示

为了能够访问博客,我们需要将博客托管到Coding Pages上,首先在本地创建一个Readme.md的文件说明,将项目文件夹初始化为Git版本库并提交Readme.md到版本库,并未项目添加远程仓库地址

1
2
3
4
git init
git add Readme.md
git commit -m 'init'
git remote add origin git@git.coding.net:{user_name}/{project_name}

在本地创建一个 coding-pages 分支,切换到该分支

1
git checkout -b coding-pages

将 coding-pages 分支推送到 Coding.net

1
git  push origin coding-pages

进入私有项目页面,点击左侧栏的 代码 面板 ,选择 Pages 服务 一项可以看到部署 Pages 的设置。(公开项目点击 Pages 选项卡即可),填写您欲部署的分支(默认为 coding-pages ),点击 立即开启 ,稍等片刻即可完成部署并通过 {user_name}.coding.me 访问您的网站。

文章目录
  1. 1. 前置步骤
  2. 2. 建站
    1. 2.1. 创建博客
    2. 2.2. 发布博客
    3. 2.3. Pages演示
|