Github建站笔记

下载Git

• 搜索“Git”，在官网中根据系统版本下载，并双击打开，按默认已勾选组件点下一步;
• 勾选在Windows命令行窗口中使用Git；
• 使用推荐的OpenSSL库用于HTTPS连接；
• 一路默认安装即可。

使用Git 命令创建仓库

1. 新建本地仓库
   双击打开Git Bash，配置你的GitHub用户：

git config --global user.name "charleechan"
git config --global user.email "charleechan@163.com"

键入你要新建仓库的位置，如：

cd /d/Code/charleechan.github.io

开始创建代码仓库：

git init

2. 在该文件夹下新建代码文件即可，这里方便测试，新建GitTest.txt，输入命令

    git add .		# 添加所有文件
    git add test.txt		# 添加单个文件
    git status		# 查看git状态
    git commit -m "It's my Test WebPage file."

3. 查看上传日志

git log

使用界面创建仓库

1. 找一个目录来作为你本地的仓库,比如我的是”F:Cloud”,那么就在Cloud文件夹下初始化仓库.

2. 初始化仓库的方式有两种,一种是用git的图形化界面来创建,另一种是用git命令来初始化,这里我选用
   图形化界面的方式来创建(极(lan)力(ren)推(bi)荐(bei));

3. 来到Cloud目录下右键选择Git GUI Here–>选择Create New Repository

配置SSH Key

1. 如果C:uersccl没有.ssh文件夹，需要创建SSH Key：
   ssh-keygen -t rsa -C "charleechan@163.com"

2. 把生成的key填写到Github中,在右上角头像的Settings的SSH and GPG keys那里填,title随便写,主要是用来注明的，把刚才id_rsa.pub里面的内容复制到Title下面的Key内容框里面

提交代码

1. 新建远程仓库，注意不要勾选添加Readme!!!!!注意不要勾选添加Readme!!!!!注意不要勾选添加Readme!!!!!
   如果勾选了，你需要先将远程库的文件合并到本地库：

git pull --rebase origin master

首先与远程库创建关联：

git remote add origin https://github.com/charleechan/charleechan.github.io.git

或

git remote add origin git@github.com:charleechan/charleechan.github.io.git

注:在创建好Github仓库后有两个地址,一个是https的地址,另一个是SSH地址,也就是上面这个地址. 然后上传到仓库(首次上传需要登陆账户密码)：

git push -u origin master	(执行这个之前必须先在本地做一次提交操作)

在自己仓库那里找到Settings,配置Github Pages，通过Github Pages那里给的地址访问自己的网页

进阶：

使用jekyll模板

1. 安装Ruby, 去https://rubyinstaller.org/下载，安装rubyinstaller-devkit-2.4.4-2-x64即可，然后在CMD中：

ruby -v # 查看Ruby版本
gem -v  # 查看gem是否正常安装
gem install jekyll #安装Jekyll
jekyll --version #检查版本
gem list #查看已安装的所有插件
jekyll new myblog #新建项目
cd myblog
jekyll serve #运行服务

访问测试：http://127.0.0.1:4000/

_config.yml

保存配置数据。很多配置选项都会直接从命令行中进行设置，但是如果你把那些配置写在这儿，你就不用非要去记住那些命令了。

_drafts

drafts 是未发布的文章。这些文件的格式中都没有 title.MARKUP 数据。学习如何使用 drafts.

_includes

你可以加载这些包含部分到你的布局或者文章中以方便重用。可以用这个标签 {% include file.ext %}来把文件 _includes/file.ext 包含进来。

_layouts

layouts 是包裹在文章外部的模板。布局可以在 YAML 头信息中根据不同文章进行选择。 这将在下一个部分进行介绍。标签 {``{ content }``} 可以将content插入页面中。

_posts

这里放的就是你的文章了。文件格式很重要，必须要符合: YEAR-MONTH-DAY-title.MARKUP。 The permalinks 可以在文章中自己定制，但是数据和标记语言都是根据文件名来确定的。

_data

放一些其他配置文件,必须是.yml或者.yaml格式的,比如有一个文件叫members.yml,如果想引用这个文件里的内容就通过site.data.membres来引用

_site

一旦 Jekyll 完成转换，就会将生成的页面放在这里（默认）。最好将这个目录放进你的 .gitignore 文件中。

• 第一步: 去JekyllThemes下载一个自己喜欢的模板

• 第二步: 按照之前的步骤把下载好的模板上传到自己的Github仓库中

• 第三步: 在_posts文件夹中放入自己写好的博客,文件名必须是日期-标题名,例如:2016-10-25-我的第一篇博客

• 第四步: 上传博客到Github中即可访问自己的博客

问题 1 Could not load Bundler. Bundle install skipped.

接着使用jekyll serve 的时候提示没有运行所需的buddle，
从stackoverflow上找到的答案：使用 “gem install jekyll bundle” 便可解决。

问题 2 Could not find public_suffix-3.0.0 in any of the sources (Bundler::GemNotFound)

如果将别人的项目直接clone下来，许多时候都会出现如上所示的错误。查阅资料发现，这是导致自身配置路径出现混乱而出现的问题。
因此可以通过命令’ bundle install –path vendor/cache ’ or ’ bundle install –no-deployment ’ 去重新修正。

问题 3 You have already activated public_suffix 3.0.2,but your Gemfile requires public_suffix 3.0.0.
Prepending bundle exec to your command may solve this. (Gem::LoadError)1

在解决问题 1 之后，这应该不算问题。此时只需执行"bundle exec jekyll serve"去启动服务器即可解决。(在这之前若一直使用 ‘jekyll serve’ 启动，之后稍加注意即可。）

问题 4 don't have pygments
安装一下即可：

gem install pygments.rb