Post

Github pages+jekyll 静态网站搭建(二)

本文介绍了Jekyll主题的下载与使用

Github pages+jekyll 静态网站搭建(二)

静态网站搭建(二)

内容简介

🚩 Tech Contents:本文介绍了Jekyll 主题的下载与使用

Github+Jekyll 已经过了黄金期(2015-2018 年),一开始找到的主题基本上都是 7~10 年前的项目,虽然设计非常美观,但由于这些主题依赖的 Ruby gem 版本早已不兼容现代环境,所以频频报错。
由于我又非常菜,一方面无法解决部分版本过时问题,另一方面又无力自己独立写出一个主题,所以只能不考虑设计偏好而选择最新的、且最好有人维护的主题。
直到我发现了jekyll-theme-chirpy,一个直到 2025 年仍被维护的宝藏主题,安装使用过程非常丝滑、顺畅!

搭建模板

  1. 创建自己的仓库
    作者给出了该项目的模板,直接进入仓库,点击Use this template创建自己的仓库,以<username>.github.io命名即可
  2. 克隆项目到本地
    使用bundle install安装Gemfile中的Ruby依赖
  3. 浏览个人网页
    使用bundle exec jekyll serve,获取到本地服务器 http://locoalhost:4000,即可在网页上浏览

模板链接:cotes2020/chirpy-starter: A website startup template using the Chirpy theme gem.

网站部署

  1. 配置_config.yml文件
    填写urlhttps://<username>.github.io的格式,注意结尾不要带 /
  2. 额外配置
    如果本地计算机未运行 Linux,还需要使用$ bundle lock --add-platform x86_64-linux更新锁定文件(Gemfile.locak)的平台列表
  3. 开启GitHub Actions
    进入GitHub中该项目的仓库,从上边栏打开setting页面,从侧边栏打开Pages页面,Build and deploymentsource处选择GitHub Action
  4. 运行网页
    在本地提交、推送一次,即可使用专属 URLhttps://<username>.github.io打开自己了的网页了!

操作文档:Chirpy-Getting Stared

使用GitHub Actions自动部署后,在本地的修改需要通过bundle exec jekyll serve --livereload才能启动实时预览

This post is licensed under CC BY 4.0 by the author.