本文目录:
类型GitHub Pages 站点的类型有三种:
为站点创建仓库必须先在 GitHub 上有站点的仓库,然后才可创建站点。
1:使用+下拉菜单选择 New repository(新建仓库)。
2: 输入仓库的名称和说明(可选),仓库名称必须为 <user>.github.io ,因为我们创建的是用户站点。
创建后我们的仓库就生成了:
image-20210205184256975.pnghttps://github.com/virhuiai/virhuiai.github.io.githttps://github.com/virhuiai/virhuiai.github.io.git初始化仓库本地创建virhuiai.github.io.git,并提交一个文件到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再看仓库上就有我们的提交的内容了:
创建 Jekyll 站点在仓库目录下,运行容器
cd /Users/virhuiaivirhuiai/Documents/virhuiai-github/virhuiai.github.io.git# 运行容器docker run --name virhuiai-jekyll \ -p 4000:4000 \ --volume="$PWD:/srv/jekyll" \ -it jekyll/jekyll:4.0 \ /bin/sh-p命令是为了方便后面直接在容器中运行,指定了端口。
生成:
jekyll new .强制生成:
jekyll new . --force因为没装tree,切到宿主机到相应的目录下查看下结构:
tree -C其中.gitignore还自动添加了一些内容:
修改Gemfile打开Gemfile,会发现这样的提示:
# 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按提示修改,其中版本号参见:
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国内源# 改用Ruby国内源# 移除官方镜像源.gem sources --remove https://rubygems.org/# 添加国内源ruby-china。gem sources -a https://gems.ruby-china.com/# 确保只有一个镜像源。gem sources -lGemfile中也修改:
更新bundle install下载一堆….
bundle update github-pages嗯,已经是最新的,刚刚没注意看说明有字眼:update and install。
推送git push -u origin BRANCH已经到上面了,现在点右下角的github-pages:
查看GitHubPages效果再点View deployment:
就可以看到:
我们的GitHub Page就配置好了。下回看的时候直接输入地址过来就可以:
https://virhuiai.github.io/本地效果查看jekyll serve打开http://127.0.0.1:4000/,就和GitHub Pages上一样了。
后面就用这个方式建出来的站点吧,GitHub上,GitHub Page,本地Jeklly,本地Markdown都正常使用。