Hexo搭建静态博客,部署到github

1. 准备条件

  • 本地安装git、nodejs
  • 本地与github远程仓库已配好密钥对
  • github上建立username.github.io的远程仓库

    2. 本地安装hexo

1
$ npm install -g hexo #全局安装

3. 本地建立你的博客目录

这个文件夹用来生成博客,建好之后在目录中打开bash

1
2
$ hexo init #初始化为hexo工作目录
$ npm install #自动安装nodejsy模块

4. 博客已经生成,可以预览了

生成官方模板,先预览一下,停止预览在bash中按ctrl+C

1
2
$ hexo server #本地服务器运行博客
INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

4. 新建markdown博文

之前自动生成了一篇hello博文,所有博文放在博客根目录的下的\source_posts

1
2
$ hexo new "node" #创建指定名字的博文
INFO Created: G:\hexogithub\source\_posts\node.md

这时开启hexo server 博文列表中就会多一篇标题为node的博文

5. 生成html博客

前面生成的静态博客可以在本地服务预览了,接下来部署到github

1
$ hexo generate #生成用于上传到github仓库的发布文件

6. 修改配置文件

修改博客根目录的配置文件_config.yml,指定部署的目标路径之类的

1
2
3
4
5
6
7
8
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git #必须为git,:之后都要空一格
repository: git@github.com:pl2476/pl2476.github.io.git
# 远程github仓库地址,自己的首页仓库地址
branch: master # 指定发布分支
# 如果要用别的仓库发布,则需要用gh-pages分支

6. 开始部署

前面已经用generate生成了了用来发布的博客,在博客根目录的public目录

1
2
3
$ hexo deploy # 实际上是上传public中的文件到远程仓库
# 建议每次修改后用命令清除public,然后再生成和发布
$ hexo clean

7. 修改主题

可以在官方网站,github找到很多自己喜欢的主题

  • 下载下来或者git clone 到博客根目录下的themes文件夹
  • 改配置文件_conf.yml
    1
    2
    3
    4
    5
    #找到下列拓展部分
    # Extensions
    ## Plugins: https://hexo.io/plugins/
    ## Themes: https://hexo.io/themes/
    theme: XX #此处修改为下载下来的主题文件夹名

8. 自定义及插件拓展

  • 主题文件夹下的配置文件_conf.yml可以自定义主页de一些内容
  • 如需修改一些主题样式直接在主题文件夹中找到对应样式修改
  • 官方网站有很多插件拓展,具体可查看文档

More info: 官方文档

文章目录
  1. 1. 1. 准备条件
  2. 2. 2. 本地安装hexo
  3. 3. 3. 本地建立你的博客目录
  4. 4. 4. 博客已经生成,可以预览了
  5. 5. 4. 新建markdown博文
  6. 6. 5. 生成html博客
  7. 7. 6. 修改配置文件
  8. 8. 6. 开始部署
  9. 9. 7. 修改主题
  10. 10. 8. 自定义及插件拓展
,