本文目錄：

類型

GitHub Pages 站點(diǎn)的類型有三種：

為站點(diǎn)創(chuàng)建倉(cāng)庫(kù)

必須先在 GitHub 上有站點(diǎn)的倉(cāng)庫(kù)，然后才可創(chuàng)建站點(diǎn)。

1：使用+下拉菜單選擇 New repository（新建倉(cāng)庫(kù)）。

2: 輸入倉(cāng)庫(kù)的名稱和說(shuō)明（可選），倉(cāng)庫(kù)名稱必須為 <user>.github.io ，因?yàn)槲覀儎?chuàng)建的是用戶站點(diǎn)。

創(chuàng)建后我們的倉(cāng)庫(kù)就生成了：

image-20210205184256975.pnghttps://github.com/virhuiai/virhuiai.github.io.git

https://github.com/virhuiai/virhuiai.github.io.git初始化倉(cāng)庫(kù)

本地創(chuàng)建virhuiai.github.io.git,并提交一個(gè)文件到Github：

cd /Users/virhuiaivirhuiai/Documents/virhuiai-githubmkdir virhuiai.github.io.gitcd virhuiai.github.io.gitgit initecho "# virhuiai.github.io" >> README.mdgit add README.mdgit commit -m "first commit"git branch -M maingit remote add origin https://github.com/virhuiai/virhuiai.github.io.git

再看倉(cāng)庫(kù)上就有我們的提交的內(nèi)容了：

創(chuàng)建 Jekyll 站點(diǎn)

在倉(cāng)庫(kù)目錄下，運(yùn)行容器

cd /Users/virhuiaivirhuiai/Documents/virhuiai-github/virhuiai.github.io.git# 運(yùn)行容器docker run --name virhuiai-jekyll \ -p 4000:4000 \ --volume="$PWD:/srv/jekyll" \ -it jekyll/jekyll:4.0 \ /bin/sh

-p命令是為了方便后面直接在容器中運(yùn)行，指定了端口。

生成：

jekyll new .

強(qiáng)制生成：

jekyll new . --force

因?yàn)闆](méi)裝tree,切到宿主機(jī)到相應(yīng)的目錄下查看下結(jié)構(gòu)：

tree -C

其中.gitignore還自動(dòng)添加了一些內(nèi)容：

修改Gemfile

打開Gemfile，會(huì)發(fā)現(xiàn)這樣的提示：

# Happy Jekylling!gem "jekyll", "~> 4.1.0"# This is the default theme for new Jekyll sites. You may change this to anything you like.gem "minima", "~> 2.5"# If you want to use GitHub Pages, remove the "gem "jekyll"" above and# uncomment the line below. To upgrade, run `bundle update github-pages`.# gem "github-pages", group: :jekyll_plugins

按提示修改，其中版本號(hào)參見：

https://pages.github.com/versions/

#gem "jekyll", "~> 4.1.0"# This is the default theme for new Jekyll sites. You may change this to anything you like.gem "minima", "~> 2.5"# If you want to use GitHub Pages, remove the "gem "jekyll"" above and# uncomment the line below. To upgrade, run `bundle update github-pages`.gem "github-pages", "~> 211", group: :jekyll_plugins

更新Ruby國(guó)內(nèi)源# 改用Ruby國(guó)內(nèi)源# 移除官方鏡像源.gem sources --remove https://rubygems.org/# 添加國(guó)內(nèi)源ruby-china。gem sources -a https://gems.ruby-china.com/# 確保只有一個(gè)鏡像源。gem sources -l

Gemfile中也修改：

更新bundle install

下載一堆….

bundle update github-pages

嗯，已經(jīng)是最新的，剛剛沒(méi)注意看說(shuō)明有字眼：update and install。

推送git push -u origin BRANCH

已經(jīng)到上面了，現(xiàn)在點(diǎn)右下角的github-pages:

查看GitHubPages效果

再點(diǎn)View deployment:

就可以看到：

我們的GitHub Page就配置好了。下回看的時(shí)候直接輸入地址過(guò)來(lái)就可以：

https://virhuiai.github.io/

本地效果查看jekyll serve

打開http://127.0.0.1:4000/，就和GitHub Pages上一樣了。

后面就用這個(gè)方式建出來(lái)的站點(diǎn)吧，GitHub上，GitHub Page,本地Jeklly,本地Markdown都正常使用。