GitHub博客

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

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

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

步骤

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

GitHub博客_第1张图片
新建仓库

访问网址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需要运行这句
GitHub博客_第2张图片
安装jekyll成功
GitHub博客_第3张图片
工程目录
GitHub博客_第4张图片
工程目录完整版

删除之前的主页

rm index.html

启动jekyll

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

成功

GitHub博客_第5张图片
启动jekyll
GitHub博客_第6张图片
welcome to jekyll

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

GitHub博客_第7张图片
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

你可能感兴趣的:(GitHub博客)