如何使用hexo + github pages建立个人博客

| |
| 本文字数： 1.5k | 阅读时长 ≈ 1 分钟

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

hexo

安装

hexo官方文档：https://hexo.io/zh-cn/docs/

按照官网文档安装hexo，安装hexo之前需要先安装 node（推荐使用 nvm 安装） 和 git

基本使用

  1. 初始化网站：

    1
    2
    hexo init <dirName> # 也可以新建一个空目录，然后执行 hexo init
    npm install # npm安装

  2. 生成静态文件：

    1
    hexo g # 或者使用 hexo generate

  3. 启动本地服务：

    1
    hexo s # 或者使用 hexo server，然后通过http://127.0.0.1:4000访问

常用命令：

1
2
3
4
hexo n == hexo new			# 新建文章、页面等
hexo g == hexo generate		# 生成静态文件
hexo s == hexo server		# 启动服务
hexo d == hexo deploy		# 发布

主题

官方主题地址：https://hexo.io/themes/

这里使用的是 next，地址：http://theme-next.iissnan.com/

只要将主题放到 themes 目录下，然后修改站点配置文件 _config.yml 中的 theme 值即可

具体设置可以参考上面的next文档

使用github部署hexo

修改站点配置文件 _config.yml ：

1
2
3
4
deploy:
    type: git
    repo: git@github.com:cpp288/cpp288.github.io.git  #这里的网址填你自己的
    branch: master

配置github ssh key：

  1. ssh-keygen -t rsa -C "邮件地址@youremail.com" 生成新的key文件，邮箱地址填你的Github地址，后面直接回车进行
  2. 将生成的工钥 id_rsa.pub 配置到 github 上
  3. 执行 ssh -T git@github.com 如下提示则成功
    1
    Hi cpp288! You've successfully authenticated, but GitHub does not provide shell access.

安装扩展：

1
npm install hexo-deployer-git --save

部署到 github：

1
hexo d

相关问题

电脑重装了系统/多台电脑写博客？

参考博客：

如何添加本地图片？

在 source 目录下新建目录，将图片放在其中（可以建多级目录），hexo 会在 generate 时将图片放到 public 中，使用 markdown 图片语法即可

相关博客