GitHub Pages+Jekyll 靜態網站搭建(二)
- GitHub Pages+Jekyll 靜態網站搭建(二
- 內容簡介
- 搭建模板
- 網站部署
- 工作流程
GitHub Pages+Jekyll 靜態網站搭建(二
內容簡介
🚩 Tech Contents
- 該文主要涉及Jekyll主題的下載與使用。Github+Jekyll已經過了黃金期(2015-2018年,很難接受2015年已經是十年前了),一開始找到的主題基本上都是7~10年前的項目,雖然設計非常美觀,但由于這些主題依賴的Ruby gem版本早已不兼容現代環境,所以頻頻報錯。由于我又非常菜,一方面無法解決部分版本過時問題,另一方面又無力自己獨立寫出一個主題,所以只能不考慮設計而選擇最新的、且最好有人維護的主題。
🐜 jekyll-theme-chirpy
- 一個直到2025年仍被維護的Jekyll寶藏主題,安裝與使用過程也非常方便、順暢!
搭建模板
📌 創建步驟
- 創建自己的倉庫。作者給出了該項目的模板,直接使用該模板
use this template
創建自己的倉庫<username>.github.io
即可- 克隆項目到本地。使用
bundle install
安裝Gemfile
中的Ruby
依賴- 瀏覽個人網頁。使用
bundle exec jekyll serve
,獲取到本地服務器http://locoalhost:4000,即可在網頁上瀏覽
🔗 模板鏈接
cotes2020/chirpy-starter: A website startup template using the Chirpy theme gem.
網站部署
📌 部署步驟
- 配置
_config.yml
文件,填寫url
為https://<username>.github.io
的格式,注意結尾不要帶 /- 如果本地計算機未運行Linux,還需要使用
$ bundle lock --add-platform x86_64-linux
更新鎖定文件(Gemfile.locak)的平臺列表- 開啟
GitHub Action
。進入GitHub
中該項目的倉庫,從上邊欄打開setting
頁面,從側邊欄打開Pages
頁面,Build and deployment
的source
處選擇GitHub Action
- 運行網頁。在本地提交、推送一次,即可使用xx打開自己了的網頁了!
📕 更多說明
Chirpy 非常詳細的模板教程文檔
工作流程
🎢 本地修改——本地測試——推送發布
? 問題提出
- 使用
GitHub Actions
自動部署后,如果在本地修改文件并沒有提交到GitHub
,會導致本地運行bundle exec jekyll serve
時看不到網頁更新,不便調試網站
🔨 問題解決
本地開發使用
bundle exec jekyll serve --livereload
啟動本地實時預覽訪問
http://localhost:4000
查看結果,修改內容后瀏覽器會自動刷新之后再使用add/commit/push等流程即可