Hexo博客搭建

发表于 分类于 阅读次数： 本文字数： 1.5k
利用github/gitee和node.js快捷进行个人博客的搭建。

1. 环境准备

git安装

Windows：进入git官网下载Windows安装包进行安装即可，官网下载速度慢可以使用淘宝镜像

Linux：通过包管理工具安装git或进入git官网选择tarballs进入下载归档文件进行源代码构建安装

Node.js安装

可以进入淘宝镜像进行下载安装包或归档文件进行安装，注意添加环境变量

2. 安装Hexo

npm install -g hexo-cli

3. Hexo工程创建

  • 建立一个Hexo的工程目录，进入该目录
  • hexo init 进行初始化
  • npm install安装相关依赖

4. 文件说明

项目结构：

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

_config.yml：网站的配置信息，您可以在此配置大部分的参数。详细配置见配置

package.json：应用程序的信息。EJS, Stylus和 Markdown renderer 已默认安装，您可以自由移除。

scaffolds：模版 文件夹。当您新建文章时，Hexo 会根据 scaffold 来建立文件。

source：资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes：主题 文件夹。Hexo 会根据主题来生成静态页面。

5. 相关命令

命令详解

hexo init [folder]：新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。

hexo new [layout] <title>：新建一篇文章。如果没有设置 layout 的话，默认使用_config.yml中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来。

hexo generate：生成静态文件，可以简写为hexo g

  • -d，–deploy：生成文件后立即部署
  • -w，–watch：监视文件变动

hexo publish [layout] <filename>：发表草稿

hexo server：启动服务器，默认在4000端口

  • -p，–port：重设端口
  • -s，–static：只使用静态文件
  • -l，–log：启动日记记录，使用覆盖记录格式

hexo deploy：部署网站，可以简写为hexo d

  • -g，–generate：部署之前预先生成静态文件

hexo render <file1> [file2]...：渲染文件

  • -o，–output：设置输出路径

hexo migrate <type>：从其他博客系统迁移内容

hexo clean：清除缓存文件和已生成的静态文件

hexo version：显示Hexo版本

本地部署

启动服务器：hexo server

内容修改后刷新重启：hexo clean hexo generate/g hexo deploy/d hexo server

在线部署

修改_config.yml最后添加

1
2
3
4
deploy:
    type: git
    repository: https://github.com/你的GitHub名/你的GitHub名.github.io.git
    branch: master

使用git部署, 输入指令npm install hexo-deployer-git --save

输入指令hexo clean hexo generate hexo deploy 对博客进行提交

该指令可以简化为hexo clean && hexo d -g

参考内容：Hexo文档