介绍
通过
Github Page
和Hexo
来搭建博客
Hexo,可以将markdown
文件,结合主题自动转换成为网页(网页存放在public
文件夹)
注意
- github仓库的名字必须是:
yourName.github.io
,必须以你的帐号名称开头,github.io
结尾才行
准备
按照Hexo安装步骤安装下列软件依赖,详细查看(https://hexo.io/zh-cn/docs/)
- Node.js
- Git(需要配置你的GitHub帐号,详细步骤可以搜索)
- Hexo
注意
- 没有文章的时候,将会导致网址不可访问
设置主题
- 选择一个你喜欢的主题下载到
/yourSitePath/themes/xxx
1 | git clone https://github.com/WongMinHo/hexo-theme-miho.git themes/miho |
- 修改主题的配置文件
themes/xxx/_cnofig.yml
,详细配置(https://blog.minhow.com/2017/08/01/blog/installation-configuration/) - 一般上在这里设置网站的标题、描述、图片、菜单路径等
网站配置
https://hexo.io/zh-cn/docs/configuration.html
发布文章
下面展示如何通过命令行来发布文章
1 | 会通过模板文件(默认:/scaffolds/post.md)来设置文章 |
如果自己已有md文件,那么直接放入source/_post,然后在文档的头部加入如下信息,更具实际情况修改
1 | title: Hello World |
注意
- 通过模板来发布文章,如果设置了
post_asset_folder: true
,那么对应的文章引用图片如果放在了对应文章的文件夹里,那么图片的引用地址需要加上日期,cover_picture:2018/05/18/Hello-World/hello.jpeg
,因为文章是按照日期来分类的
新建页面
1 | 通过模板文件(默认:/scaffolds/page.md) source下新增一个xxx目录 |
资源文件
- 图片、js文件等
存放路径
/source
下,比如需要创建一个存放图片的文件/images
,通过images/xx.png
就可以引用了
自动部署
当你配置好网站后,就可以直接推送到github上面了
- 设置/_config.yml里的deploy关键字
1 | deploy: |
- 推送
1 | hexo deploy |
- 这样就会把
.deploy
文件夹上传到仓库里,通过 https://ilife.github.io 就可以直接访问了 - 查看自己的仓库
ls -a
,就可以看到隐藏文件(以点号开头的名字)
最后更新: 2018年05月19日 13:40