讲在前面的话,这算是我写的第一篇博客,有很多地方都还不熟悉。
这篇博客主要是记录我使用GitPages搭建Jekyll的过程,以及其中遇到的一些问题和解决办法。
本人环境:MacOS、brew、git、gem
使用GitHub Pages搭建博客
1. 使用Github创建GitHub Pages项目
适用于没有服务器和域名的情况下
(如果有账号的可以跳过这一步)
GitHub
1.首先需要创建GitHub账号。
pick a username? 创建一个属于你的用户名
you@example.com?输入你的邮箱地址
Create a password?这个就是密码咯~
2.使用刚注册好的账号登陆GitHub。
- 在右上角”+”点击”New Repository”
创建一个基于GitHub用户名的项目
譬如我的GitHub名字是”czre”,所以我的github地址为”www.github.com/Czre”
而这个项目名字为”blog”,所以我的项目地址为”www.github.com/Czre/blog\”一般都是创建的public(公开的,所有人都可以访问到的)项目,private(私有是收费的)
- “Descrption”描述。随便写点什么的介绍~
“Initialize this repository with a README”大概意思:是否初始化一个README.md文件。可以勾选,也可以后期手动创建该文件。
PS:这个文件的内容将会在你的项目首页显示,也是本文所使用的一种书写格式,Markdown,通常以.md或.markdown结尾的文件格式。
3.点击”Create Repository”创建项目。
4.此时会进入你的项目首页,项目地址为”www.github.com/用户名/项目名”
5.点击”Settings”
6.找到”Github Pages”,将”Source”中的”None”改为”master branch”并点击”Save”。
这一步是将你的项目的”master branch”分支设置为Github Pages,如果有问题需要创建”gh-pages”分支并重新指定会解决。
2. 安装Git并拉取分支,部署Jekyll
- 安装Git
这一步的教程略过 安装过程可以百度 关键词 git安装 git教程
拉取代码
在项目页,找到原谅色按钮”clone or download”复制链接,通常为”https://github.com/用户名/项目名.git”。
调出命令行:
- windows为win键+R键,输入cmd
git clone https://github.com/用户名/项目名.git
使用git命令克隆项目代码
安装Ruby
- window安装:Ruby
- mac使用brew安装
brew install ruby
- linux使用相应的yum(centOS) or apt-get(ubuntu) install ruby
yum install ruby
apt-get install ruby
笔者这里使用的mac系统,所以使用brew安装,附上brew安装链接
ruby -e "$(curl -fsSLhttps://raw.githubusercontent.com/Homebrew/install/master/install)"
RubyGems
//在上面给出的链接中下载RubyGems插件
//在Terminal中
cd yourpath to RubyGems //跳转到你解压的位置,注意是在ruby-gems文件夹下
ruby setup.rb // 执行命令
- 使用gem安装jekyll
gem install jekyll
配置Jekyll
Jekyll Themes找到自己喜欢的模板。
将下载好的模板复制到从git中clone的项目文件夹下。
修改_config.yml文件PS:重要,将plugins:[]修改为plugins: [‘jekyll-paginate’]
cd jekyll path // 移动到你的jekyll项目下,也就是你从git里clone下来的项目 jekyll serve // 启动服务,默认链接地址\"http:localhost:4000\"
期间遇到的一个问题:
Configuration file: /Users/czre/git/blog/_config.yml Deprecation: The 'gems' configuration option has been renamed to 'plugins'. Please update your config file accordingly. Dependency Error: Yikes! It looks like you don't have jekyll-paginate or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- jekyll-paginate' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/!
这个原因是因为没有jekyll-paginate,使用gem install jekyll-paginate安装一下就好了。
另外也有可能出现没有jekyll-gist错误,解决方法同上,这些错误取决模板所采用的一些服务。
所有的博客文章都在_post下,使用.md或.markdown来命名的文件。--- layout: post title: "记:使用Jekyll在GitHubPages搭建博客~" date: 2018-04-22 01:13:17 +0800 categories: 日记 --- ---
每篇文章的开头都需要使用yml格式来声明。
完成
大概到这儿使用GitPages搭建Jekyll写博客就到此为止了,博客首发GithubPages,我的GithubPages地址