介绍

通过Github PageHexo来搭建博客

Hexo,可以将markdown文件,结合主题自动转换成为网页(网页存放在public文件夹)

注意

  • github仓库的名字必须是:yourName.github.io,必须以你的帐号名称开头,github.io结尾才行

准备

按照Hexo安装步骤安装下列软件依赖,详细查看(https://hexo.io/zh-cn/docs/)

  1. Node.js
  2. Git(需要配置你的GitHub帐号,详细步骤可以搜索)
  3. Hexo

注意

  1. 没有文章的时候,将会导致网址不可访问

设置主题

  1. 选择一个你喜欢的主题下载到/yourSitePath/themes/xxx
1
$ git clone https://github.com/WongMinHo/hexo-theme-miho.git themes/miho
  1. 修改主题的配置文件themes/xxx/_cnofig.yml,详细配置(https://blog.minhow.com/2017/08/01/blog/installation-configuration/)
  2. 一般上在这里设置网站的标题、描述、图片、菜单路径等

网站配置

https://hexo.io/zh-cn/docs/configuration.html

发布文章

下面展示如何通过命令行来发布文章

1
2
3
4
5
6
7
8
# 会通过模板文件(默认:/scaffolds/post.md)来设置文章
$ hexo new [layout] <title>

# 清除网站的缓存,因为有可能删除了一些页面
$ hexo clean

# 重新生成
$ hexo generate

如果自己已有md文件,那么直接放入source/_post,然后在文档的头部加入如下信息,更具实际情况修改

1
2
3
4
5
6
7
title: Hello World
categories: Free
tags:
- mind
cover_picture: images/default.jpeg
date: 2018-05-18 20:48:01
---

注意

  • 通过模板来发布文章,如果设置了post_asset_folder: true,那么对应的文章引用图片如果放在了对应文章的文件夹里,那么图片的引用地址需要加上日期,cover_picture:2018/05/18/Hello-World/hello.jpeg,因为文章是按照日期来分类的

新建页面

1
2
3
4
5
6
7
8
# 通过模板文件(默认:/scaffolds/page.md) source下新增一个xxx目录
$ hexo new page "xxx"

# 清除网站的缓存,因为有可能删除了一些页面
$ hexo clean

# 重新生成,然后可以看到public里出现了xxx的文件夹,所有的md,都会转换为对应的静态页面
$ hexo generate

资源文件

  • 图片、js文件等

存放路径

  1. /source下,比如需要创建一个存放图片的文件/images,通过images/xx.png就可以引用了

自动部署

当你配置好网站后,就可以直接推送到github上面了

  1. 设置/_config.yml里的deploy关键字
1
2
3
4
deploy:
type: git
repository: https://github.com/iLifexiao/ilife.github.io.git
branch: master
  1. 推送
1
$ hexo deploy
  • 这样就会把.deploy文件夹上传到仓库里,通过 https://ilife.github.io 就可以直接访问了
  • 查看自己的仓库ls -a,就可以看到隐藏文件(以点号开头的名字)

最后更新: 2018年05月19日 13:40

原始链接: https://ilifexiao.github.io/2018/05/18/Hello-World/