新建repo

我先是follow這個教程：
keysaim教程

它提供了如何從git repo建立自己的github.io，跟隨這個教程知道新建了輸出hello world的頁面。

https://tungsten106.github.io/ 這個頁面有了內(nèi)容

但是我卡在了選擇主題的部分，原博主選擇了Huxpro 作為主題，但我決定參考另外一個。

選擇并clone jekyll主題

這個主題叫jekyll-theme-chirpy：GitHub鏈接

這個主題的教程：https://chirpy.cotes.page/posts/getting-started/

在使用Jekyll主題之前先需要跟隨 Jekyll官網(wǎng)指導(dǎo) 進(jìn)行環(huán)境安裝。

這里主要需要通過homebrew安裝一些東西。brew install 通常會安裝軟件到 macOS 系統(tǒng)上的全局位置，而不是綁定到特定的 Python 環(huán)境或 Conda 環(huán)境。因此，不同 Anaconda 環(huán)境通常不會直接影響 brew install 安裝的軟件。

安裝ruby報錯

!!! Failed to download ruby versions!

• 查了錯誤發(fā)現(xiàn)有可能是沒有安裝wget

在搜索后發(fā)現(xiàn)需要輸入 brew install ruby 來進(jìn)行安裝

安裝后出現(xiàn)：

ruby is keg-only, which means it was not symlinked into /opt/homebrew, because macOS already provides this software and installing another version in parallel can cause all kinds of trouble.

If you need to have ruby first in your PATH, run:

echo 'export PATH="/opt/homebrew/opt/ruby/bin: $PATH' >> ~/.shrc

For compilers to find ruby you may need to set: export LDFLAGS="-L/opt/homebrew/opt/ruby/lib" export CPPFLAGS="-I/opt/homebrew/opt/ruby/include"

是說要設(shè)置一些環(huán)境變量。

參考 Mac升級ruby到最新版本 和 macOS Monterey安裝Jekyll 這兩篇博文。

輸入 echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc 后更新了zsh的配置文件

這樣還不夠，我們需要更新配置文件。

source .zshrc

• 這里如果終端是bash則輸入：echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.bash_profile，并用 source .bash_profile 來更新配置文件。

更新完再輸入 ruby -v 后得到的是最新版本

ruby 3.2.2 (2023-03-30 revision e51014f9c0) [arm64-darwin22]

然后輸入gem install jekyll

• 安裝卡頓，可能是源的問題
• 參考 github使用Jekyll，在Rails bundle install卡住問題 進(jìn)行刪除/新增源

安裝主題

教程中我選擇option1，更佳jekyll新手友好。

但是在之前的教程中我已經(jīng)完成過repo的建立，沒辦法按照教程的通過use the template來建立repo。參考教程1我打算嘗試用git clone，嘗試失敗，還是老老實實重新安裝了hh

參考chirpy主題官方教程 進(jìn)行安裝，或者可以根隨以下內(nèi)容。

在 Github 頁面點擊綠色Use this Template再選擇Create a new repository，在新彈出的建立repository頁面建立一個名稱為USERNAME.github.io的repo。注意這里USERNAME必須和自己的用戶名一樣。

將這個新的repo clone到本地；然后在終端中輸入：

bundle

本地運行報錯

在本地輸入 bundle exec jekyll s 指令在http://localhost:4000/上可以查看網(wǎng)頁部署。

有可能會報錯：

Could not find gem 'jekyll-theme-chirpy (~> 6.3, >= 6.3.1)' in locally installed gems.

Run `bundle install` to install missing gems.

或者

Could not find gem 'jekyll-theme-chirpy (~> 6.3, >= 6.3.1)' in locally installed gems.

The source contains the following gems matching 'jekyll-theme-chirpy':

\* jekyll-theme-chirpy-6.2.3

第一個報錯是因為gem沒有安裝主題，第二個是因為安裝的版本不對（應(yīng)該安裝6.3.1，實際安裝了6.2.3）運行gem install jekyll-theme-chirpy -v 6.3.1 安裝合適的版本就好了，如果再不行的話運行bundle install 。（參考 https://rubygems.org/gems/jekyll-theme-chirpy/versions/6.3.1 和 https://stackoverflow.com/questions/46380722/jekyll-theme-could-not-be-found ）

• 這里6.3.1也可以是其他版本，以報錯版本為主

網(wǎng)頁部署

到這一步網(wǎng)頁其實沒有部署好。需要在建立了Github Page的repo中選擇Settings，然后選擇左側(cè)菜單欄的Pages頁面，在Source中從 Deploy from brance 更改為 Github Actions .

請保證 Gemfile.lock 文件已commit到repo。如果操作系統(tǒng)不是Linux還需要在根目錄下輸入：

bundle lock --add-platform x86_64-linux

• 這一步有可能遇到報錯：

Retrying fetcher due to error (2/4): Bundler::HTTPError Could not fetch specs from https://rubygems.org/ due to underlying error <Net::OpenTimeout: Failed to open TCP connection to rubygems.org:443 (execution expired) (https://rubygems.org/specs.4.8.gz)>

這里可以參考stackoverflow 上的一個回答，將 Gemfile （我這里修改成了 Gemfile.lock 也成功了）中的source https://rubygems.org/ 改成 source http://rubygems.org/。這里我猜測可能是網(wǎng)絡(luò)原因。

然后隨便git commit一些內(nèi)容進(jìn)行激活，就可以在repo的Action頁面中查看進(jìn)程了。第一次加載網(wǎng)頁可能會比較久，即使Action頁面顯示Deployed也有可能加載不出，耐心等待幾分鐘就好。

Reference

一位同樣適用Chirpy主題的教程: 鏈接文章來源地址http://www.zghlxwxcb.cn/news/detail-747611.html

到了這里，關(guān)于通過Jekyll Chirpy主題搭建Github Page記錄的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！