GitHub提供域名解析和300MB免费空间,利用静态网站生成工具生成网页,提交后即可看到。网页生成工具有Jekyll, Octopress, Hexo等。这里选择Hexo,速度快,对中文支持较好
官网:https://hexo.io/zh-cn/docs/
GitHub Pages Setup
- New一个repository即可,域名为username.github.io
https://pages.github.com
先不用clone到本地,也不用生成任何类似于index.html的文件 - GitHub客户端:
Download GitHub for Mac
Hexo Setup
- install node.js
- 命令行:
curl https://raw.github.com/creationix/nvm/master/install.sh | sh
nvm install 0.10
- 命令行:
- 或者客户端:Download for OS X (x64)
- Install Hexo
sudo npm install -g hexo-cli
你看到的是非授权版本!爬虫凶猛,请尊重知识产权!
转载请注明出处:http://conanwhf.github.io/2015/10/02/Git+Hexo+Markdown.Blog/
访问原文「Git+Hexo+Markdown搭建Blog」获取最佳阅读体验并参与讨论
New Blog
- Init Blog
mkdir ~/blog; cd ~/blog/ hexo init npm install hexo generate
- 把GitHub Pages项目clone到
~/blog/public
from GitHub,先在某处clone然后拷贝.git文件夹也行,总之把public文件夹作为GitHub的source - commit, 打开username.github.io看效果
Add/Remove blogs
Hexo的命令行new本质上是生成一个固定格式的文件,还要二次修改内容才能发布,所以我选择手动添加删除文章,只要采用markdown格式即可
- 所有md文件放在source/_posts/下,文件名无要求,手动管理
- 文件头部固定格式:
所有的东西都可省略,但title若省略则发布后为notitle,date省略则自动把生成静态网页的时间拿来填充。这些头部信息可用_textpexpender_生成title: $Title date: 2015-09-25 19:13:06 categories: $CATEGRIES tags: - $Tag1 - $Tag2 ---
- 发布时“hexo generate”,再commit to git即可。注:每次都是整站发布,source里面需要保留所有待发布及已发布的文章
Hexo简单Config
- 所有配置都在blog目录下进行
- 配置文件为_
config.yml
,基础配置修改即可。基本上只要改_title_,_subtitle_,_description_,_author_这几项就可以了 - 需要调试的话先hexo g再hexo s,就可以在本地http://0.0.0.0:4000/看demo,一般的配置修改后直接刷新看效果
- yml文件语法很严格,如果hexo g出错基本上都是配置问题,仔细看看空格全角半角这些