博客主题选取的主题是clean-blog-jekyll。
选取的原因:
简洁,没有什么花里胡哨的地方,方便阅读
字体字号设置的比较规整
在blog页面,每篇blog下面可以写些简介之类的,方便阅读
在jekyll theme网站这个模板是Free
本站主要使用Jekyll框架+Github Pages部署。Jekyll 是一个简单的静态网页框架,它有一个模版目录,其中包含原始文本格式的文档,通过 Markdown 或者 Textile 转化成一个完整的可发布的静态网站,可以发布在任何服务器上。
使用 Jekyll 搭建博客之前要确认下本机软件安装,Git(用于从本地部署到远端)、Ruby(Jekyll 是基于 Ruby 开发的)、包管理器 RubyGems
在做之前纠结了一下是否要直接在Windows上下载jekyll、ruby等环境,网上似乎都表示不太推荐,所以最终选择了在docker中进行。
在GitHub里选个喜欢的样式的repo,fork到自己的账号下,同时将repo的名字改为`your-username.github.io
注册docker账号,下载docker desktop
docker desktop需要WSL2环境,你可以wsl --update
来更新本机的WSL环境
在docker中可以把镜像换成国内的镜像 Settings -> Docker Engine
xxxxxxxxxx
51{
2 "experimental": true,
3 "debug": true,
4 "registry-mirrors": ["http://hub-mirror.c.163.com"]
5}
将GitHub上的repo clone到docker镜像上,这里用的是Ruby的Docker仓库
xxxxxxxxxx
11docker run --rm -it -v "$(pwd)":/app -w /app ruby:latest git clone https://github.com/<username>/<repository>.git
更新博客repo中的_config.yml
文件(你可能要先下个vim)
_config.yml
是整个博客的基础信息配置文件,修改这个文件可以直接把别人的博客变成自己的。
xxxxxxxxxx
11docker run --rm -it -v "$(pwd)":/app -w /app ruby:latest vim _config.yml
重要字段说明
如果需要在导航显示新增的页面,直接在_config.yml
文件的nav字段中添加新页面配置。
ps.这里如果$(pwd)
中包含了Docker无法识别的特殊字符,可以直接改成博客文件夹的绝对路径
在存储库目录中使用以下命令构建站点并启动本地服务器
进入容器,在容器中运行以下命令安装 Jekyll 和其他必要的依赖项
xxxxxxxxxx
21gem install jekyll bundler
2bundle install
然后启动jekyll服务器
xxxxxxxxxx
11bundle exec jekyll serve --host 0.0.0.0
这个命令将在 Docker 容器中启动 Jekyll 服务器,并将本地 4000 端口映射到 Docker 容器中的 4000 端口。此时,在浏览器中输入 http://localhost:4000
就可以直接访问博客。
生成 Jekyll 网站,并将生成的文件推送到 GitHub 仓库中。
xxxxxxxxxx
41bundle exec jekyll build
2git add .
3git commit -m 'update my blog'
4git push
此时,即可在浏览器中访问your-username.github.io
啦
每次运行一次镜像都会生成新的初始环境的容器
其实很早就想搞个自己的博客了,只是一直拖拖拖。。。很开心借这个作业逼着自己把这件事干了 :-D