GitHub博客

本文链接：https://www.jianshu.com/p/a27f6324373d

GitHub Pages可以用于建立个人或组织网页、项目主页。

博客框架可以用jekyll和hexo，这里用jekyll。

步骤

首先用GitHub Pages建立个人网站，在GitHub新建仓库，仓库名称是 username.github.io

新建仓库

访问网址username.github.io

第一次打开网页

clone仓库到本地

git clone https://github.com/username/username.github.io

添加主页

cd username.github.io
echo "Hello World" > index.html

推送

git add --all
git commit -m "Initial commit"
git push -u origin master

打开网页 https://username.github.io 成功

安装jekyll，并新建blog

sudo gem install bundler jekyll  这里安装了一大堆东西
jekyll new . --force
bundle install  第一次安装使用jekyll需要运行这句

安装jekyll成功

工程目录

工程目录完整版

删除之前的主页

rm index.html

启动jekyll

jekyll serve
# => Now browse to http://localhost:4000

成功

启动jekyll

welcome to jekyll

推送后，打开网页 https://username.github.io 成功。

main page

发布新文章。在_posts文件夹创建文件，文件名格式为

年-月-日-标题.MARKUP

在这里，年是 4 位数字，月和日都是 2 位数字。MARKUP扩展名代表了这篇文章是用什么格式写的。下面是一些合法的文件名的例子：

2011-12-31-new-years-eve-is-awesome.md
2012-09-12-how-to-write-a-blog.textile

修改保存文件，刷新网页就可以看到修改后的内容。不需要重启服务器。

笔记

用户和组织的站点

用户和组织的站点被放置在一个特殊的专用仓库中，在该仓库中只存在 Github Pages 的相关文件。这个仓库应该根据用户/组织的名称来命名， 例如： @mojombo 的用户站点仓库 应该被命名为 mojombo.github.io 。

仓库中master分支里的文件将会被用来生成 Github Pages 站点，所以请 确保你的文件储存在该分支上。

项目的站点

不同于用户和组织的站点，项目的站点文件存放在项目本身仓库的 gh-pages 分支中。该分支下的文件将会被 Jekyll 处理，生成的站点会被 部署到你的用户站点的子目录上，例如 username.github.io/project （除 非指定了一个自定义的域名）。

Jekyll 项目本身就是一个很好的例子，Jekyll 项目的代码存放在 master 分支 ， 而 Jekyll 的项目站点（就是你现在看见的网页）包含在同一仓库的 gh-pages 分支 中。

error

$ jekyll serve
/System/Library/Frameworks/Ruby.framework/Versions/2.3/usr/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require': cannot load such file -- bundler (LoadError)
    from /System/Library/Frameworks/Ruby.framework/Versions/2.3/usr/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require'
    from /Library/Ruby/Gems/2.3.0/gems/jekyll-3.8.0/lib/jekyll/plugin_manager.rb:48:in `require_from_bundler'
    from /Library/Ruby/Gems/2.3.0/gems/jekyll-3.8.0/exe/jekyll:11:in `'
    from /usr/local/bin/jekyll:22:in `load'
    from /usr/local/bin/jekyll:22:in `
'

解：安装bundler。

参考

GitHub Pages
https://pages.github.com/

Jekyll • 简单静态博客网站生成器 - 将纯文本转换为静态博客网站
http://jekyllcn.com/

Installation | Jekyll • Simple, blog-aware, static sites
https://jekyllrb.com/docs/installation/#macOS