hexo+Github 快速搭建个人博客


一、提前准备

1-1、安装Git

1-2、安装Nodejs

1-3、注册Github账号


二、安装Hexo、部署到Github仓库

2-1、安装、初始化Hexo

  • 在一个选定目录,新建 Blog 文件夹。(其它名也行)
  • 进入到该文件夹,打开命令行
    • 执行 npm install -g hexo-cli 命令,安装hexo;
    • 执行 hexo init 命令初始化。
      于是在Blog下生成如下目录:
    • 执行 hexo s 或是 hexo serve

      便可以在浏览器打开红框中网址,看到博客已经(初步)搭建完成!

  • 对生成目录的重要部分进行说明
    • source:用来存放你的文章
    • themes:主题
    • _config.yml: 博客的配置文件

2-2、新建GitHub仓库

  • 登录Github,点击头像旁边的“+” ==》 new repository
  • 输入仓库名称,及其他配置
    • 命名格式:{用户名}.github.io 严格遵守
    • 注意下图三个地方
    • 确认无误后,创建仓库
  • 配置Blog文件夹下的_config.yml文件

2-3、部署到Github

  • 安装部署所需组件:
    • Blog 目录下,打开命令行,执行:
    • npm i --save hexo-deployer-git
  • Blog 目录下,打开命令行,依次执行如下命令:
    • hexo clean 清除静态文件
    • hexo g 生成静态文件(页面)
    • hexo d 部署到Github
  • 访问:

2-4、新建文章

文章存储在 Blog/source/_posts/ 路径下。

  • 可以在该目录下直接新建 .md 文件,用markdown语法写文章。
  • 也可以在改目录下,嵌套子目录,再在子目录新建文章。
  • hexo会自动识别到新增的文章。

三、整体配置、主题安装

3-1、Hexo整体配置

  • Blog/__config.yml 文件中进行
  • 主要配置网站的一些基础信息:
    • 网站标题
    • 网站部署的Github仓库(之前配置过)
    • 所用到的主题
    • ……
  • 具体参考官方文档:

3-2、安装主题

为什么需要主题呢?就初始化后看到的网页吧,整体比较质朴,低情商:比较丑。
通过安装主题,可以直接套用一些大佬的优秀模板,实现更好的视觉效果、文章编辑体验。

A、寻找、安装主题

  • 直接在 Github 搜索 hexo-theme
  • 可以点开到主页预览,选择一个自己喜欢的风格,这里以我使用的 matery 为例。【也比较推荐,还是挺好看的】
    • 直接下载源代码
    • 解压后得到这堆东西
    • Blog/themes 新建 matery 文件夹,把这堆粘贴进去。

B、配置主题、测试

  • Blog目录下的 _config.yml 文件中配置使用的主题
  • 测试【之后更新内容也都可以通过这一套连招,更新网站内容】
    • hexo clean
    • hexo g
    • hexo d
    • 打开github.io 那个网站,刷新,查看效果。

主题也可以进行很多的配置,从而更加个性化,更加符合你的使用习惯

  • 主题的配置文件在: Blog/themes/matery/__config.yml
  • 详细的配置参考官方文档:
    • https://github.com/blinkfox/hexo-theme-matery/blob/develop/README_CN.md
    • 建议顺着文档,都自行配置一下。【能更了解这个主题有些什么更功能模块可以用】

      文档很详细,很通俗易懂,建议顺着这个文档配置一下。文档中不仅包含了对网站模块的定制化修改,还包含了许多使用技巧:评论模块的配置、emoji表情的配置、访问量统计插件的引用……
      操作也很简单、顺着配置一遍,也基本能的到一个比较满意的个人博客啦!


  • 最后,这是我搭建的个人博客 https://pxoxq.github.io,用的是文中推荐的主题。
  • 后续,打算再记录一些 hexo中文章撰写技巧、一些好用的插件、配置细节等等。

文章作者: pxoxq
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 pxoxq !
  目录