使用git + hexo 建立个人博客

Posted on   |   In

安装 hexo

  1. 安装node
  2. 安装npm
  3. 安装hexo: npm install -g hexo-cli

建立一个新博客

  1. hexo init blog:使用该命令会在blog目录下建立一个博客并且在source/_posts/hello-world.md生成一篇名为hello world的文章，随后你可以选择删除它并新建自己的文章。
  2. cd blog
  3. hexo g:使用该命令将 source/_posts/hello-world.md 渲染为html、css、js静态资源
  4. hexo s:开启服务器。然后http://localhost:4000/

关联至github

  1. 新建仓库xxx.github.io，这里 xxx 可以是你想要取的名字，但是必须以github.io结尾

  2. 此时可以访问https://xxx.github.io，但是没有内容

  3. 修改blog目录下配置文件_config.yml，找到deploy选项，修改(新增)为:

    1
    2
    3
    4
    deploy:
      type: git
      repository: git@github.com:xxx/xxx.github.io.git 
      branch: master

  4. 安装插件npm install hexo-deployer-git --save

  5. hexo d -g 生成内容后部署

  6. 访问https://xxx.github.io，应该要延迟一段时间才能看到效果

更换主题

由于初始的主题不怎么好看，可以选择更换一下主题。官方主题地址为hexo-themes。本教程中采用maupassant-hexo为主题

  1. 由于大部分的主题都托管在github上，在blog目录下运行:

    git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant

    themes/xxx是hexo存放xxx主题的目录

  2. npm install hexo-renderer-pug --save

  3. npm install hexo-renderer-sass --save --registry=https://registry.npm.taobao.org

  4. 修改_config.yml中主题为theme: maupassant

  5. hexo g重新生成

  6. hexo s开启服务器

主题还有许多可用的配置，请参照上面给出的链接进行设置

目录、tag

需要归档和tag只需要在markdown上加上一些YAML头部信息:

1
2
3
4
5
---
title: hello
categories: 杂谈
tag: 杂七杂八
---

即可